Coding-Guidelines on D7 的知识库

Coding-Guidelines on D7 的知识库https://blog.eastseven.cn/tags/coding-guidelines/Recent content in Coding-Guidelines on D7 的知识库Hugozh-cnFri, 10 Apr 2026 00:00:00 +0000Andrej Karpathy Skillshttps://blog.eastseven.cn/posts/04-devops/andrej-karpathy-skills---llm%E7%BC%96%E7%A0%81%E5%87%86%E5%88%99/Fri, 10 Apr 2026 00:00:00 +0000https://blog.eastseven.cn/posts/04-devops/andrej-karpathy-skills---llm%E7%BC%96%E7%A0%81%E5%87%86%E5%88%99/<h1 id="andrej-karpathy-skills---llm-编码准则">Andrej Karpathy Skills - LLM 编码准则</h1> <h2 id="简介">简介</h2> <p>一个 CLAUDE.md 文件，源自 Andrej Karpathy 对 LLM 编码常见问题的观察总结，用于改善 Claude Code 的行为。</p> <h2 id="karpathy-指出的-llm-编码问题">Karpathy 指出的 LLM 编码问题</h2> <ul> <li>模型会默默做出错误假设，不检查就一路走下去</li> <li>不管理困惑、不寻求澄清、不暴露矛盾、不展示权衡</li> <li>喜欢过度复杂化代码和 API，臃肿的抽象，不清理死代码</li> <li>100 行能搞定的事写成 1000 行</li> <li>有时会误删/修改它们不完全理解的注释和代码</li> </ul> <h2 id="四大原则">四大原则</h2> <h3 id="1-think-before-coding先思考再编码">1. Think Before Coding（先思考再编码）</h3> <ul> <li>不假设、不隐藏困惑、展示权衡</li> <li>明确陈述假设 — 不确定就问，不要猜</li> <li>展示多种理解 — 有歧义时不要静默选择</li> <li>该反驳就反驳 — 如果有更简单的方案，直说</li> <li>困惑时停下来 — 说出不清楚的地方，请求澄清</li> </ul> <h3 id="2-simplicity-first简洁优先">2. Simplicity First（简洁优先）</h3> <ul> <li>用最少的代码解决问题，不写投机性代码</li> <li>不添加没要求的功能、不为单次使用建抽象</li> <li>不搞没请求的"灵活性"和"可配置性"</li> <li>如果 200 行可以写成 50 行，就重写</li> <li>检验标准：高级工程师会认为这过于复杂吗？</li> </ul> <h3 id="3-surgical-changes精准修改">3. Surgical Changes（精准修改）</h3> <ul> <li>只触碰必要的代码，只清理自己制造的混乱</li> <li>不"改善"相邻代码、注释或格式</li> <li>不重构没坏的东西，匹配已有风格</li> <li>你的改动产生的废弃代码要删掉，但预存的死代码只提不删</li> <li>检验标准：每一行改动都能追溯到用户的请求</li> </ul> <h3 id="4-goal-driven-execution目标驱动执行">4. Goal-Driven Execution（目标驱动执行）</h3> <ul> <li>定义成功标准，循环直到验证通过</li> <li>把命令式任务转化为可验证的目标： <ul> <li>“添加验证” → “为无效输入写测试，然后让它们通过”</li> <li>“修复 bug” → “写一个复现它的测试，然后让测试通过”</li> <li>“重构 X” → “确保重构前后测试都通过”</li> </ul> </li> <li>多步任务先列计划，每步附验证检查点</li> </ul> <h2 id="安装方式">安装方式</h2> <p><strong>Claude Code 插件（推荐）：</strong></p>