llm-coding-mistake-guardrails - SKILL.md Agent Skill

name: llm-coding-mistake-guardrails title: 减少 LLM 编码常见错误的准则 description: 当用 LLM 编写、审查或重构代码时使用；产出最小可行改动 + 显式假设 + 可验证成功标准（先写复现/校验测试再实现）；不适用于无需谨慎权衡的琐碎改动或纯需求澄清；触发词：LLM 编码、外科手术式改动、过度设计、可验证目标 domain: 研发/review triggers: [用 LLM 写代码, review 代码避免过度设计, 重构要保持最小改动, 把任务变成可验证目标, 代码过度复杂需要简化, 改动只动该动的] tags: [编码准则, code-review, llm 编码, 简洁性, 重构] level: 进阶 status: stable agents: [claude-code, codex, cursor, gemini-cli] tools: [claude-code, cursor, codex-cli, gemini-cli] requires: [] related: [adversarial-code-reviewer, code-reviewer, clean-code-principles, autonomous-coding-agent-patterns] combines_with: [test-coverage-gap-finder, systematic-debugger, code-simplifier] license: MIT source: sickn33/antigravity-awesome-skills source_license: MIT

不该用（负边界）：

权衡：本准则偏向「谨慎优先于速度」。它是行为护栏，不替代项目自身的架构与风格规范。

编码前先想清楚：显式说明假设；存在多种解读就全列出、不要默默选一个；有更简方案就指出并在合理时反推（push back）；有不清楚的地方先停下，点名困惑点并发问。
简洁优先：只写解决问题的最小代码——不加未被要求的功能、不为一次性代码做抽象、不加未请求的「灵活性/可配置」、不为不可能发生的场景写错误处理。自检：「资深工程师会不会觉得这过度复杂？」是则重写。
外科手术式改动：只碰必须碰的；不顺手「优化」相邻代码/注释/格式，不重构没坏的东西，沿用现有风格即使你有别的偏好；发现无关死代码只提示、不删除。
清理你自己制造的孤儿：移除因「你的改动」而失效的 import/变量/函数；除非被要求，不动既有的历史死代码。
目标驱动执行：把任务转成可验证目标，定义成功标准后独立循环直到通过。多步任务先给一句话计划，每步附带 verify。

改动的判定标准：每一行被改动的代码，都应能直接追溯到用户的需求。
任务转目标的范式：
- 「加校验」→「先为非法输入写测试，再让它们通过」
- 「修这个 bug」→「先写一个复现它的测试，再让它通过」
- 「重构 X」→「确保重构前后测试都通过」
多步计划模板：

1. [步骤] -> verify: [检查项]
2. [步骤] -> verify: [检查项]
3. [步骤] -> verify: [检查项]

强成功标准让你能独立循环；「让它能跑起来」这类弱标准会导致反复澄清。

用户请求：「给这个表单加校验。」

更好的回应：
1. 假设：校验应在提交前运行，并就地显示行内错误。
2. 计划：加一个小校验器，为非法输入加测试，再验证既有提交行为不变。
3. 范围：只改表单组件及其测试文件。

用户请求：「重构这个 service。」

更好的回应：
1. 先问：哪些行为必须保持不变？
2. 定位一个具体坏味道，例如重复的解析逻辑。
3. 做最小重构，并跑既有的 service 测试。

采编自 sickn33/antigravity-awesome-skills（MIT），原始条目 multica-ai/andrej-karpathy-skills。