Skip to content

refactor: 拆分 SKILL.md 为入口 + references/,新增 install.sh#6

Open
anChaOs wants to merge 1 commit into
simonlin1212:mainfrom
anChaOs:refactor/split-skill-into-references
Open

refactor: 拆分 SKILL.md 为入口 + references/,新增 install.sh#6
anChaOs wants to merge 1 commit into
simonlin1212:mainfrom
anChaOs:refactor/split-skill-into-references

Conversation

@anChaOs
Copy link
Copy Markdown

@anChaOs anChaOs commented May 19, 2026

背景

V3.0 SKILL.md 单文件 1996 行 / 70KB,作为 Claude Skill 时存在两个问题:

  1. 激活成本:Skill 一旦命中关键词,整个 SKILL.md 会被加载进对话上下文。即使用户只问"查 688017 估值"(只用 Layer 1 + Layer 2),也要把信号层/资金面/筹码层等 7 层全部代码塞进上下文,单次激活 ~18K tokens。
  2. 安装方式:原 curl -o ... SKILL.md 单文件 install 在拆分后失效,需要重新设计。

改动

纯结构重构 + 安装脚本,零代码行为变更。

1. SKILL.md 精简为入口(1996 → 159 行)

保留:

  • frontmatter(保持 origin: custom / version: 3.0 不变;description 改为以"何时使用"开头 + 触发关键词 + 禁用场景的标准格式,更利于 LLM 路由判断)
  • When to Activate(精简清单 + 关键词)
  • Prerequisites(pip install 不变)
  • Common Utilities(get_prefix + eastmoney_datacenter 这两个跨层 helper)
  • 估值公式 + 投资框架(PE 消化 / PEG)
  • 七层索引表(指向 references/0X-*.md

2. 七层代码下沉到 references/

文件 内容
references/01-quotes.md mootdx + 腾讯 + 百度K线
references/02-research.md 东财 reportapi + 同花顺一致预期 + iwencai
references/03-signals.md 同花顺热点 + 北向 + 百度PAE + 龙虎榜 + 解禁 + 行业
references/04-capital.md 融资融券 + 大宗 + 股东户数 + 分红 + 120日资金流
references/05-news.md 东财个股 + 财联社 + 东财全球
references/06-fundamentals.md mootdx 财务/F10 + 东财 + 新浪三表
references/07-filings.md 巨潮 cninfo + mootdx F10
references/workflows.md 流程 A/B/C/D(单票估值 / 批量对比 / 主题研报 / 新标的速览)
references/faq.md 数据源优先级 + 13 条常见踩坑

所有 28 个端点的实现代码原样保留(包括 _northbound_cache_path() 仍指向 ~/.tradingagents/cache/),只是分文件存放。

3. 新增 install.sh + README 快速开始

老 curl 单文件方式:
```bash
curl -o ~/.claude/skills/a-stock-data/SKILL.md \
https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/SKILL.md
```

新一键安装:
```bash
curl -fsSL https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/install.sh | bash
```

install.sh 用纯 curl(不依赖 git)拉取 SKILL.md + 9 个 reference 到 ~/.claude/skills/a-stock-data/。文件清单硬编码在脚本内,未来增删 reference 改脚本即可,README 不用改。

支持环境变量自定义:

  • INSTALL_DIR=/custom/path 改安装目录
  • BRANCH=dev 切分支测试

收益

  • 激活成本下降:Skill 命中后只加载 159 行入口,节省 ~17K tokens / 次。Claude 需要某层代码时再 Read references/0X-*.md,按需加载。
  • 维护更友好:改某一层(比如东财加反爬)只需改对应 reference,不再影响整个 70KB 文件的 diff 体积。
  • 安装更简洁:从"3 步 mkdir + curl + pip"变成"2 步 curl install.sh + pip"。

兼容性

  • frontmatter 保持 origin: custom / version: 3.0 不变
  • 所有函数签名 / API 调用 / 缓存路径完全无改动
  • Codex / OpenClaw 等非 Claude Code 用户:仍可把 SKILL.md 贴入系统 prompt,需要某层代码时贴对应 reference
  • ⚠️ 老的 curl -o .../SKILL.md 单文件安装方式不再适用,已替换为 install.sh

自测

  • bash -n install.sh 语法检查通过
  • 全文 grep 确认 28 个端点函数签名 vs 上游一致
  • frontmatter / Prerequisites / eastmoney_datacenter helper / 估值公式 与上游一致
  • install.sh 实跑:raw URL 在合并前还无法解析,建议合并前在 staging 分支测试,或 cherry-pick 到本地手动 bash install.sh 验证

Diff 体量

```
README.md | +12 / -10
SKILL.md | +159 / -1996 (内容下沉到 references/)
install.sh | 新增 47 行
references/ | 新增 9 个文件 / 共 1594 行(从 SKILL.md 搬运)
```

净增加 ~150 行(install.sh + 索引导航),其余完全是搬迁。

- SKILL.md 精简为 159 行入口:When to Activate / Prerequisites / 公共 helper / 估值框架 + 七层索引
- 各层代码下沉到 references/01-quotes.md ... 07-filings.md + workflows.md + faq.md
- 所有 28 个端点的实现代码原样保留,零行为变更
- 新增 install.sh:一键拉取 SKILL.md + 9 个 reference 到 ~/.claude/skills/a-stock-data/
- README 快速开始改为 install.sh,原 curl 单文件方式不再适用
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant