Skill Design 是一个面向 Agent Skill 的元技能,用于在设计、强化或审计阶段判断一个技能是否站得住脚。它把十个原则统一为一个核心问题:执行者能否仅凭技能提供的内容,关闭被委托给它的每一个决策。决策能关闭,意味着执行者能列出选项(含默认项)、区分已知事实与假设、按明确规则排序、剔除违反约束的选项、预测所选选项的结果并看出哪个动作有约束力。技能若在这些环节有所欠缺又未给出查找途径,就是待补的工作。
分工上,构建、测试与打包归 skill-creator;决定技能应是什么样、是否站得住脚归本技能。一旦进入撰写 SKILL.md、运行 eval、调优描述或打包,应交给 skill-creator。
三种模式按现实状态而非自身能力选择:尚无 SKILL.md(想法、已捕获流程、待提炼对话)走 Design,产出设计简报;已有 SKILL.md 且用户想改动走 Refactor,产出类型化变更集;已有 SKILL.md 且只想判断不改动走 Audit,产出用户确认的优先级。请求跨越两种模式时先跑 Audit 再带入 Refactor;用户要求重构但未说明不适配点,也先按原则整体走查再确认目标;无法判断模式时先向用户提一个问题,不猜测;请求不属于任何模式时如实说明,不强行套用。
进入某模式时才读对应参考文件(design.md、refactor.md、audit.md)。十个原则收录于 principles.md,设计或重构前阅读,审计时作为透镜与用户共同走查。每个模式列有编号动作,不确定时按序执行;若能找到更贴合任务且仍能达成出口产物的动作,可采用并说明改动与理由。证据强度应匹配风险:技能复用频率、错误决策的撤销成本、输出读者。个人周末项目证据可少,团队市场级项目则每一步都要更多证据。仅当出口产物存在且符合规格时才结束模式,不以工作感觉完成为准。