坑库
每张卡片都来自真实复盘：发生了什么、为什么、怎么防
这里收的都是我真实踩过的坑。每张卡片固定四段：发生了什么、为什么会这样、怎么做、相关；最上面一句是可以直接照做的规则。按阶段或档位筛选，找到和你手上的事最相关的那几张。
如果装了本手册的插件，可以让 Claude 用 /ainative:pitfall-check 拿这些卡片逐条审查你当前的计划或改动。
谁说“之前是 X”，都先查 git 历史，再决定要不要把它当约束
任何破坏性数据库操作之前先 dump，备份失败就不执行
开着本机代理时别信 dig，用 DoH 或换个网络验证 DNS
改写 git 历史的操作一律不让 agent 自主执行
按真实调用数据定期精简插件和 subagent，用不到的就停用
写长期对外的文档之前，先读相关的权威文档
发布产物逐项打勾验证，清单固化进 skill
护栏要有体检：用脚本定期确认规则、hook 和备份步骤都还在
多阶段的功能合并前，必须对整个分支做一次终审
会随代码改的文档放代码仓，文档里的检查步骤改成 CI
大任务的计划和执行分开会话：计划落成文件、审完，再开新会话执行
跨仓引用一律写完整 URL，并让园丁定期检查失效链接
任何临时绕路，都在 PR 里写明撤销条件，并记入待撤清单
共用规则做成可继承的模板（插件），不要复制
用过配置切换工具，先查权限、hook、插件三项；关键护栏放托管设置
UI 改动必须真启动、真打开、亲眼看到结果，才算完成
实质改动先写 spec 和 plan 再按 TDD 实现，一行级修复也留句记录
同一组织统一一个自动记忆目录，别让记忆按启动目录分家
只让一套流程引擎自动触发，其余框架只留手动调用
网络类状态变更失败后，先确认远端真实状态，再决定重试还是放弃
性能修复上线前先答完六个问题，答不出就不上线
一个域名只挂一个平台；删除前先查同一主域下的全部依赖
有工程不变量的任务，子 agent 默认用最强模型；纯机械任务例外
重大改动由另一个模型家族独立二审，人最后拍板
发版前在本地跑完全量验证，CI 只是下限