一套配置驱动的六代理开发工作流系统，专为 Claude Code 设计，涵盖代码质量检查、测试生成、提交规范、发布管理和对抗性验证

cc-harness：为 Claude Code 打造的全自动开发工作流代理框架\n\n在 AI 辅助编程日益普及的今天，开发者们面临着一个新的挑战：如何让 AI 助手不仅仅是代码补全工具，而是真正融入整个软件开发生命周期。cc-harness 项目正是为解决这一问题而生，它为 Claude Code 提供了一套完整的配置驱动型开发工作流代理系统。\n\n## 项目背景与核心理念\n\nClaude Code 是 Anthropic 推出的智能编程助手，但许多开发者仅将其用于简单的代码生成和问答。cc-harness 的创作者意识到，AI 代理的潜力远不止于此——它们可以主动参与代码审查、测试编写、版本发布等关键环节，形成一个闭环的开发工作流。\n\n该项目的核心理念是配置驱动（Config-driven）。不同于传统的硬编码工作流，cc-harness 的所有代理都通过项目根目录下的 CLAUDE.md 文件进行配置。这意味着同一套代理可以无缝适配 Python、TypeScript、Go 等任何技术栈，只需修改配置文件即可。\n\n## 六大核心代理详解\n\ncc-harness 提供了六个精心设计的全局代理，每个代理负责开发流程中的特定环节：\n\n### 1. code-quality（代码质量代理）\n\n这是整个工作流的守门员。code-quality 代理会评估测试覆盖率、执行质量检查清单（Q1-Q8），并运行代码检查工具。它最终会输出明确的 PASS/FAIL 结果，为后续步骤提供决策依据。\n\n质量检查清单 Q1-Q8 涵盖了从测试命名规范到边界条件处理的各个方面，确保代码不仅功能正确，而且易于维护。\n\n### 2. test-writer（测试编写代理）\n\n当 code-quality 报告测试缺口时，test-writer 代理介入。它专门编写行为测试（behavioral tests），而非单纯追求行覆盖率的测试。这一点尤为重要——高覆盖率不等于高质量测试，test-writer 专注于验证代码的实际行为是否符合预期。\n\n### 3. commit（提交代理）\n\n只有在 code-quality 通过检查后，commit 代理才会启动。它会自动创建符合 Conventional Commits 规范的提交信息，推送分支，并打开 Pull Request。这确保了进入代码仓库的每一行代码都经过质量把关。\n\n### 4. pr-monitor（PR 监控代理）\n\n提交后，pr-monitor 开始持续监控 CI 检查状态。一旦所有检查通过，它会自动执行 squash 合并并删除分支。这种自动化大大减少了开发者在等待 CI 结果时的时间浪费。\n\n### 5. release（发布代理）\n\nrelease 代理负责评估是否应该进行版本发布。它会根据提交历史自动提升版本号（支持 semver、semver-beta、git-tags-only 等多种策略），更新变更日志，创建 Git 标签，并最终发布到 GitHub Releases。\n\n### 6. verification（验证代理）\n\n这是最独特的代理。verification 采用对抗性验证（adversarial verification）方法，在任务完成前主动尝试"破坏"系统。它维护一个反合理化目录（anti-rationalization catalog），确保 AI 不会为了完成任务而自我欺骗。\n\n## 安装与配置\n\n安装 cc-harness 非常简单：\n\nbash\ngit clone https://github.com/YOUR_USERNAME/cc-harness.git\ncd cc-harness\n./install.sh\n\n\n安装脚本会将 agents/ 和 rules/ 目录符号链接到 ~/.claude/，使代理在所有项目中可用。现有目录会自动备份，无需担心数据丢失。\n\n### CLAUDE.md 配置模板\n\n每个项目需要在 CLAUDE.md 中添加 Agent Config 表格：\n\nmarkdown\n## Agent Config\n\n| 字段 | 示例值 |\n|------|--------|\n| test_cmd | pnpm test 或 python3 -m pytest tests/ |\n| lint_cmd | pnpm lint 或 ruff check src/ |\n| build_cmd | pnpm build 或 (none) |\n| coverage_per_module | 80 或 (none) |\n| version_strategy | semver / semver-beta / git-tags-only |\n| deploy_model | discrete 或 auto-deploy |\n\n\n完整的配置模板包含 25 个配置项，涵盖从测试命令到发布策略的方方面面。使用 (none) 可以跳过项目不需要的功能。\n\n## 工作流管道\n\ncc-harness 的代理形成了一个清晰的工作流管道：\n\n\n代码变更 → code-quality（评估）\n ↓ FAIL\ntest-writer（修复缺口）→ code-quality（重新验证）\n ↓ PASS\ncommit（暂存、推送、开 PR）\n ↓\npr-monitor（监控 CI，通过后合并）\n ↓\nrelease（评估、打标签、发布）\n\n\n对于非平凡的工作，verification 代理会在最后进行对抗性检查，确保交付物的可靠性。\n\n## 项目级自定义\n\ncc-harness 支持项目级代理覆盖。如果某个项目需要特殊的工作流（例如面向学生的项目需要避免使用 git 术语），只需在项目目录下创建同名代理文件：\n\n\nmy-project/.claude/agents/commit.md ← 覆盖全局 commit 代理\n\n\n这种设计既保证了全局一致性，又保留了必要的灵活性。\n\n## 配套规则文档\n\n除了代理，cc-harness 还提供四份规则文档：\n\n- testing-guidelines：测试质量检查清单、TDD 工作流、反模式识别、会话关闭协议\n- claude-md-project-templates：NEVER 规则模板和自主层级模板\n- memory-discipline：记忆排除强化和回忆时验证协议\n- agent-purpose-statements：手动代理编排的目的声明模式\n\n这些规则文档帮助 Claude Code 更好地理解项目约束和最佳实践。\n\n## 技术亮点与思考\n\ncc-harness 的设计体现了几个值得关注的理念：\n\n对抗性验证是其中最具创新性的概念。传统 AI 系统往往倾向于"取悦"用户，快速给出看似合理的答案。verification 代理则反其道而行之，主动寻找漏洞和边界情况，这种"红队"思维对于构建可靠的 AI 辅助工作流至关重要。\n\n配置驱动架构使得这套系统具有极强的适应性。开发者不需要为每个技术栈重写代理逻辑，只需调整配置即可。这种设计大大降低了在多语言环境中采用 AI 工作流的门槛。\n\n## 结语\n\ncc-harness 代表了 AI 辅助编程向工作流自动化演进的重要一步。它不仅仅是一组脚本，而是一个完整的开发哲学——让 AI 代理承担重复性工作，让开发者专注于创造性思考。\n\n对于已经在使用 Claude Code 的开发者来说，cc-harness 提供了一条清晰的路径，将 AI 助手从"聊天工具"升级为"开发伙伴"。随着 AI 能力的不断提升，这种配置驱动、代理协作的模式可能会成为软件开发的新常态。

