陷阱总复盘 + 一页纸自检清单

五大类陷阱(把 21 个归位)

• 🌀 编造类:#1 编 API · #2 编配置文档
• ✋ 越界类:#3 偷改别处 · #4 误删代码 · #8 过度工程 · #16 重复 · #17 风格乱
• 🔓 安全类:#5 硬编码密钥 · #6 注入漏洞 · #7 不校验输入
• 🐞 正确性类:#9 只写顺路 · #10 版本不匹配 · #11 废弃写法 · #12 逻辑错 · #13 边界 · #18 假测试 · #19 回归
• 🧠 协作/认知类:#14 前后矛盾 · #15 忘约定 · #20 盲目自信 · #21 该问不问

📋 一页纸自检清单(收藏,审查每次 AI 改动时照着过)

1. 改了什么:git diff 看清范围——有没有越界、误删?(#3 #4)
2. 逻辑对吗:用已知答案的例子验证;让它解释关键处(#12 #6 学习式提问)
3. 边界:空、首尾、0、临界、异常输入处理了吗?(#13 #7 #9)
4. 安全:密钥没写死?输入校验了?注入防了?(#5 #6 #7)
5. 真实有效:测试是真测、不是假绿?改完跑全测防回归?(#18 #19)
6. 一致与简洁:命名/格式统一?没重复?没过度设计?(#14 #16 #17 #8)
7. 新鲜可靠:版本对、写法没过时、配置/API 真实存在?(#1 #2 #10 #11)
8. 别被语气骗:它说"没问题"不算数,只信你验证过的(#20 #21)

🏆 P4 终极交付:给一个 AI 项目做"靠谱化改造"

拿出你在 P3 阶段(6.16)用 AI 做的那个小工具,用这张清单给它做一次彻底体检:

• 逐项对照清单,把发现的坑列出来
• 一个个修(改前 git commit、改后 git diff、补测试)
• 把项目从"能跑的玩具"改造成"经得起检验的靠谱小产品"

请对这个项目做一次全面体检,逐项检查并报告问题:1) 改动范围与误删;2) 逻辑正确性(用例子验证);3) 边界与异常处理;4) 安全(硬编码密钥、输入校验、注入);5) 测试是否真实有效、有无回归风险;6) 一致性/重复/过度设计;7) 是否用了过时或不存在的写法。每类列出具体问题和位置,并给出修复建议。先只报告、不要改动,等我逐项确认后再修。