Harness Engineering Starter：构建Agent协作规则的通用模板

Harness Engineering Starter是一个用于构建"仓库内Agent协作规则"的通用模板仓库，核心目标是帮助团队在真实项目中约束Agent的工作边界、执行路径和交付留痕。它提供文档骨架和路由系统，核心理念为"规则即接口"，通过明确协作契约解决Agent与人类团队协作的关键问题，实践中可解决上下文丢失、规则不一致、产物难追溯三大痛点。

随着AI Agent在软件开发中从"辅助工具"转向"协作成员"，如何让Agent有效可控工作成为新问题。人类开发者可通过会议、文档同步认知，但Agent需要明确规则定义工作边界、执行路径和交付标准。Harness Engineering Starter为此设计，不提供具体技术栈或编码规范，而是文档骨架和路由系统，帮助团队建立Agent协作规则。

模板设计哲学为"规则即接口"——文档规则定义人类与Agent的协作契约，如同API定义系统交互契约。关键原则包括：1.模板不等于事实，仅描述应定义内容；2.占位符需项目确认后使用；3.分层管理项目事实、领域规则、生成产物；4.按需裁剪，保留匹配内容，删除不适用部分。

模板提供分层文档架构，各层职责明确：

1. AGENTS.md：仓库级入口规则，Agent进入仓库的第一站，定义基本行为准则、入口路由和全局约束；
2. docs/WORKFLOW.md：执行路径选择，Agent操作手册（如分支创建、PR提交、代码审查标准）；
3. docs/ARCHITECTURE.md：系统结构事实，Agent执行任务前需阅读以确保改动符合架构；
4. docs/guides/：通用流程与模板（如API文档编写、代码审查流程）；
5. docs/project/：项目硬约束（技术栈、兼容性要求、业务背景等）；
6. docs/rules/：领域规则（API设计、数据访问、异常处理等）；
7. docs/tasks/：具体任务描述与临时文档；
8. docs/generated/：Agent生成产物，与人工文档区分； 另有参考资料层（docs/references/）和模板层（docs/templates/）支持查阅。

模板作为起点，使用步骤如下： 1.替换核心入口文件：修改AGENTS.md、docs/WORKFLOW.md、docs/ARCHITECTURE.md反映真实项目； 2.补齐项目硬约束：补充技术栈、兼容边界、业务背景、核心术语及领域事实文档； 3.下沉领域规则：稳定约束下沉到docs/guides/（流程）、docs/rules/（领域）、.agents/skills/（自动化流程）； 4.裁剪不适用部分：删除或替换无关模板内容，保持精简聚焦。

模板解决Agent协作三大痛点： 1.上下文丢失：强制Agent行动前阅读AGENTS.md和ARCHITECTURE.md，确保具备必要上下文； 2.规则不一致：通过WORKFLOW.md和guides标准化流程，确保Agent遵循一致规则； 3.产物难追溯：分层架构与generated目录约定，使Agent生成产物可追溯、可审查。

模板明确界定适用范围： 不是：固定标准答案、通用规范、替代真实项目事实的占位仓库； 是：模板骨架、可裁剪路由系统、共享上下文规则入口。 未来展望：随着Agent角色重要性提升，这类模板将演变为丰富生态系统（不同技术栈、团队规模、业务领域的最佳实践变体），模板提供最小可行起点，帮助团队立即实践Agent协作。