skill-curator

skill-curator

工作流

1. 盘点 — for d in <root>/*/*/; do grep -E '^(name|description):' "$d/SKILL.md"; done
2. 聚类 — 按主题分组；标记描述重叠或触发条件可能同时满足的技能对。
3. 阅读可疑项 — 不能仅凭描述或正则表达式进行分类。
4. 根据以下分类体系进行分类。
5. 呈现发现 + 建议的修复方案 — 多文件重构前先征求意见；小型独立修复可以直接进行。
6. 修复并验证。除非有人要求，否则不要提交。

分类体系

• 分叉脚本 — 同一脚本被复制到多个技能中。比较差异以检查是否有偏移。指定一个所有者；另一个指向它。
• 矛盾 — 对同一产物的指令彼此冲突。指定所有者；其他技能应遵从它。
• 复述 — 一个技能重新推导另一个技能的内容。替换为一行指向说明。
• 臃肿 — 经常加载的文件中包含很少用到的细节。将其移至 references/；快速修复内容保留在行内。
• 未使用或超出预算 — 没有会话日志读取过的技能，或描述合计超过 harness 的列表预算（Codex：占上下文的 2%，之后平均截断）。steipete/agent-scripts skill-cleaner 可测量 Codex 的这两项指标；其他情况下，手动汇总描述字节数。
• 内部缺陷 — 重复的标题或编号、失效的路径引用、死代码。
• 异味 — 单个技能本身就有问题。根据一项涵盖 238 个技能的调查（arXiv 2607.01456），值得标记的问题包括：工作流缺少步骤；选项自助餐（提供选项却没有决策规则）；合理化漏洞（“通常”、“如有需要”）；隐藏的陷阱（将注意事项埋在段落中，而不是放进 Notes）；描述含糊（将内容、适用时机和关键词混杂在一句话中）；时效性声明；非第三人称描述；frontmatter 中使用 XML 或反斜杠路径。

规则

• 断言缺陷前，先阅读所有声称存在缺陷的内容——启发式方法可能会误判代码块和有意设置的平行结构。
• 每项能力只指定一个所有者；其他技能通过明确路径引用它。
• 渐进式披露：描述 → SKILL.md（简洁）→ references/REFERENCE.md（详细）。内容简洁程度应与加载频率相匹配。
• 只修复缺陷本身——不做相邻重构，也不添加额外的交叉链接。

另请参阅

• write-skill — 编写一个新技能。