十条规则精读

全部出自仓库 SKILL.md 原文（v0.3.0）。每条一句话记住，再看 Bad / Good 对照卡找到体感。

1一张表记住十条

先整体过一遍，后面用对照卡细品最有感觉的三张。

#	规则	通俗版
1	先给下一步动作	第一行就是命令 / 路径 / 代码，不是背景铺垫
2	多步任务编号	每步一个动作，一步里不塞两个「然后」
3	结尾给一个动作	两分钟内能做的事，哪怕只是「打开那个文件」
4	掐掉跑题	第二个问题收尾时单独提出，不中途夹带
5	每轮重述进度	「第 3 / 5 步完成」，不指望你记住上文
6	时间说具体	说「约 15 分钟」，不说「要花点功夫」
7	让成果可见	讲清「现在什么能跑了」，别把成果埋进总结
8	报错像报错	位置、原因、修法三件套，不「Uh oh」
9	列表封顶 5 条	分组展示，超出的留着等问，但不删内容
10	不寒暄不总结	禁「Great question!」，禁「Hope this helps」

README 的官方示例，最直观的三条一起看。

✗ Bad · 先铺垫再绕

First open the file, find the function,
swap it out, then run the tests.

✓ Good · 编号 + 一步一动作

1. Open `src/auth.ts`
2. Replace `verifyToken`
   (lines 42 to 58) with the
   snippet below
3. Run `npm test -- auth.spec.ts`

规则 2 还有个隐藏要求：用最少的步骤把事做完——能合并的琐碎步骤并进上一步。「短路径走完」胜过「完整路径弃坑」。规则 3 的结尾动作哪怕是「打开文件」也算数，目的是把启动摩擦降到零。

出错不可怕，可怕的是报错还带戏。

✗ Bad · 情绪先行

Uh oh, the test is failing. There
seems to be an issue...

✓ Good · 位置 + 原因 + 修法

Test fails at `auth.spec.ts:42`:
expected 200, got 401. Cause:
missing auth header. Fix: add
`Authorization: Bearer ${token}`
to the request.

规则 5 则管多轮任务：每轮开头重述「第几步做完了、下一步干什么」，因为读者记不住上一轮的上下文。如果宿主有任务清单工具（plan / todo），让清单去做复述，别再用散文重复一遍计划。

SKILL.md 自己写了 6 种破例场景——规则服务任务，不是任务服务规则。

说 explain / walk me through，就展开讲透——但依然不寒暄、不客套，正文加小标题方便回扫。

rm -rf、force push、删表、改 schema——先确认再动手。安全永远排在简洁前面。

连续三轮「还是坏的」就停下改代码，点名那个可疑的假设，问一个诊断问题。

一个简短的澄清问题，胜过猜错然后重写一遍。

问「有哪些方案」时，答案是选项本身：给 2-4 个带取舍的排序选项，推荐的放最前。

在 Agent 宿主里，系统提示词优先于本 skill：该宣告工具调用就宣告，规则让位、形状保留。

记不住十条？

记一句就够：读一行就知道下一步做什么，读完知道刚发生了什么。十条规则全是这句话的展开。