AI写得快 ≠ 真正提效:Harness 记忆与验证闭环
- 原文:https://mp.weixin.qq.com/s/SVm_GONXEElhEsX6CXylKg
- 来源:腾讯云开发者;原创作者焦成杰;发布时间 2026-09-23 08:30
- 获取:2026-09-23;浏览器核对正文后清洗扫码与推广段落
- 原文归档 · 原文摘要
核心结论
AI Coding 的产出速度只解决“写”,真正提效要让知识在新会话可被发现、交付状态有外部证据、验证等到系统生效,失败能有界回退。
归入 02-ai-coding:本文以软件研发交付为场景,给出知识入口、四类操作 skill、close-loop 和多角色验证的实现路径,不是通用 Agent 架构综述。其工程机制与现有 Harness 条目互补,不能把作者的实现细节直接当通用标准。
九个知识节点
- 连接性知识:只存代码未写清的阴性事实、关键位置和隐含跨系统关联;能从代码读出的参数与目录不重复入库。
- 两级索引:一级
agents.md 只列模块,二级 <模块>/agents2.md 列篇目及一句话用途;按索引命中正文,未覆盖才探索源码。
- 先读 Hook:PreToolUse 阻断尚未读一级索引的探索调用;项目规则表达意图,SessionStart 负责重同步,避免每次工具调用承担重任务。
- 成熟度证据:读取只是弱信号,任务声明实际采用及结果才是强信号;增量聚合提升等级,低频清理负责去重与衰减,frontmatter 需定点修改。
- 四类 Skill:平台访问、提交、等待、本地验证各管一段;技能说明操作条件和失败边界,脚本承接确定性的接口调用。
- 等待终态:等“该分支的这次构建/门禁”,不能用最近一次产物或刚触发的动作充当已生效证据;超时必须如实上报。
- 交付状态链:排查、编码、本地/测试验证、提交/MR/合入、等待、上线观察、回写经验是不同状态,各有可复核证据。
- 独立审查:写代码与审查/验证分角色,大改动用精确制品传递
文件:行 与失败清单,避免长会话压缩后丢失关键事实。
- 有界循环:编码—审查、验证—编码、线上验证—编码各最多三轮;回退后重走完整审查与验证,超限报告
blocked、failed 或 not_verified。
方法与证据
作者的记忆链从会话结束复盘写入,经过模块索引与 hook 进入下一次会话,再由成熟度机制追踪实际采用。复盘只写脱离单次任务仍成立的知识;“读过”和“用过且被验证”不能混成同一种引用。其本地 REST API 定点回写 frontmatter、检查点按字节与前缀哈希去重,属于作者实现,不等于已有团队系统已经具备同样能力。
闭环链以等待 skill 为枢纽:平台脚本提供查询与动作,提交 skill 处理单号、分支、MR 和门禁,本地验证 skill 明示环境依赖,close-loop 把这些阶段连接起来。文章强调“所有验证动作在测试环境做”;生产发布后的检查应区分被动观测和对生产环境施加的验证动作,不能越权复制流程。
团队版只用于改动面大的任务。隔离上下文减少历史污染,但精确制品是前提;审查成员禁止写代码是工具层权限,而不是一句提示词。作者没有提供可复现仓库、完整成本对照或成功率实验,本文的效率收益是经验判断,不是已验证的量化结论。
对 Seetong 的可借鉴动作
- 选一个跨端重复排查点做知识试验:只写版本串语义、埋点缺口或跨 SDK 的隐含关联,在项目索引加入口;用后续两次真实任务检验是否少走搜索路径。
- 给“报告已生成”与“报告已送达”分开设门:用文件哈希、查询校验、部署版本和企微 ACK 对应四种状态;任何一步缺证据就保持未完成。
- 等待正确对象:TAPD、GitLab MR、Pages 部署与数据任务分别绑定本次 ID/提交,而非读最近一次运行结果;超时返回待验证,不沿用旧产物。
- 小改顺序、大改分工:单文件修复先走紧凑验证;跨 iOS/Android/SDK 时让审查者只读,并要求交接给出文件行号、反例与验收证据。
- 先审 Hook 成本与豁免条件:若做“先读知识库”拦截,限制在探索工具,实测启动开销、误拦率和紧急修复场景,不把软规则直接升成全局强阻断。
关联与边界
- 上游:[[01-ai-agents/腾讯程序员-Agent的上限可能不在模型而在团队知识]] 讨论团队知识供给;[[02-ai-coding/大淘宝技术-AI驱动研发体系-Price360-KB项目Harness]] 讨论稳定资产与动态事实。
- 下游:[[02-ai-coding/得物技术-Delivery-Harness-可控AI交付]] 的证据门禁可承载本文的等待和状态链;[[01-ai-agents/Loop-Engineering-验证才是瓶颈]] 指向独立验证。
- 同级:[[02-ai-coding/腾讯云开发者-Agent的命门是上下文-关键不在少给而在给对]] 偏“给谁、何时给、保留多久”,本文偏“记什么、如何强制读、怎样交付到底”。
- 边界:三轮上限、成熟度周期、一级索引先读和多角色编队均为作者方案;探索型任务与低风险小改不宜照搬重流程。