技能优化器

它解决什么问题

Agent 技能的实际表现，很大程度上取决于 SKILL.md 写得怎么样。但手写或多人维护的技能文件，往往会遇到这类情况：

• 角色定位模糊：开头没有说明 Agent 扮演什么角色、处理什么任务，模型在运行时容易跑偏。
• 结构松散：说明、约束、示例混在一起，没有按任务流程组织，关键信息不突出。
• 参数约定缺失：该写清楚的工具参数、边界条件一笔带过，执行时只能靠猜。
• 内容冗余：多次修改后留下重复段落，甚至出现互相矛盾的表述。

技能优化器针对的就是这一类「定义层」问题：不改变技能的用途，只把技能文件本身整理清楚。

它如何工作

核心思路是把一次技能优化拆成几个可检查的步骤：

1. 解析现状：读取 SKILL.md 全文，按段落识别角色定义、任务说明、约束条件、示例等组成部分。
2. 对照检查：逐项排查常见短板——指令是否明确、参数是否完整、约束是否可执行、示例是否覆盖边界情况。
3. 整理重写：统一术语和措辞，合并重复内容，调整段落顺序，让技能定义读起来像一份结构清晰的技术文档。
4. 保留意图：优化只针对表达方式，不擅自增加或删减技能声明的功能范围。

适用边界

• 它处理的是技能定义，不会替你运行 Agent、调用工具或验证实际执行效果；行为层面的验证仍需自行设计测试。
• 优化建议偏通用规范，具体业务语境（例如某个接口的真实参数）需要作者自己确认，不能凭空生成。
• 建议把优化前后的版本纳入版本管理，方便回溯每一次改动。