技术实践

淘天以本地文件和Git构建Price360项目Harness

智能体系统上下文与知识应用与实践上下文工程知识库Agent HarnessAgent Skills编程

概述

淘天团队提出“Agent = Model + Harness,模型之外都是 Harness”,并进一步得到“业务研发 Agent = Model + Coding Agent 通用 Harness + 项目 Harness”。Price360-KB 不是独立研发平台,而是可被 Coding Agent 直接打开执行的 Git 工作空间:AGENTS.md 作项目协作协议与总入口,定义事实源、研发阶段、人工决策点、授权边界和完成条件;.agents/skills 是可组合领域能力,覆盖 PRD、技术方案、测试设计、回放、排障、知识归档;.agents/scripts 负责工作区检查、产物格式校验、状态同步、提交推送与发布后回查等确定性门禁;另有 iterations/、wiki/、tech/、raw/、src/、olap/、briefs/、outputs/ 等目录,以及 repositories.json 声明关联仓库、skill-dependencies.json 声明公共 Skill 依赖版本。稳定性 = Git 保存长期上下文,Aone 状态、测试环境、日志、数据库、配置中心等动态事实仍从权威系统实时查询,两者在 Agent 执行时汇合。Harness 演进路径真实可考:多需求并行污染目录后增加工作区隔离;接口成功却无法证明异步链路完成后增加可观测性契约;外部状态提前更新造成不一致后把发布改成合并后回查。 团队认定业务 AI 研发的上限由上下文而非模型能力决定。为使更新路径最短、避免知识与代码漂移,优先选择文件 Wiki:代码、文档、测试与索引可进入同一个 MR 一起评审、合并后共享同一版本。冷启动阶段用 Git submodule 把相关代码仓关联到 src/、把历史人工文档关联到 raw/,并设计清洗 SKILL 从代码与凌乱资料中清洗出结构化知识;对于只存在人脑海中的知识,设计采访稿并用钉钉 AI 听记采访核心开发/产品,再把采访原稿交 Coding Agent 整理入库。知识分两类:wiki 面向产品、运营、测试和 Agent,存业务概念、规则、口径、角色、流程与异常处理;tech 存代码无法独立表达但会影响 Agent 判断的上下文(跨系统链路、接口数据关系、新旧链路切换、废弃状态、运行态拓扑、观测方式)。每份知识文件由正文 + Metadata(title/category/tags/status/version/source)+ 相对路径链接 + Git 版本构成,source 字段标明事实来源;知识生成统一经过项目 Skill 补齐标签来源索引,并定期健康检查处理重复、冲突、失效链接与无来源结论。 每个需求有独立迭代目录,保存 prd.md、solution.md、test/design.md、test/cases*.md、test/report.md、archive.md,这些文件是阶段之间的接口而非交付后总结。PRD 用 REQ 与 AC 描述需求与验收标准,技术方案把它们映射到实现任务与可观测点,测试设计再用 TC 建立覆盖关系;状态、版本、依赖与证据采用固定字段格式,使 Agent 可以自查“某个验收标准是否有方案承接、是否有测试覆盖、用例是否仍对应当前方案版本”。流程按“需求 → PRD → 技术方案 → 测试设计 → 代码 → 预发验证 → 发布归档”推进且阶段不可自动越过:PRD 未确认不写技术方案,方案和测试设计未确认不进入代码实现,没有真实测试证据不进入发布准备,上游实质变化则下游产物必须更新、旧证据不得沿用。测试须绑定当前分支对应的真实环境,验证返回值、日志、调用链或数据库结果,并把 traceId、执行时间与断言结果回填到测试资产;无法取得稳定证据的场景保留为人工验证,不得包装成自动化通过。