pitfall-skill（踩坑 Skill）

纯 Agent Skill（Agent Skills 协议）：踩坑错题本由 scripts/pitfall.js 维护（零 npm 依赖，Node ≥ 18）。

跨 runtime：Cursor / Claude Code / Codex / OpenClaw / Hermes / Workbuddy / CodeBuddy / Gemini / OpenCode 等。路径见 references/runtimes.md。

自动触发（提高命中）

出现下列任一情况时，先读本 Skill 再动手，不要只在对话里复述：

1. 用户提到：踩坑、又踩、又出现、老问题、重复、错题本、recurring、pitfall、复盘、沉淀、固化、写 rule、总结踩坑经验、升级成规则/Skill
2. 用户问：有没有触发踩坑 skill / 记进错题本了吗 / 帮我 log
3. 修完一个「第二次才发现」或「预览 OK、粘贴/真机才坏」的问题
4. 症状与 .pitfalls/ledger.yaml 或已有导出/兼容 rule 高度相似
5. Agent 自己准备「总结踩坑经验」——必须走本流程写入错题本，禁止只输出 Markdown 摘要

不确定时：先 status / 读 .pitfalls/；宁可 log 一笔草稿，也不要沉默。

Hard rules / 硬性约束