一句话:Harness = 知识库底座 + 状态文件驱动 + 12 专家 Agent + DAG 并行 + 脚本化执行 + DevOps 集成——不是给 AI Coding 加规则,而是把对话窗口升级为工程系统。
| 维度 | 核心命题 | 关键数字/设计 |
|---|---|---|
| 整体架构 | 知识库工程 ✖️ 端到端开发工程 | 800+ 文档 / 90+ 微服务 / 12 Agent / 30+ Skill / 10+ 脚本 |
| 知识库结构 | 3 层(总览/域/服务)+ 2 类(自动/手工)+ 8 类自动文档 | meta.yaml 注册 + git_hash 检测 |
| 知识加载 | 渐进式 3 层(关键词→grep→按模式)+ 4 查询模式(PRD/方案/接口/问答) | 替代 RAG 的 4 个优势 |
| 文档保鲜 | git_hash 增量模式 + log.md 不可覆盖 + 人工批注保留 | “过期知识比没知识危险” |
| 状态文件 | 2 类 JSON(product-state / e2e-state)+ 3 个 hook(Stop/SessionStart/SessionEnd) | 流程可中断/可恢复/可观测 |
| 专家 Agent | 5 项原则(单一职责/上下文隔离/工具最小权限/确定性输入输出/模型可插拔) | 沉淀 12 个专家 |
| 并行编排 | Worktree 隔离(同需求多任务) + Fork-Join(多 Story) | DAG 拓扑分层 + worktree merge |
| 冲突治理 | 4 类(Merge/Shared file/Proto/DB&配置)+ 核心思路”事前隔离 + 串行收口” | 4 种策略 |
| 脚本化 | 15 个脚本(e2e-dev.py / worktree.sh / build-and-publish.sh / kb-init.sh) | “AI 负责认知,脚本负责执行” |
| DevOps 集成 | TAPD/Rick/123/七彩石/伽利略 MCP + Skill | tRPC-Gateway + Codar CR |
| 调度架构 | 弃主子 Agent / 弃 Shell 改 Go / 禁项目 Memory | 强类型控制流 |
| 核心原则 | 7 条(认知归 AI/长链路状态化/知识结构化/Agent 隔离/执行脚本化/Workflow > Prompt/工程系统思维) | 沉淀式抽象 |
| Vibe Coding 边界 | 看板类(结果导向+容错高)黑盒化;核心在线业务仍需人守架构 | With 平台 100% AI 看板案例 |
3 个反直觉点:① 不是”加规则”而是”分层独立演化”(知识自动生成 + 人工沉淀互不替代)② 不是”AI 越强越可靠”而是”AI 越强越要流程约束”(整套 Harness 设计都假设模型是概率的、会漂移的)③ 不是”Workflow 越复杂越好”而是”确定性归脚本,认知归 AI”(AI 写 Shell 脚本常潜藏语法错误,长链路末端才暴露)。
| 关联:Harness 主线 [[Harness工程AgentLoop]] / [[HarnessEngineering企业级实战]] / [[阿里云开发者-淘宝主播Agent的Harness工程实战]] / [[0xCodez-Agent-Harness-14-Steps]] / [[harness-engineering]] | 端到端 [[阿里妹-端到端业务需求专家Agent-4层架构8步流程]] / [[Hermes-Agent重构得物数仓工作流]] | Loop [[Loop-Engineering-验证才是瓶颈]] / [[Addy-Osmani-Loop-Engineering]] | 任务拆解 [[Leeka-Task-Decomposition-Agentic-Workflow]] | AI Coding 范式 [[Code-is-cheap-AI-Native-五倍效率]] / [[字节跳动洪定坤-AI-Coding的实践与探索]] | 多 Agent [[OpenClaw-vs-Hermes-多-Agent-架构设计]] / [[从零设计生产级-Multi-Agent-Harness]] |
| 备注:作者 zimingxing / kinglongli / yifhao 腾讯应用宝活动平台团队 | 仅覆盖 Go 后台业务 | 整套体系重度依赖 codebuddy cli | 团队自评”刚起步能跑,缺自进化/评估/工具解耦” | 7 条核心原则是沉淀式非实证 | 文末附 Mac 应用宝推广与正文无关 |