菜单
当用户踩坑后想记录经验教训、当调试完想防止同样的问题再次发生、当做了重要技术决策想记录时使用 — 自动更新 CLAUDE.md 的已知陷阱和决策日志
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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 会自动遵守这条规则。
当用户首次使用模板、想配置项目信息、需要填写 CLAUDE.md 占位符时使用 — 通过问答自动填写项目信息
当用户想检查无障碍性、添加 ARIA 标签、修复键盘导航或对比度问题时使用 — 检查并修复网站无障碍性问题
当用户想写接口、创建 API、生成后端端点、做增删改查接口时使用 — 生成 RESTful API 端点，包含路由、验证和错误处理
当用户想加登录、注册、用户认证、OAuth、JWT、权限控制时使用 — 为项目添加完整的用户认证系统
当用户想搭建博客、做个人网站、写技术文章、建内容站时使用 — 从零生成完整的博客网站
当用户想生成更新日志、写 CHANGELOG、整理版本记录时使用 — 从 Git 提交历史自动生成 CHANGELOG