我前三个月的 DSH 会话里有一半时间在重复同一句话:
把这次改动整理成 changelog,按 feat/fix/refactor 分组,每条一行,不要写「优化了体验」这种话。
后来我把它写成了一个 Skill。现在只需要说「出 changelog」,剩下的我自己都不用记得。
Skill 不是提示词模板
它的区别在于承载的信息种类。一份好的 Skill 至少包含四层:
skill/
├── 何时使用 —— 触发条件,也包括「什么时候别用」
├── 前提与输入 —— 需要哪些文件/环境/凭据
├── 步骤 —— 顺序、分支、每一步的验收点
└── 反证与坑 —— 已知会错的地方,以及怎么自检
最后两层是绝大多数「提示词模板」缺失的部分。它们恰恰是最值钱的——那是你踩过坑之后的经验。
我写的 changelog Skill 里有一整节叫「反模式」:
- 不要按 commit 顺序列,要按影响面分组
- 不要出现「若干」「一些」这类词,要么给数字要么删掉
- 合并同一 PR 里的多条碎 commit
- 涉及破坏性变更的,必须放在最前面并标注
BREAKING
这四条没有一条是「格式要求」,全是「我被人骂过之后改的」。写进 Skill 之后,它就不会再犯。
一个完整示例:日志排障 Skill
我给自己写的 log-triage:
# log-triage
## 何时使用
用户提供日志片段、错误码,或描述「线上报错了」,但还没有明确根因。
## 前提
- 有日志原文;如果只有截图,先要求原文(截图会丢栈帧)
- 知道服务名与大致时间窗
## 步骤
1. 定位第一个异常,而不是最后一个。后续错误通常是它的连锁反应。
2. 提取栈帧里属于自有代码的最近三帧。
3. 对照三个常见类别判断:
- 配置类:连接串、超时、环境变量缺失
- 依赖类:版本不兼容、接口契约变化
- 代码类:空值、类型、并发
4. 给出「一句话根因 + 一行验证命令 + 最小修复」。
5. 如果证据不足,明确列出还缺哪一条信息,不要猜。
## 反证
- 出现 OOM 时,先看是不是内存泄漏,而不是先调大堆
- 「偶发」的错误优先怀疑并发或重试,不要先怪网络
- 日志里没有时间戳时,结论一律降级为「可能」
## 输出格式
根因:……
证据:……
验证:<可以复制执行的一行命令>
修复:<最小改动>
注意第 5 步「不要猜」。这条是必须显式写的——默认情况下模型很愿意给你一个听起来合理的答案,而排障场景里一个错误结论的代价远高于「我还需要两条日志」。
该不该沉淀:三条标准
不是所有重复都值得写成 Skill。我用三条筛:
- 发生过三次以上,且每次我都要重新想一遍怎么说。 一次是偶然,两次是巧合,三次是流程。
- 有明确的验收标准。 「写得好一点」没法沉淀;「每个函数都有错误分支」可以。
- 错了会疼。 无所谓的任务,沉淀的收益低于维护成本。
反过来说,下面这些我不写 Skill:
- 一次性探索(「帮我看看这个仓库是干嘛的」)
- 高度依赖具体上下文的判断(架构评审、人事决策)
- 每次都要现场讨论的创作类工作
过度流程化是真实的风险
我一度把 Skill 写得像 SOP:12 个步骤、每步三个子项。结果是模型严格照做,遇到第 3 步就该跳过的场景也硬走完,产出反而更差。
后来我学到了两个技巧:
给判断,不给清单。 与其写「检查 A、B、C、D」,不如写「如果 A 和 B 冲突,以 A 为准,因为……」。前者是机械执行,后者是传递判断力。
留一个逃生口。 在步骤末尾加一句:「若上述步骤与实际情况明显不符,先说明冲突再决定,不要强行套用。」这一句能救回大量僵硬执行。
版本化与 review
Skill 是文件,所以它天然可以进 git。我给自己定的规矩:
- 每次因为 Skill 不到位而返工,就提一个小 commit 补进「反证」一节
- 每季度看一遍,删掉已经内化成常识的条目(否则上下文白烧)
- 团队共用时,Skill 的 diff 就是最好的 prompt 评审材料
一年下来,我的 skills/ 目录变成了一个奇怪的资产:它不是代码,也不是文档,而是一份可执行的个人经验。新人拿走它,等于拿走我踩过的坑。
下一篇聊一个更硬的话题:Agent 能动你的文件系统和终端,权限应该怎么给。

文章评论