用途:为单个 Git 仓库在 Claude Code 会话中建立一套可自我校验、可度量的检查体系。核心是 scripts/check.sh 作为统一入口,按三个档位回答“这次改动是否合格”,并让 Claude Code hooks 在每次编辑和每次停止时执行快速档位,pre-commit 运行器守住提交。流程为探索、呈现、确认、写入、证明。
主要能力:探测仓库所用技术栈与工具,仅在缺少的角色上补齐默认工具;沿用仓库已有工具与配置,不改弱配置。确定 pre-commit 运行器并接好未联通的配置。写入固定路径的契约文件:scripts/check.sh、.claude/hooks/check-hook.sh、.claude/hooks/cloud-setup.sh、docs/agents/harness.md。项目级配置提交到 .claude/settings.json,机器相关项写入 .claude/settings.local.json。所有新增依赖先经安装检查(版本、来源、发行方)再安装。
使用方式:以 /setup-harness 运行。前置条件包括 Git 仓库且有被跟踪文件、远端为 GitHub 或 Azure DevOps、PATH 中有 curl 与 python3、工作区干净(否则 git stash -u),并检查 Claude Code 版本下限;CLAUDE_CODE_REMOTE=true 时跳过该检查。已有 docs/agents/harness.md 视为重跑并生成差距报告。写入前需人工一次性确认,确认后按顺序安装、写运行器、写 scripts/check.sh、计时、写入 hooks、写文档与 CLAUDE.md 块;最后用 git add --intent-to-add :/ 后运行 scripts/check.sh full,再 git reset --quiet。
适用场景:GitHub 或 Azure DevOps 上的单仓库,希望在本地或云会话中给 Claude Code 提供快速自检反馈。
限制:路径被 hooks 与重跑读取,必须严格按约定路径写入;不确认不写入,未通过安装检查不安装第三方内容;云相关证明、语言服务器、计费与价格等信息资料未提供。