AI / CYY

AI 编码 Harness 模板

你开一个新项目，把这个模板追加到项目的 CLAUDE.md 里。之后每次跟 Claude 协作，它会自动按这个规矩来，同时要遵循全局级的CLAUDE.MD。

2026/7/6#Harness

五个角色，各管各的

让 AI 项目不乱的核心：写代码的人不能同时是检查代码的人。

角色	只做什么	不做什么
架构师	出设计文档	不写一行代码
开发者	按设计写代码	不改设计、不自测
测试员	写测试案例、跑测试	不修 bug，报告给开发者修
审查员	查架构合规	不改代码
调度员	路由任务、更新进度	不管业务

怎么协作：文件交接

每个角色干完活，把产出写进 phases/ 文件夹：

架构师 → phases/01-design.md
    ↓ 开发者读这个文件
开发者 → 代码 + phases/02-impl.md
    ↓ 测试员读这个文件
测试员 → phases/03-test.md
    ↓ 审查员读这个文件
审查员 → phases/04-review.md
    ↓ 调度员判断能否完成

不靠聊天记录交接——靠文件。每次新会话打开文件就知道做到哪了。

五道门禁

每步干完必须通过检查，不通过不许往下走：

门禁	检查什么	谁查
Gate 0	需求说清楚了吗？	架构师
Gate 1	设计文档完整吗？	调度员
Gate 2	代码能编译吗？	开发者
Gate 3	测试全过了吗？	测试员
Gate 4	架构违规了吗？	审查员

防三个经典翻车

翻车	怎么防
“帮我开发一个系统” — AI 一次想做太多	每次只做一个 feature。拆成独立小任务，做完一个再下一个
代码写完了就当完成了	五道门禁全过才算完成
AI 写的测试和 AI 写的代码有同样盲区	测试员和开发者不能同一个人

后端重点包括：服务可启动、配置可加载、接口返回格式统一、错误处理机制、日志规范、数据库连接与权限入口；前端重点包括：目录结构分层合理、组件命名与复用规范、请求封装统一、状态管理策略明确；

Harness思想： 1、任务分流、分布，避免死循环 2、任务满足要求才可输出 3、兜底机制 4、成长维护，保证agent健康运行

五个角色，各管各的

怎么协作：文件交接

五道门禁

防三个经典翻车

相关