别再卷提示词了！决定 AI 写代码成败的，其实是 Harness

你好我是郭震最近我用 AI 写代码越来越多感受也越来越明显AI 不是不能写代码而是很容易在真实项目里“写偏”。一个简单页面、一个小接口它可能很快搞定但只要任务稍微复杂一点比如牵涉多个文件、历史代码、测试命令、业务边界它就开始不稳。我之前也踩过这个坑。所以今天这篇我想重新把 Harness 这个概念讲清楚。1 AI 写代码为什么总翻车很多人第一反应是是不是模型不够强当然模型能力会影响结果但我越来越觉得很多翻车并不是模型问题而是任务环境太松。比如你只说“帮我优化一下登录页”。这句话对人来说还能靠经验补全但对 AI 来说里面有一堆空白优化什么只改样式还是改逻辑这些空白如果不提前固定AI 就会开始猜。如下图所示一张图看懂 AI 写代码最常见的 6 个翻车原因所以我现在看 AI 编程已经不只看“模型会不会写”更看“有没有一套东西限制它怎么写”。这套东西就是 Harness。2 Harness 到底是什么一句话理解Harness 不是提示词而是 AI 编程的工程夹具。提示词像是开场白告诉 AI 你要做什么Harness 更像工作台把需求、上下文、工具、验证、复盘这些东西固定住。它的目标不是让 AI 输出更漂亮而是让 AI 的行为更可控。如下图所示一张卡片看懂 Harness 到底固定了什么这五层不用背概念按实际工作理解就行。任务层负责说清楚目标和边界上下文层负责告诉 AI 该看哪些文件工具层负责固定读、搜、测、改这些动作验证层负责判断能不能交付记忆层负责把失败经验变成下次的模板。如下图所示这是 AI 编程 Harness 的五层架构3 从零怎么搭第一版如果你是第一次做不要一上来就搞平台。第一版越简单越好先放一个AI-HARNESS.md就够了。里面先写 5 件事项目怎么启动核心目录在哪里哪些文件不能乱动常用测试命令是什么每类任务怎么验收。如下图所示我建议第一版这样写项目入口启动、构建、测试命令 仓库地图核心目录、关键模块、常用入口 权限边界允许修改什么禁止修改什么 验证方式每类任务必须跑哪些检查 交付格式变更摘要、验证结果、剩余风险 失败记录AI 过去容易犯错的地方这份文档不用长但一定要真实。4 一个任务怎么跑我现在比较推荐的节奏是先写任务卡再补上下文然后让 AI 小步修改接着跑验证最后人工 Review 和复盘。重点是“小步”。不要让 AI 一次改十几个文件尤其不要让它顺手重构。一次只解决一个明确问题改完马上验证。这样即使错了也能很快知道错在哪里。如下图所示这是一个任务从需求到交付的完整闭环如果验证失败也不要急着让 AI “重新写一遍”。更好的做法是问失败暴露了 Harness 哪一块没写清楚是上下文缺文件还是权限边界没说最后总结一下AI 写代码总翻车不一定是模型不行。很多时候是我们只给了它一个需求却没有给它一套工程环境。Harness 的价值就在这里它让 AI 少猜一点让人少返工一点让代码改动更容易验证。对个人来说它能让 AI 编程从抽卡变成流程。一句话总结提示词决定 AI 怎么开始Harness 决定 AI 能不能交付。全文约 1635 字5 图如果你觉得这篇文章对你有帮助也欢迎给我一个三连点击点赞、转发和在看如果可以再帮我点一个星标。谢谢你看到这里我们下篇再见。