Skill Optimizer
用尽量少、确实有效的指令,让 Skill 稳定完成任务。既检查缺失的保障,也检查多余的约束;保留原样可以是合理结论。
授权与边界
根据完整对话和适用的仓库规则判断授权,不依赖固定确认词:
- 只问“怎么优化”“先看看”,或尚未授权实施:审查并给出方案,停在建议阶段。
- 已明确授权修改或执行方案:先审查、说明改动范围,再连续完成范围内修改和必要验证,不重复请求同一授权。
- “有道理”“我看看”等评价本身不代表授权。只有授权确实影响下一步且无法从上下文判断时,才问一个简短问题。
- 删除、覆盖、重启、部署、外部写入、付费调用、凭据变更等操作,执行前核实对具体对象和影响的授权;缺少授权时说明影响并确认。优化技能的授权不等于执行目标技能中的业务操作。
- 超出已授权范围的改动另列建议。遵守适用的上层安全规则,不因模型能力提升而取消必要边界。
工作流
1. 确定范围
定位目标 Skill 的来源与适用仓库规则;有源码仓库时优先修改源文件,再按约定安装。只围绕用户指定方向审查;没有指定方向时,先找最影响使用的几个问题。
明确本轮应交付建议还是修改结果。目标缺失且无法定位时,询问目标;缺少可选信息时采用合理假设并说明。复杂任务按需跟踪进度,不强制复制固定清单。
2. 审查并选择资料
先读目标 SKILL.md,再读取与本轮问题有关的资源。以下资料按条件选择,不要求每次全部加载:
| 当前问题 | 读取资料 |
|---|---|
| 需要逐项检查触发、授权、依赖或验证行为 | 审查清单 的相关部分 |
| 需要决定删减哪些指令、调整流程自由度或拆分结构 | 设计评审框架 |
| 需要 Claude 平台的技能编写细节 | Claude 编写参考 的相关部分;平台限制和旧版本建议需按当前环境核实,不直接套为通用硬规则 |
审查围绕三个问题:目标行为是什么、现有指令哪里妨碍或缺少保障、改变后怎样验证。对于重复规则、通用常识、无条件加载和机械步骤,判断其增量价值;对于领域约束、真实故障经验和必要操作顺序,保留保障。
怀疑触发重叠时才看相关相邻技能的名称与描述,兼容分类目录,不全量读取技能库。发现疑似敏感信息时只报告类型和位置,不回显具体值。
3. 给出诊断与方案
简单调整用短段落或列表说明:目标与范围、问题及依据、拟改文件与预期行为、验证方式。没有问题就说明保留理由。
复杂重构再按优先级展开,并在有帮助时说明模式、依赖、风险及范围外建议。每项修改都应能解释收益;不为凑齐模板增加问题、文件或操作。依照上面的授权边界决定实施或结束本轮建议。
4. 实施
只修改已授权范围。删除或合并重复、失效、无增量价值的说明,保留有效的领域知识和安全边界。将必须遵守的约束、可靠的默认做法与可自主选择的方法区分清楚。
- 根文档保留必要流程、边界、完成条件和资源路由;细节确实能按需加载时才拆分,并从根文档直接链接。
- README、索引、模板、脚本按实际读者需求和仓库要求添加,不作为每个 Skill 的必备附件。
- 需要稳定重复执行的确定性操作可脚本化;依赖应说明安装、校验和缺失时的处理方式。提供安装命令不代表获得安装或付费授权。
- 未知模型保持通用说明;已知多模型使用时按风险选择代表场景,不以某个模型能力作为删除保障的依据。
5. 验证与收尾
检查修改涉及的 frontmatter、名称与目录一致性、触发语义、引用路径、规则冲突和仓库要求。检查真实加载路径是否减少无关内容,而非只比较正文长度。
按改动选择代表场景,验证应触发与不应触发、建议与实施授权、完成条件或失败处理;具体方法见按需加载的审查清单。纯静态审查不能证明运行效果,也不为措辞调整搭建复杂评测。
运行必要检查,修复本次引入的问题,再重跑受影响项。通过后进入收尾,不无理由扩大或重复测试。缺少工具、网络、鉴权或测试环境时,说明未验证项与原因;不得伪造结果或在失败后宣称完成。只读诊断不需要安装依赖;必需输入或授权缺失时暂停依赖它的操作。
完成标准:范围内修改已落实,相关验证有结论,适用且已授权的安装、提交和推送等交付步骤已完成。遇到无法自行解决的失败,报告已完成部分及具体阻塞,不把首版修改当作全部完成。
输出契约
- 建议阶段:交付有依据的诊断和可执行方案,说明本轮没有修改文件。
- 实施阶段:简要说明修改文件、行为变化、检查结果及仍未验证的部分;涉及安装或版本交付时报告实际状态。
- 区分静态审查、场景推演和实际运行;只有实际测量后才声称触发率、完成率、耗时或上下文用量改善。