用途:把重复出现的工作流或项目实践,转化为另一个智能体可加载、理解、执行和评估的 Agent Skill,输出候选技能包;在缺少评估证据时不声称已生产就绪。
主要能力:先判断是否值得创建技能(仅当流程跨任务重复、反复需要相同背景/工具顺序/检查/失败恢复、人类纠正揭示稳定失败机制、任务有输出契约或验证方法、或能减少未来智能体的上下文解释时创建);构建经验池,将证据分为 success_positive、failure_recovered、failure_unrecovered、human_gold 四类,偏好混合池;提出技能形态(create、extend、split、merge),且必须点明要让智能体发生的行为变化;撰写 SKILL.md 作为紧凑任务契约(Goal、Inputs、Workflow、Failure Modes、Verification、Boundaries、Runtime Resources、Output Contract、Handoff),低风险纯文本用最简契约,涉及工具、文件、外部系统、隐私、发布、部署、财务、法律或多智能体时用完整契约;把细节放入 references/、examples/、scripts/、evals/ 等运行时资源,SKILL.md 保持精简并为每个资源写明加载条件;用 if/then 规则编码反复出现的失败;准备评估资产(5 到 10 条训练轨迹或示例、2 到 3 个选择或测试提示、3 到 5 个留出任务、无技能基线、人工基线说明);输出技能包目录(SKILL.md、references/、examples/、scripts/(可选)、evals/、creation-report.md),creation-report.md 按模板包含存在理由、所用与缺失证据、预期行为变化、安全边界、建议选择/测试任务、首关对比计划及最终决定(accept、revise、merge_into_existing、split_required、reject、blocked)与发布状态(experimental、validated、blocked);执行首关对比(no_skill、candidate_skill、human_gold),至少 2 个选择提示加 1 个行为提示,高风险、公开、外部发送或多智能体技能要求 3 到 5 个留出任务与人工评审。
使用方式与资源:构建技能时按工作流执行;需要研究背景与代码机制时加载 references/source-mechanics.md;生成 creation-report.md 时加载 references/creation-report-template.md;需要输入或评审输出形状的具体示例时使用 examples/source-workflow.example.md 和 examples/generated-skill-review.example.md;验证本技能或设计首关时使用 evals/test-prompts.json。
限制:不要在无留出评估或明确人工接受前声称生产就绪;不要把私人轨迹、凭据、客户数据或内部机密写入可复用技能文件;不要为一次性事实、不可验证偏好、无法脱敏的私人细节或需非结构化实时人类判断的任务创建技能;不要用重叠的窄技能替代对已有技能的扩展;不要让同一智能体生成的论证代替验证证据;不要在技能文件中写机器本地绝对路径,应使用相对路径或公开仓库路径与论文名称;证据薄弱时创建实验性技能并在创建报告中标注证据缺口。