skill-organizer

技能整理器

读取所有已安装的技能，识别重叠和容易混淆之处，在适当时进行合并，并生成简洁的 SKILL_REGISTRY.md，作为 Agent 系统提示词中的路由指南。

为何需要此工具

模型选择技能的容量（kappa）约为 50–100 项。超过这一数量后，选择准确率会下降。随着通过日志分析和手动创建不断积累技能，技能库可能会超出此阈值。此技能可帮助整理技能库，并保持路由指南简洁。

参考：使用技能库扩展 LLM Agent

工作流

第 1 步：盘点

列出 .agent/skills/ 文件夹中的所有技能目录。

然后阅读每个技能的 SKILL.md，了解其范围、质量和重叠情况。每个技能都位于 .agent/skills/ 的一个子目录中，并包含一个 SKILL.md 文件。

第 2 步：识别重叠或容易混淆的技能

查找：

• 功能相同但名称略有不同的技能
• 范围大幅重叠的技能（其中一个是另一个的子集）
• 可以合并成一个包含多个章节的更广泛技能的技能
• 在不同日志分析过程中创建的近似重复技能

第 3 步：合并为分层的父技能

对于每组重叠或相关技能，创建一个包含多个章节的父技能，每个章节介绍一项子能力：

1. 选择一个范围更广的父技能名称和目录（例如，使用 web-app-dev，而不是分别创建 react-frontend、nodejs-backend 和 web-testing）
2. 编写一份完整的 SKILL.md，并为每项子能力设置清晰标注的章节。每个章节都应独立完整，让 Agent 能够只阅读相关章节来完成特定任务。
3. 将合并技能附带的资源（模板、示例、配置）移至父技能目录的子目录中。
4. 删除冗余的技能目录。

合并时，优先选择具备以下条件的技能：

• 质量更高的说明和示例
• 更完整的附带资源
• 描述更清晰、通用性更强的名称

目标是减少技能数量、提升技能质量——一个包含 4 个优质章节的父技能，胜过 4 个内容单薄的独立技能。

第 4 步：生成 SKILL_REGISTRY.md

将 .agent/skills/SKILL_REGISTRY.md 编写为简洁的路由指南：

# Skill Registry

## <Category> (<count>)

- **skill-name**: What it does in one sentence.
  Use when: <trigger condition — when should the agent read this skill?>
  Sections: <comma-separated list of sections/sub-capabilities within the skill>

- **skill-name**: What it does in one sentence.
  Use when: <trigger condition>

## Recently Added
- **new-skill** (project): Frontmatter description — not yet categorized

注册表应当：

• 按用途或领域分组技能（而不是按字母顺序排列）
• 对每项技能说明其功能、何时阅读，以及包含哪些章节
• “使用场景”这一行至关重要——它会告诉 Agent 何时加载完整的 SKILL.md
• “章节”这一行（如适用）列出该技能包含的子能力
• 总条目数控制在 50 项以内（如有需要，应积极合并）
• 包含一个“最近添加”章节，列出自上次整理以来创建的技能
• 不要重复完整的技能内容，只需提供足以支持选择路由的信息

第 5 步：报告

总结所做的工作：

• 找到多少项技能
• 合并了哪些技能（旧名称 -> 新名称）
• 哪些技能保持原样
• 最终注册表的结构

约束

• 不要使用关键词匹配、Jaccard 相似度或启发式分类。请根据对每项技能功能的理解进行判断。
• 积极合并：少而优质的技能胜过大量相互重叠的技能。
• 合并时保留所有附带资源（模板、示例、配置）。
• SKILL_REGISTRY.md 是路由指南，不是文档。请保持简洁。
• massgen/skills/ 中的技能（内置技能）不得合并或删除，只能列入注册表。