القائمة
当用户踩坑后想记录经验教训、当调试完想防止同样的问题再次发生、当做了重要技术决策想记录时使用 — 自动更新 CLAUDE.md 的已知陷阱和决策日志
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当用户首次使用模板、想配置项目信息、需要填写 CLAUDE.md 占位符时使用 — 通过问答自动填写项目信息
当用户想检查无障碍性、添加 ARIA 标签、修复键盘导航或对比度问题时使用 — 检查并修复网站无障碍性问题
当用户想写接口、创建 API、生成后端端点、做增删改查接口时使用 — 生成 RESTful API 端点，包含路由、验证和错误处理
当用户想加登录、注册、用户认证、OAuth、JWT、权限控制时使用 — 为项目添加完整的用户认证系统
当用户想搭建博客、做个人网站、写技术文章、建内容站时使用 — 从零生成完整的博客网站
当用户想生成更新日志、写 CHANGELOG、整理版本记录时使用 — 从 Git 提交历史自动生成 CHANGELOG
| name | learn |
| description | 当用户踩坑后想记录经验教训、当调试完想防止同样的问题再次发生、当做了重要技术决策想记录时使用 — 自动更新 CLAUDE.md 的已知陷阱和决策日志 |
把这次踩的坑或做的决策记录到 CLAUDE.md 中，防止下次再犯。
如果用户已经说了，直接分析。否则问：
你想记录什么？
- 刚踩了个坑，想防止下次再犯
- 做了个技术决策，想记录原因
- 发现了项目的特殊规则，想让 Claude 记住
根据类型收集信息：
踩坑记录：
技术决策：
项目规则：
用精确简洁的语言写一条记录：
踩坑格式：
- [现象描述] — [正确做法]
例：uv sync 会删除未在 pyproject.toml 中声明的包 — 运行前后对比 uv pip list
决策格式：
- 选择 [方案] 而不是 [备选] — 原因：[理由]；否决 [备选] 因为 [理由]
例：选择 SQLite 而不是 PostgreSQL — 原因：单用户项目不需要并发；否决 PostgreSQL 因为运维成本高
读取当前 CLAUDE.md，将新条目追加到对应区块：
写入前展示给用户确认：
准备在 CLAUDE.md 的「已知陷阱」中添加：
- [新条目内容]
确认写入？
用户确认后写入文件。
已更新 CLAUDE.md。下次 Claude 会自动遵守这条规则。