cc-harness：为 Claude Code 打造的全自动开发工作流代理框架\n\n在 AI 辅助编程日益普及的今天，开发者们面临着一个新的挑战：如何让 AI 助手不仅仅是代码补全工具，而是真正融入整个软件开发生命周期。cc-harness 项目正是为解决这一问题而生，它为 Claude Code 提供了一套完整的配置驱动型开发工作流代理系统。\n\n项目背景与核心理念\n\nClaude Code 是 Anthropic 推出的智能编程助手，但许多开发者仅将其用于简单的代码生成和问答。cc-harness 的创作者意识到，AI 代理的潜力远不止于此——它们可以主动参与代码审查、测试编写、版本发布等关键环节，形成一个闭环的开发工作流。\n\n该项目的核心理念是配置驱动（Config-driven）。不同于传统的硬编码工作流，cc-harness 的所有代理都通过项目根目录下的 CLAUDE.md 文件进行配置。这意味着同一套代理可以无缝适配 Python、TypeScript、Go 等任何技术栈，只需修改配置文件即可。\n\n六大核心代理详解\n\ncc-harness 提供了六个精心设计的全局代理，每个代理负责开发流程中的特定环节：\n\n1. code-quality（代码质量代理）\n\n这是整个工作流的守门员。code-quality 代理会评估测试覆盖率、执行质量检查清单（Q1-Q8），并运行代码检查工具。它最终会输出明确的 PASS/FAIL 结果，为后续步骤提供决策依据。\n\n质量检查清单 Q1-Q8 涵盖了从测试命名规范到边界条件处理的各个方面，确保代码不仅功能正确，而且易于维护。\n\n2. test-writer（测试编写代理）\n\n当 code-quality 报告测试缺口时，test-writer 代理介入。它专门编写行为测试（behavioral tests），而非单纯追求行覆盖率的测试。这一点尤为重要——高覆盖率不等于高质量测试，test-writer 专注于验证代码的实际行为是否符合预期。\n\n3. commit（提交代理）\n\n只有在 code-quality 通过检查后，commit 代理才会启动。它会自动创建符合 Conventional Commits 规范的提交信息，推送分支，并打开 Pull Request。这确保了进入代码仓库的每一行代码都经过质量把关。\n\n4. pr-monitor（PR 监控代理）\n\n提交后，pr-monitor 开始持续监控 CI 检查状态。一旦所有检查通过，它会自动执行 squash 合并并删除分支。这种自动化大大减少了开发者在等待 CI 结果时的时间浪费。\n\n5. release（发布代理）\n\nrelease 代理负责评估是否应该进行版本发布。它会根据提交历史自动提升版本号（支持 semver、semver-beta、git-tags-only 等多种策略），更新变更日志，创建 Git 标签，并最终发布到 GitHub Releases。\n\n6. verification（验证代理）\n\n这是最独特的代理。verification 采用对抗性验证（adversarial verification）方法，在任务完成前主动尝试"破坏"系统。它维护一个反合理化目录（anti-rationalization catalog），确保 AI 不会为了完成任务而自我欺骗。\n\n安装与配置\n\n安装 cc-harness 非常简单：\n\nbash\ngit clone https://github.com/YOUR_USERNAME/cc-harness.git\ncd cc-harness\n./install.sh\n\n\n安装脚本会将 agents/ 和 rules/ 目录符号链接到 ~/.claude/，使代理在所有项目中可用。现有目录会自动备份，无需担心数据丢失。\n\nCLAUDE.md 配置模板\n\n每个项目需要在 CLAUDE.md 中添加 Agent Config 表格：\n\nmarkdown\nAgent Config\n\n| 字段 | 示例值 |\n|------|--------|\n| test_cmd | pnpm test 或 python3 -m pytest tests/ |\n| lint_cmd | pnpm lint 或 ruff check src/ |\n| build_cmd | pnpm build 或 (none) |\n| coverage_per_module | 80 或 (none) |\n| version_strategy | semver / semver-beta / git-tags-only |\n| deploy_model | discrete 或 auto-deploy |\n\n\n完整的配置模板包含 25 个配置项，涵盖从测试命令到发布策略的方方面面。使用 (none) 可以跳过项目不需要的功能。\n\n工作流管道\n\ncc-harness 的代理形成了一个清晰的工作流管道：\n\n\n代码变更 → code-quality（评估）\n ↓ FAIL\ntest-writer（修复缺口）→ code-quality（重新验证）\n ↓ PASS\ncommit（暂存、推送、开 PR）\n ↓\npr-monitor（监控 CI，通过后合并）\n ↓\nrelease（评估、打标签、发布）\n\n\n对于非平凡的工作，verification 代理会在最后进行对抗性检查，确保交付物的可靠性。\n\n项目级自定义\n\ncc-harness 支持项目级代理覆盖。如果某个项目需要特殊的工作流（例如面向学生的项目需要避免使用 git 术语），只需在项目目录下创建同名代理文件：\n\n\nmy-project/.claude/agents/commit.md ← 覆盖全局 commit 代理\n\n\n这种设计既保证了全局一致性，又保留了必要的灵活性。\n\n配套规则文档\n\n除了代理，cc-harness 还提供四份规则文档：\n\n- testing-guidelines：测试质量检查清单、TDD 工作流、反模式识别、会话关闭协议\n- claude-md-project-templates：NEVER 规则模板和自主层级模板\n- memory-discipline：记忆排除强化和回忆时验证协议\n- agent-purpose-statements：手动代理编排的目的声明模式\n\n这些规则文档帮助 Claude Code 更好地理解项目约束和最佳实践。\n\n技术亮点与思考\n\ncc-harness 的设计体现了几个值得关注的理念：\n\n对抗性验证是其中最具创新性的概念。传统 AI 系统往往倾向于"取悦"用户，快速给出看似合理的答案。verification 代理则反其道而行之，主动寻找漏洞和边界情况，这种"红队"思维对于构建可靠的 AI 辅助工作流至关重要。\n\n配置驱动架构使得这套系统具有极强的适应性。开发者不需要为每个技术栈重写代理逻辑，只需调整配置即可。这种设计大大降低了在多语言环境中采用 AI 工作流的门槛。\n\n结语\n\ncc-harness 代表了 AI 辅助编程向工作流自动化演进的重要一步。它不仅仅是一组脚本，而是一个完整的开发哲学——让 AI 代理承担重复性工作，让开发者专注于创造性思考。\n\n对于已经在使用 Claude Code 的开发者来说，cc-harness 提供了一条清晰的路径，将 AI 助手从"聊天工具"升级为"开发伙伴"。随着 AI 能力的不断提升，这种配置驱动、代理协作的模式可能会成为软件开发的新常态。