企业官网建设流程全解析

如何在 Cursor 上使用 Claude Code Harness：安装、校验、运行三步走指南

【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness

Claude Code Harness 是一个为 AI 编程代理打造的"计划→执行→评审"自主交付循环工具，它也能装进 Cursor，让 Cursor 成为默认实现后端。本文用"安装、校验、运行"三步带你快速上手：一条脚本完成安装，三条命令完成校验，再在 Cursor 里跑通 plan→work→review 的完整循环，全程不需要手动改配置文件。

为什么要在 Cursor 上用 Harness：一条纪律化的交付闭环

用 AI 写代码最常见的坑是：计划写在聊天记录里消失了、测试赶工期被跳过、评审在合并之后才发生。Claude Code Harness 的思路不是让模型更聪明，而是把流程和边界固定下来：写规格 → 只实现已批准的部分 → 验证 → 独立评审 → 打包证据。

它围绕 5 个核心动词组织工作，每个阶段都会留下下一阶段需要的材料：

更关键的是安全层：每一次工具调用在运行前都会经过一个 Go 引擎裁决，账单、网络出站、密钥读取、生产部署这类高危操作是硬性拒绝的，任何配置都无法绕过（详见 docs/CURSOR_INTEGRATION.md）。

第一步·安装：一条命令把 Harness 装进 Cursor

Cursor 的安装通道已经通过官方验证，支持等级为supported。整个安装只需两步：

1. 克隆仓库（如果还没有本地副本）：

   git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness cd claude-code-harness

2. 执行官方安装脚本：

   bash scripts/setup-cursor.sh

scripts/setup-cursor.sh 会自动完成三件事：构建 Cursor 专用插件包、校验包内容（清单、技能、运行辅助脚本齐全）、把插件真实拷贝到~/.cursor/plugins/local/claude-code-harness。装完后按提示执行Developer: Reload Window重载 Cursor，技能和代理就会生效。

两点说明：

• 脚本使用真实目录拷贝而不是软链接，因为 Cursor 会拒绝外部符号链接目标；如果之前装过旧版，脚本会自动备份到~/.harness-skill-cleanup-archive/。
• 仓库中的 .cursor-plugin/plugin.json 是插件清单，安装时版本会与 VERSION 文件自动对齐，无需手动维护。

第二步·校验：3 条命令确认环境就绪

装完不要急着开跑，花 1 分钟做校验，能避免后面 90% 的"技能没触发"问题：

2.1 校验安装包本身

bash scripts/setup-cursor.sh --check

加--check参数表示只构建并验证 Cursor 包，不执行安装。它会检查插件清单不含非法路径、核心技能完整、运行时辅助脚本齐全，全部通过会输出setup-cursor --check passed。

2.2 校验适配器契约

bash tests/test-cursor-adapter-candidate.sh

这个测试会逐项断言 Cursor 集成所需的文件与契约：插件清单、.cursor/AGENTS.md 引导路由、worker/reviewer/advisor 三个代理定义、模型路由脚本可执行等（源码见 tests/test-cursor-adapter-candidate.sh）。

2.3 校验 cursor-agent 可用性

在 Cursor 中调用cursor:setup --check技能（定义见 skills/cursor-setup/SKILL.md），它会依次确认：当前解析出的实现后端、Cursor 包就绪状态、以及cursor-agent命令行工具能否找到并打印版本。技能只报告这三个事实，不会擅自改动任何设置——分布默认的 fallback 始终是claude，只有你明确请求时才会改本地环境。

第三步·运行：设 Cursor 为默认后端，跑通循环

3.1 设置默认实现后端

确认无误后，二选一：

• 仅当前项目生效：在 Cursor 中调用cursor:setup --project-default，等价于bash scripts/set-impl-backend.sh cursor（写入项目根的env.local）
• 全部项目生效：调用cursor:setup --user-default（写入~/.config/claude-harness/impl-backend.env）

设置是幂等的：同值不重复写，换值原地替换。想撤销时用cursor:setup --unset。随时可以用 scripts/set-impl-backend.sh 的--show参数查看当前生效的后端，或用 scripts/resolve-impl-backend.sh 按角色解析最终结果。

3.2 在 Cursor 里驱动计划-执行-评审循环

后端就绪后，Cursor 就是 Harness 的"执行侧"：

• 项目根目录的 Plans.md 是唯一的共享事实源。推荐分工：Cursor 负责计划、评审签核与发布判断（PM 侧），Harness 负责实现与本地验证。
• 在 Cursor 中按 docs/CURSOR_INTEGRATION.md 的推荐流程操作：用 templates/cursor/commands/ 下的命令模板创建和细化Plans.md，再调用harness-plan、harness-work、harness-review技能推进任务。
• 双方通过Plans.md中的状态标记协作（如pm:依頼中/cc:TODO/cc:WIP/cc:完了/pm:確認済），Cursor 只拥有 PM 标记，执行侧只拥有 worker 标记，避免双方同时编辑同一个任务块。

3.3 开工前的 5 项健康检查

文档要求共享会话开始前确认：两个工具指向同一个 git 分支；两个工具都能看见同一份Plans.md；实现请求里写明了验收标准和预期验证命令；PM 侧清楚发布是否在范围内；对 Cursor 的支持表述始终包含"harness 侧隔离"的限定（完整清单见 docs/CURSOR_INTEGRATION.md 的Minimum Sanity Check一节）。

边界与注意事项：读懂"supported"的含义

• 隔离在 harness 侧，不在 Cursor 沙箱里。cursor-agent没有类似--sandbox的文件系统监狱，文件写入不被硬性限制。真正的边界由 harness 提供：独立 worktree 隔离、Lead 差异评审、R01–R13 策略引擎，以及.cursorignore的密钥读取屏蔽。
• 不使用绕过模式。Harness 的 Cursor 工作流从不使用--force/ "Run Everything"。
• 不要夸大对齐程度。官方明确不建议声称 Cursor 与 Claude 完全一致的沙箱隔离或工具能力对齐，各宿主的能力差异见 docs/hardening-parity.md 与 docs/known-limitations.md。
• 执行侧同一问题失败 3 次就停下升级，而不是继续扩大回退逻辑。

小结

三步走回顾：bash scripts/setup-cursor.sh完成安装；--check与适配器测试完成校验；cursor:setup技能把 Cursor 设为默认后端后即可在 Cursor 内跑通"计划→执行→评审"循环。各工具的安装路线与支持等级对照，可查阅 docs/onboarding/install.md 与 README.md 的Install by tool表格。

【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness