Chachamaru127/claude-code-harness

# Claude Code Harness

规划。工作。审查。发布。
一个为 Claude Code 设计的严谨交付循环，并为 Codex 和 OpenCode 提供了有界路径。

English | 日本語

Claude Code 非常强大，但原生的 agent 工作模式容易产生偏差：计划停留在聊天中，测试变得可有可无，审查时机太晚，而发布证据只能靠记忆重新构建。Harness 将这些转化为一条可重复的运行路径。 安装后，默认行为将从“让 agent 去写代码”转变为： 1. 编写规格说明和计划， 2. 仅实现已批准的切片， 3. 验证结果， 4. 独立审查， 5. 为 PR 或发布打包证据。 ## 快速开始 新用户应从他们已在使用的工具开始。现有用户在进行清理或重新安装之前，应先运行迁移报告。 | 路径 | 起点 | |---|---| | 新用户 | [工具优先指南](docs/onboarding/index.md) | | 现有用户 | [迁移检查](docs/onboarding/migration.md) | | Claude Code 快速通道 | [30 秒安装](#install-in-30-seconds) | | 非工程师/术语帮助 | [通俗语言词汇表](docs/onboarding/glossary.md) | | 触发验证 | [技能触发门控](docs/onboarding/skill-trigger-acceptance.md) | ## 30 秒安装 ``` claude /plugin marketplace add Chachamaru127/claude-code-harness /plugin install claude-code-harness@claude-code-harness-marketplace /harness-setup ``` 下一条命令：带上一个小需求运行 `/harness-plan`。 ``` /harness-plan Improve the README onboarding flow ``` ## 头 15 分钟 1. 通过您的工具路径进行安装。 2. 运行 `/harness-setup` 或等效的设置脚本。 3. 带着一个小需求运行 `/harness-plan`；Harness 会为您编写 `spec.md` 和 `Plans.md` 草稿供检查。小的拼写错误、文档和状态更新保持轻量化。 4. 批准生成的契约，或回复您想要的修改。 5. 运行最小批准任务，例如 `/harness-work 1.1.1`。 6. 运行 `/harness-review` 并保留验证输出。 您的工作不是手写计划。您的任务是在执行继续之前，批准或更正生成的契约。 ## 工作原理 Harness 在 agent 工作流程周围添加了一个事实来源循环。 5 个动词技能保持了较小的接口面：plan（规划）、work（工作）、review（审查）、sync（同步）、release（发布）。 1. 您用自然语言描述期望的结果。 2. `/harness-plan` 起草或更新 `spec.md` 和 `Plans.md`，包含范围、验收标准、未知项和停止条件。 3. 非常规规划会记录 `team_validation_mode`，并通过团队/子 agent 或人工通过的视角验证计划，以确保 spec/Plans 对齐、memory 复用、产品契合度、安全契合度以及实际可用性。 4. Harness 将这些文件视为事实来源。agent 未见过的数据保持为 `unknown` 状态，而不是被默默虚构。 5. `/harness-work` 通过 TDD 和验证机制实现已批准的切片。 6. `/harness-review` 将审查与实现分离开来。 7. `/harness-release` 仅打包已验证的证据。 ## 命令 | 命令 | 内部执行内容 | |---------|---------------------| | `/harness-setup` | 安装项目指南、命令接口、hooks 和检查，使工作流从一个已知的基线开始。 | | `/harness-plan` | 将意图转化为 `spec.md` 和 `Plans.md`，包括范围、验收标准、依赖项、未知项、停止条件以及非常规规划验证。 | | `/harness-work` | 执行一个或一段已批准的任务，在需要时添加测试，运行验证，并将工作保持在计划范围内。 | | `/harness-work all` | 通过实现和审查路径运行已批准的计划；在计划明确且仓库基线已知后使用。 | | `/harness-review` | 独立于实现审查结果，并将主要发现视为阻塞项。 | | `/harness-release` | 在实现和审查完成后，检查发布就绪情况、CHANGELOG/tag 边界以及证据打包。 | | `bin/harness doctor --migration-report` | 清点旧的插件缓存、Codex 技能、OpenCode 文件、symlinks 和 memory 状态，而不删除数据。 | ## 基本工作流 | 阶段 | 产出 | 门控 | |-------|--------|------| | 调查 | 证据和未知项 | 不要将未观察到的数据提升为结论。 | | 计划 | `spec.md` + `Plans.md` | 用户批准或更正生成的契约。 | | 工作 | 代码和测试 | 任务要求时必须进行 TDD。 | | 审查 | 独立判定 | 主要发现会阻碍完成。 | | PR | 证据包 | PR 就绪并不等于发布就绪。 | | 发布 | Tag/release 制品 | 发布预检必须在发布路径上通过。 | ## 按工具安装 | 工具 | 等级 | 路径 | |---|---|---| | Claude Code | `supported` | Claude 插件市场，然后运行 `/harness-setup`。 | | Codex CLI | `internal-compatible` | `scripts/setup-codex.sh --user`；直接的插件冒烟测试单独跟踪。 | | Codex 应用 | `candidate` | 仅限候选冒烟测试；请勿复用 Codex CLI 的证明。 | | OpenCode | `internal-compatible` | `scripts/setup-opencode.sh`；不声称具备 runtime 对等性。 | | Cursor | `internal-compatible` | `scripts/setup-cursor.sh` real-directory 本地安装；最高支持等级仍受工作流冒烟测试门控。 | | GitHub Copilot CLI | `candidate` | 仅限手动配置研究。 | | Antigravity CLI | `future/unsupported` | 该阶段没有面向终端用户的安装路径。 | ## 现有用户迁移 在更改现有设置之前，请运行 `bin/harness doctor --migration-report`。 该报告会清点过时的 Claude 插件缓存、重复的 Codex 技能、旧的 symlinks、OpenCode 备份路径和 harness-mem 状态，且不会删除任何内容。 ## 支持边界 Harness 可以描述候选路径，但它不继承来自 Superpowers、Hermes Agent 或任何其他项目的支持声明。只有当 Harness 拥有自己的 bootstrap、trigger、runtime 和发布证据时，宿主的支持等级才会提升。 `not_observed != absent`：缺少本地证明意味着“此处未经验证”，而不是“不可能”，也不是“受支持”。 ## 要求 - 支持的 Claude 路径需要 Claude Code v2.1+。 - 需要一个具有写入权限的项目仓库进行本地设置。 - Go 原生护栏引擎不需要 Node.js。 - 可选的 [harness-mem](https://github.com/Chachamaru127/harness-mem) 用于在配置且健康的情况下提供跨会话的 memory。 ## 高级功能 在基本触发路径可见后使用这些功能。 | 功能 | 增加内容 | 边界 | |------------|--------------|----------| | Breezing | 针对更大任务列表的 Planner/Critic/Worker 风格团队执行。 | 仍受计划质量和审查门控。 | | Codex 配套审查 | 通过 `scripts/codex-companion.sh` 进行基于 schema 的 Codex 第二意见。 | 原始的 `codex exec` 不是 Harness 配套路径。 | | OpenCode bootstrap | 将 Harness 指南镜像到兼容 OpenCode 的接口。 | 不声称具备真实的 runtime 对等性。 | | harness-mem | 跨会话的项目级 memory 和回溯。 | 可选组件；清理仍需显式执行。 | ## 文档 | 资源 | 描述 | |----------|-------------| | [工具优先指南](docs/onboarding/index.md) | 按宿主工具划分的起点。 | | [安装路径](docs/onboarding/install.md) | 各工具的设置和支持等级边界。 | | [迁移检查](docs/onboarding/migration.md) | 现有用户影响、兼容性和回滚路径。 | | [通俗语言词汇表](docs/onboarding/glossary.md) | 为非工程师提供的 spec、contract、cc:* 标记、confidence % 等定义。 | | [技能触发门控](docs/onboarding/skill-trigger-acceptance.md) | 如何验证安装是否成功。 | | [能力矩阵](docs/tool-capability-matrix.md) | supported、internal-compatible、candidate 和 unsupported 宿主声明。 | | [Claude Code 兼容性](docs/CLAUDE_CODE_COMPATIBILITY.md) | 当前的 Claude Code 要求和兼容性说明。 | | [Cursor 集成](docs/CURSOR_INTEGRATION.md) | Cursor 交接边界和 internal-compatible 适配器说明。 | | [分发范围](docs/distribution-scope.md) | 包含 vs 兼容 vs 仅开发的路径。 | | [强化对等性](docs/hardening-parity.md) | Claude hooks 和 Codex gates 之间的 runtime 安全差异。 | | [Work All 证据包](docs/evidence/work-all.md) | 全计划执行的成功/失败验证契约。 | | [语言 / i18n](docs/i18n.md) | 如何切换输出语言（默认为英文，可选择日文）。 | | [更新日志](CHANGELOG.md) | 面向用户的版本历史。 | ## 鸣谢 - [AI Masao](https://note.com/masa_wunder) - 层次化技能设计 - [Beagle](https://github.com/beagleworks) - 测试篡改预防模式 ## 许可证 MIT 许可证。请参阅 [LICENSE.md](LICENSE.md)。

标签：AI编程助手, Go, Ruby工具, SOC Prime, 代码审查, 开发工具, 日志审计