pitfall-skill

仓库创建 2026年7月25日最近提交 1 天前SkillHot 收录 3 小时前

⬈ GitHub 仓库 ⬈ SKILL.md 原文件 ⬇ Raw 原始文件

▸ 精选理由

适合团队沉淀复现性问题，自动化记录并推动归档升级。

▸ 风险提示

会在项目内写入文件，需授予写权限并注意仓库隐私

这个 Skill 做什么

将重复出现的坑/错题记录到 .pitfalls 并在确认解决后升级为 Skill/规则。

▸ 展开 SKILL.md 英文原文

踩坑错题本与规则/Skill 升级：把反复出现的同类 bug、兼容坑、导出坑、登录坑记入项目 .pitfalls/，跨 session 计数，≥2 次且用户确认已解决后升级为 Cursor .mdc / CLAUDE.md / AGENTS.md 或领域 Skill。MUST use when: 用户说踩坑/又踩了/又出现/ 老问题/重复bug/recurring/pitfall/lesson learned/沉淀经验/固化规则/写进rule/ 总结踩坑/复盘这次bug/别再犯；修完后要沉淀；预览正常但线上/粘贴/真机才坏；症状像已有 .pitfalls 或 wechat-export 类兼容坑；用户问「触发踩坑skill了吗」或「用踩坑 skill 记录」「记一笔」「错题本」。Also after agent summarizes past failures — do not only chat-summarize, run scripts/pitfall.js log. 禁止只口头总结而不写错题本。

Skill 开发管理错误管理复盘工程化脚本通用

Stars

Forks

仓库内 Skill

积累中

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/chrislee121/pitfall-skill/main/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/chrislee121/pitfall-skill/main/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# pitfall-skill（踩坑 Skill）

纯 Agent Skill：工作流在本文件；**踩坑错题本**由 `scripts/pitfall.js` 维护（零 npm 依赖，Node ≥ 18）。

## 自动触发（提高命中）

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

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

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

## Hard rules / 硬性约束

1. **升级前先确认。** 对话里先问用户；禁止静默改规则文件或生成领域 Skill。
2. **Threshold:** `occurrence_count >= 2` 才可升级（CLI 子命令仍为 `promote`）。
3. **长经验 → skill，短约束 → rule**，避免撑爆 `CLAUDE.md` / `AGENTS.md`。
4. 用本目录 `scripts/pitf

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有