coding-agent-harness

分类: 开发与编程 | 上传者: FairladyZ625 | 下载: 0 | 版本: v1.0（最新）

Coding Agent Harness 工程方法论。为使用 Coding Agent（Codex、Claude Code、Gemini CLI 等） 做长程项目开发的团队，在用户的项目上构建一套完整的 harness 工程体系。 包括：项目诊断、AGENTS.md + CLAUDE.md 入口文件生成、docs/ 目录搭建、Planning Loop、SSoT 治理、 Delivery Operating Model、Repository Governance、CI/CD、Long-Running Task Protocol、Adversarial Review Report、Review Routing、Worktree 并行开发、 Regression SSoT 与 Evidence Depth 分级回归、Walkthrough / Closeout SSoT 收口、Cadence Ledger、任务本地 lesson 候选与 promoted lesson 详情文档、 Harness Ledger 全局上下文回写总账。 当用户要求设置 coding agent 的开发流程、建立回归测试体系、设计 AGENTS.md / CLAUDE.md、 规划长程 agent 任务的执行框架、子代理审查循环、对抗性 review 报告、搭建 harness、或者提到 harness engineering 时，使用此技能。 也适用于"帮我搭一套 agent 开发规范"、"怎么让 AI 在长任务上不跑偏"、 "怎么做 agent 的回归测试"、"帮我初始化项目的 harness"等场景。 --- # Coding Agent Harness 工程方法论 一套经过真实项目验证的方法论，用于在任意项目上构建 Coding Agent 的工程化支撑体系。 ## 核心理念 - **文档是写给 Agent 看的，不是写给人看的。** 人看排期表、架构文档和执行 output。Agent 看 task_plan、walkthrough、reference 标准。 - **上下文不是越多越好，是越准越好。** AGENTS.md 做目录不做百科；CLAUDE.md 只做 Claude Code 兼容 shim，不做第二份规范。 - **单元测试只是底线，不是保障。** 真正的保障需要多层证据（Evidence Depth）。 - **先识别交付组织，再设计 harness。** 一人多 agent、多人团队、前后端分仓、program 多仓、敏捷/瀑布，对应的 SSoT 和冲突治理不同。 - **Repo 护栏是地基。** CI/CD、PR policy、branch protection、required checks、worktree concurrency 必须项目级定制，不能停留在模板。 - **外部资料先摄取，再投影。** 微服务或多仓项目的外部文档不能直接塞进执行文档；先建 source pack、digest、验证，再投影到 `03/04/06`。 - **长程任务先设计合同，再开放执行。** 连续跑数小时的前提是 Goal、Scope、Review Loop、Evidence、Stop Condition 都清楚。 - **审查必须落盘。** 对抗性 review 是独立交付物，不应只留在对话、progress 或 walkthrough 里；reviewer 必须用 Confidence Challenge 反复挑战方案，直到没有 open material finding。 - **Worker handoff 必须 commit-backed。** 可写 subagent 不是 reviewer；它必须在独立 worktree / branch 内实现、验证并提交，再由 coordinator 集成。 - **严肃项目用顶级模型。** 便宜模型的返工成本远高于差价。 - **强制流程优于口头约定。** 每个步骤都应该是 agent 可自主执行的。 --- ## 主执行 SOP 如果用户要求"更新 harness"、"同步最新版 harness"、"把项目升级到最新 coding-agent-harness"，不要重新 bootstrap 覆盖整个项目。先执行增量更新流程： 1. 读取本 Skill 的最新版 `SKILL.md`、相关 `references/`、`templates/`。 2. 扫描目标项目现有 `AGENTS.md`、`CLAUDE.md`、`docs/` 和 SSoT / Ledger 文件。 3. 输出 delta plan：哪些 harness 骨架、reference、template、SSoT、L

更新日志: Source: GitHub https://github.com/FairladyZ625/coding-agent-harness