agent 的 skill 越来越多后，每次对话不可能把所有 skill 说明都塞进上下文。这个工具把 skill 整理成一棵树，agent 收到任务时先查树、再按需加载对应的 skill。

https://github.com/maipianworni/SkillTree…

生成一个分层路由树（根节点 → 路由器节点 → 叶子 skill），写回 agent 的 skill 目录，同时在项目根目录的 AGENTS.md 或 CLAUDE.md 里注入路由协议。

maipianworni/SkillTree

Source: https://github.com/maipianworni/SkillTree

Skill Tree Generator

⚠️ Research Preview

一个把庞杂 skill 聚合为分层路由树的工具，让 AI agent 按需加载子能力，避免一次性把所有指令塞进上下文。

支持的 Agent

• Bitfun（skill 目录 .bitfun/skills/，记忆文件 AGENTS.md）
• Claude Code（原生支持，skill 目录 .claude/skills/，记忆文件 CLAUDE.md）
• Codex CLI（通过 AGENTS.md 注入路由协议，skill 目录可自定义，推荐 .agent/skills/）
• 其他读取 AGENTS.md 的 agent（Cursor、Aider、Jules 等）同理

脚本用法

用法 A：Bitfun

1. 将 skill-tree-generator/ 放到工程 .bitfun/skills/ 下

2. 打开 Bitfun

3. 运行：

   ./scripts/aggregate-skills.sh .bitfun/skills --agent bitfun
   

4. 把输出的命令贴回 Claude Code（形如 /skill-tree-generator --aggregate ...）

5. 生成结果：

   • skill-tree 写入 .bitfun/skills/{name}-tree/
   • 项目根 AGENTS.md 追加路由协议（若不存在则创建）

用法 B：Claude Code

1. 将 skill-tree-generator/ 放到工程 .claude/skills/ 下

2. 打开 Claude Code

3. 运行：

   ./scripts/aggregate-skills.sh .claude/skills
   

4. 把输出的命令贴回 Claude Code（形如 /skill-tree-generator --aggregate ...）

5. 生成结果：

   • skill-tree 写入 .claude/skills/{name}-tree/
   • 项目根 CLAUDE.md 追加路由协议（若不存在则创建）

用法 C：Codex CLI

1. 将 skill-tree-generator/ 放到工程 .agent/skills/ 下（或自定义目录）

2. 一次性 安装 custom prompt，让 Codex CLI 认识 /skill-tree-generator：

   ./scripts/install-codex-prompt.sh
   

   该脚本会把 SKILL.md 拷到 ~/.codex/prompts/skill-tree-generator.md

3. 运行：

   ./scripts/aggregate-skills.sh .agent/skills --agent codex
   

4. 把输出的命令贴回 Codex CLI

5. 生成结果：

   • skill-tree 写入 .agent/skills/{name}-tree/
   • 项目根 AGENTS.md 追加路由协议（若不存在则创建）

如果你不想安装 custom prompt，也可以直接在 Codex 里让它读 SKILL.md 并执行聚合命令，脚本输出里会提示具体写法。

用法 D：OpenCode

1. 将 skill-tree-generator/ 放到工程 .opencode/skills/ 下（或自定义目录）

2. 运行：

   ./scripts/aggregate-skills.sh .opencode/skills --agent opencode
   

3. 按提示将输出的指令贴回 OpenCode（形如 Read .../SKILL.md and execute: /skill-tree-generator --aggregate ...）

4. 生成结果：

   • skill-tree 写入 .opencode/skills/{name}-tree/
   • 项目根 AGENTS.md 追加路由协议（若不存在则创建）

直接使用Skill

1. Single Skill to Skill Tree

/skill-tree-generator skill

2. Multiple Skill to Skill Tree

/skill-tree-generator –aggregate skill1,skill2,… [–domain domain-name]

3. Update Skill Tree

/skill-tree-generator –update tree-path –add skill

路径约定

同一仓库想让两种 Agent 都用？

推荐做法（只维护一份）：

# skill 目录用 Codex 风格，软链让 Claude Code 也能发现
ln -s .agent/skills .claude/skills

# 记忆文件共用一份
ln -s AGENTS.md CLAUDE.md

引用

路由协议模板见 skill-tree-generator/references/validation_template.md 的 Check 1。

Skill Tree推荐用法

1. 记忆文件（例如CLAUDE.md）放在根目录，查看是否包含上述“引用”中路由协议模版的内容。
2. skills目录（例如.claude/skills）下生成Skill Tree以后，将其他skill清空，可以更好的测试Skill Tree的效果。
3. 运行任务或者输入prompt，测试能否通过Skill Tree的路由功能“触发”相关的Skill。

路由追踪 [可选]

• 当用户 prompt 包含 “路由调试” / “debug routing” / “路由追踪” 时，激活路由追踪模式，该模式可输出路由追踪日志，可查看skill-tree是否实际触发到了用户需要的skill节点。
• 正常模式（默认）：不输出任何路由信息，直接执行。