Qoder 工程实践：Harness Engineering 指南

来源类型：本地文档（raw/articles/ 增量 ingest）
日期：2026-06-24
Tags：Harness, AI Agent, 微信生态

概述

author: "泮圣伟" created: "2026-06-17" - 微信文章 - clipping 当我们让 AI Agent 实现一个功能，它思考了一下，开始写代码。200 行写完，运行 lint 直接失败。我们发现类型定义文件 import 了配置包，但是违反了我们期望的架构分层约束，因为 Agent 不知道这个规则，当然我们也没告诉它。 于是它开始修复：移动代码、调整依赖、重新组织。再跑 lint——又一个新问题。循环三次后，上下文窗口被错误日志和 diff 塞满，Agent 开始"忘记"最初的任务目标。 这不是 Agent 不够聪明。这是 Agent 看不见。

核心要点

• 1. 首先，仓库是唯一的事实来源。Aone里的讨论、钉钉会议上的口头约定、架构师脑子里的蓝图，这些对 Agent 来说都不存在。不在仓库里，Agent 就看不见；看不见就会违反。所以第一步是把一切编码到仓库中：架构决策、层级约束、命名规范。不是写在 Wiki 里，不是发在群里，而是作为版本化的文件提交到 Git。这样知识跟着代码一起走，新人 clone 仓库就能拿到全部上下文，Agent 打开项目就能读到一切。2. 但编码到仓库不意味着把所有东西塞进一个文件。很多团队的第一反应是写一份巨大的 A...
• 1. 然后是约束的粒度。Harness 不规定"你必须用这个设计模式"或"函数必须这样写"，它只管架构边界。大多数代码库的包和模块之间存在自然的依赖方向：类型定义被所有人 import、业务逻辑依赖类型但不依赖 HTTP 层、HTTP handler 依赖业务逻辑。Harness 把这种自然方向编码为层级编号——Layer 0 是类型定义（不 import 任何内部包），Layer 1-2 是工具函数和配置（只依赖更低层），Layer 3 是业务逻辑，Layer 4+ 是 HTTP handle...

来源

原始文件：Qoder 工程实践：Harness Engineering 指南.md相关链接：https://mp.weixin.qq.com/s/Et3WwNtEXEgxjaQHrQFDyQ，https://mmbiz.qpic.cn/mmbiz_jpg/Z6bicxIx5naJxNXwnQHc7Eice692GnKUHnOz1Td4Ddsf31jNsk3MOPxdwOyot1mtpssRw7EKxOKkv5hz6IgZAa3w/640?wx_fmt=jpeg

引用统计

本文档收录于 wiki sources，支持通过 wiki/index 检索。