工作转 AI 执行手册

要解决的问题

很多团队已经跑通一个流程、解决过一个项目、踩过一批坑，但经验仍散落在聊天记录、口头说明和零散文档里。Agent 拿到材料后，还是会问“接下来怎么办”、重复踩同一个错，或者无法判断任务是否完成。该技能要解决的是：把已完成的工作转成可复现的执行手册，而不是先写一份泛泛的说明书。

技能如何工作

• 先判断路径：区分 创建新技能 与 更新已有技能，避免直接覆盖旧内容。
• 按阶段封装：工作识别、经验萃取、教学记录、技能封装、可复现性验证、数据脱敏。
• 强调 Gotchas 可执行：不写“注意金额单位”，而写“遇到金额时传分时值”。
• 控制文件结构：SKILL.md 保持入口清晰，超过约 30 行细节拆到 references/，并保留验证标准。
• 补充更新与脱敏：对已有技能做增量更新、SemVer 升版；对 8 类敏感信息按用户选择脱敏。

适用边界

适合封装已完成、可重复、有明确验证标准的工作；不适合一次性任务、通用工具或仅项目约定。技能必须来自真实失败记录和教学过程，不能凭理论空写；若包含内部信息，交付前需完成脱敏确认。