📦 Standardize the de-upgrading and iteration of SKILL — Standardize the de-upgrading and iteration of 技能

技能 Lifecycle Engineering Overview

技能 不是写完就结束的静态文档，而是需要持续迭代的 spec 工程。本方法论覆盖 技能 的完整生命周期：识别候选 → 变更管理 → 下游串联。

Phase 1: Identification — 何时创建 技能

核心信号： 如果一件事需要很多动作、聊了很多次才完成，它就是 技能 的候选。

digraph identify { "完成了一项工作" [shape=doublecircle]; "花了多少轮对话?" [shape=diamond]; "涉及多少步骤?" [shape=diamond]; "下次还会做吗?" [shape=diamond]; "创建 技能" [shape=box]; "不需要 技能" [shape=box];

"完成了一项工作" -> "花了多少轮对话?"; "花了多少轮对话?" -> "涉及多少步骤?" [label=">=3轮"]; "花了多少轮对话?" -> "不需要 技能" [label="1-2轮"]; "涉及多少步骤?" -> "下次还会做吗?" [label=">=3步"]; "涉及多少步骤?" -> "不需要 技能" [label="1-2步"]; "下次还会做吗?" -> "创建 技能" [label="是"]; "下次还会做吗?" -> "不需要 技能" [label="否"]; }

识别检查清单：

多轮对话（>=3轮）才完成 涉及多个工具或步骤（>=3步） 未来会重复执行 过程中有非显而易见的判断或决策 自动检测（Hook 驱动）

已配置 hooks 自动监测 会话 复杂度：

Post工具Use hook（a同步, 0 令牌）— 每次工具调用递增计数器，纯 shell 无 Claude 参与 停止 hook — 会话 结束时检查计数器，仅当 >=15 次工具调用时才注入 1 句提示

阈值可通过环境变量调整：技能_CANDIDATE_THRESHOLD=20

令牌 开销： 低于阈值的 会话 = 0 额外 令牌。超过阈值 = ~30 令牌 的提示注入。

Phase 2: Change Management — CHANGE.md 提案机制

当 技能 在使用过程中暴露问题或需要改进时，不要直接修改 技能.md，而是先在 CHANGE.md 中记录提案。

CHANGE.md 格式

在对应 技能 目录下创建 CHANGE.md：

# Change Proposals

#001 - [提案标题]

• 状态: proposed | accepted | rejected | implemented
• Date: 2026-04-30
• Trigger: 什么场景触发了这个修改需求
• Proposal: 具体要修改什么，为什么
• Impact: 修改后对现有流程的影响

#002 - [提案标题]

提案状态流转 proposed → [用户 review] → accepted → implemented → rejected (附原因)

规则：

编号从 #001 开始，递增不跳号 每个提案必须经过用户 review 才能进入 accepted implemented 后在 技能.md 中标注对应提案编号 rejected 的提案保留记录，附拒绝原因 何时创建提案 技能 执行中发现步骤缺失或顺序有误 用户反馈某步骤多余或需要调整 发现新的边界条件未覆盖 下游 技能 对接时发现接口不匹配 Phase 3: Composition — 下游 技能 串联

技能 执行完毕后，评估是否存在可串联的下游 技能。

评估维度：

问题 如果是 当前 技能 的输出是否是另一个 技能 的输入？ 建立串联关系 执行完后是否有固定的后续动作？ 考虑在 技能.md 末尾添加 Next Step 多个 技能 是否总是一起执行？ 考虑创建编排 技能

串联方式：

显式推荐 — 在 技能.md 末尾添加：

Next Steps

• 如果需要 X，使用 [技能-name]
• 如果需要 Y，使用 [another-技能]

编排 技能 — 当多个 技能 固定组合时，创建一个新的编排 技能 定义执行顺序和数据传递。

Quick Reference 阶段 触发条件 产物 Identification 多轮、多步、可重复 新 技能.md Change Management 使用中发现问题 CHANGE.md 提案 Composition 执行后有后续动作 Next Steps / 编排 技能 Common Mistakes 直接改 技能.md 不留痕迹 — 用 CHANGE.md 追踪，保留决策历史 提案堆积不 review — 定期清理，保持提案列表可管理 过度串联 — 只串联真正有数据依赖的 技能，不要为了串联而串联 忽略 rejected 提案 — rejected 的提案同样有参考价值，保留原因记录