https://haokw.github.io/tags/ai-coding/Recent content in Ai-Coding on Hao · AI Agent 学习记录Hugozh-CNTue, 04 Aug 2026 00:00:00 +0800https://haokw.github.io/posts/2026-08-04-ai-coding-harness/Tue, 04 Aug 2026 00:00:00 +0800https://haokw.github.io/posts/2026-08-04-ai-coding-harness/<blockquote> <p>一句话：<strong>Harness 是把「希望 AI 做对」变成「系统保证 AI 做对」的整套工程约束。</strong> 内容脉络：心智模型 → SDD → TDD → AGENTS.md → Lint → CI/CD → Ralph → 完整拼图</p> </blockquote> <hr> <h2 id="0-心智模型先搞懂-harness-是什么">0. 心智模型：先搞懂 harness 是什么<a href="#0-%e5%bf%83%e6%99%ba%e6%a8%a1%e5%9e%8b%e5%85%88%e6%90%9e%e6%87%82-harness-%e6%98%af%e4%bb%80%e4%b9%88" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <h3 id="为什么-ai-编码需要-harness">为什么 AI 编码需要 harness<a href="#%e4%b8%ba%e4%bb%80%e4%b9%88-ai-%e7%bc%96%e7%a0%81%e9%9c%80%e8%a6%81-harness" class="post-heading__anchor" aria-hidden="true">#</a> </h3> <p>AI 编码 Agent（Codex / Claude Code / Cursor）很强：能读整个仓库、改代码、跑命令。但它有三个固有毛病：</p> <ol> <li><strong>会偏离</strong>：做着做着就按自己的想象发挥，不按你的需求</li> <li><strong>会自信地错</strong>：给出看起来很对的代码，实际有 bug</li> <li><strong>会自证</strong>：自己改完自己跑测试，然后说&quot;通过了&quot;</li> </ol> <p>单靠 prompt 约束 → 看运气；靠系统约束 → 可预期。Harness 就是后者：<strong>让 Agent 在跑道内跑，越界就被护栏拦下</strong>。</p> <h3 id="harness-的三层结构">Harness 的三层结构<a href="#harness-%e7%9a%84%e4%b8%89%e5%b1%82%e7%bb%93%e6%9e%84" class="post-heading__anchor" aria-hidden="true">#</a> </h3> <table> <thead> <tr> <th>层次</th> <th>干什么</th> <th>组件</th> </tr> </thead> <tbody> <tr> <td>指令层（Input）</td> <td>告诉 Agent 做什么、怎么做</td> <td>SDD 规格、AGENTS.md、instructions.md</td> </tr> <tr> <td>验证层（Output）</td> <td>客观检查做对没有</td> <td>TDD、Lint、CI/CD</td> </tr> <tr> <td>编排层（Loop）</td> <td>拆任务、循环执行、记进度</td> <td>Ralph</td> </tr> </tbody> </table> <h3 id="两条核心原则">两条核心原则<a href="#%e4%b8%a4%e6%9d%a1%e6%a0%b8%e5%bf%83%e5%8e%9f%e5%88%99" class="post-heading__anchor" aria-hidden="true">#</a> </h3> <ol> <li><strong>确定性机制 &gt; 依赖 Agent 自觉</strong>：能机器验证的（lint、test、CI）不要靠 prompt 要求</li> <li><strong>每层只管一件事</strong>：指令层管&quot;怎么做&quot;，验证层管&quot;对不对&quot;，编排层管&quot;推进到哪了&quot;</li> </ol> <hr> <h2 id="1-sdd规格驱动开发先写规格再写代码">1. SDD：规格驱动开发（先写规格，再写代码）<a href="#1-sdd%e8%a7%84%e6%a0%bc%e9%a9%b1%e5%8a%a8%e5%bc%80%e5%8f%91%e5%85%88%e5%86%99%e8%a7%84%e6%a0%bc%e5%86%8d%e5%86%99%e4%bb%a3%e7%a0%81" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <h3 id="是什么">是什么<a href="#%e6%98%af%e4%bb%80%e4%b9%88" class="post-heading__anchor" aria-hidden="true">#</a> </h3> <p>Spec-Driven Development：先产出规格（spec / PRD），再让 AI 基于规格生成实现。<strong>规格是单一事实来源</strong>，代码只是规格的一种实现。</p>