Menu
一键将 harness-lab 治理框架接入到当前项目。支持模块选择、冲突检测、PreToolUse hook 配置和 CLI 安装回退。适用于已有项目快速接入治理框架。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | source-command-harness-setup |
| description | 一键将 harness-lab 治理框架接入到当前项目。支持模块选择、冲突检测、PreToolUse hook 配置和 CLI 安装回退。适用于已有项目快速接入治理框架。 |
Use this skill when the user asks to run the migrated source command harness-setup.
将 harness-lab 治理框架接入到当前 Git 项目，并让安装结果与当前仓库的真实治理契约一致。
Git 仓库检测
.git/git init现有治理文件检测
AGENTS.md, CLAUDE.md, requirements/, .claude/progress.txt在目标项目中运行：
node /path/to/harness-lab/scripts/harness-install.mjs --defaults
node /path/to/harness-lab/scripts/harness-install.mjs --defaults --dry-run
如果目标项目的 package.json 在子目录（例如 app/package.json），仍在 Git 根目录运行安装器，并显式指定脚本绑定位置：
node /path/to/harness-lab/scripts/harness-install.mjs --defaults --package-dir app
包含治理 hooks：
node /path/to/harness-lab/scripts/harness-install.mjs --defaults --with-hook
如果 harness-lab 以 npm 包形式安装，package.json 暴露 harness-install bin 后，也可以使用：
npx harness-install --defaults
npx harness-install --defaults --dry-run
npx harness-install --defaults --package-dir app
npx harness-install --defaults --with-hook
核心模块（必须安装）：
AGENTS.md - 治理规则主入口CLAUDE.md - 会话入口协议requirements/ - REQ 生命周期管理.claude/progress.txt - 跨会话进度交接默认模块：
| 模块 | 说明 | 默认 |
|---|---|---|
docs/ | 设计稿和规范目录 | yes |
context/ | 业务/技术/经验索引 | yes |
skills/ 与 .agents/skills/source-command-* | 阶段导航技能、Claude Code source-command skills（含 worktree-req） | yes |
| CLI 脚本 | req-cli.mjs, req-audit.mjs, governance-health.mjs, req-validation.mjs, error-classifier.mjs, event-store.mjs, worktree-utils.mjs, docs-verify.mjs, check-governance.mjs, docs-sync-rules.json, template-guard.mjs | yes |
| 治理 hooks | .claude/settings.example.json, scripts/session-start.js, scripts/req-check.js, scripts/scope-guard.mjs, 本地 hook 配置 | no，需 --with-hook |
源目录
--source /path/to/harness-lab 显式指定冲突处理
初始化配置
requirements/ 目录结构--clean-template-history 下清理带模板标记的历史文件.claude/progress.txtrequirements/reports/harness-setup-report.md配置 hooks（如果选择）
.claude/settings.local.jsonSessionStart + PreToolUse 的 command hooksPreToolUse 为硬阻断：无活跃 REQ、空模板 REQ、draft REQ 或 REQ scope 越界时拒绝 Write/Edit绑定目标项目命令
lint / test / build，自动复用这些脚本verify 缺失，按已有真实脚本自动组合可行的 npm run lint && npm run test && npm run build 子集node scripts/template-guard.mjs <name> placeholder guardreq:*, docs:*, check:governance, governance:health 等治理脚本req:complete / docs:verify / check:governance 使用 git-status-backed 命令，读取 .claude/.xxx-statuspackage.json--package-dir app 或 --package-json app/package.json 绑定子目录 package；治理文件仍安装在当前 Git 项目根目录node scripts/req-cli.mjs fallback 和候选 package 建议安装完成后，优先检查：
requirements/reports/harness-setup-report.mdpackage.json 中自动绑定的脚本.claude/settings.local.json（仅启用 hooks 时）下一步：
npm run req:create -- --title "Your first requirement"
如果没有可绑定的 package.json，使用：
node scripts/req-cli.mjs create --title "Your first requirement"
然后补齐 REQ 的真实背景、目标、验收标准，再执行：
npm run req:start -- --id REQ-YYYY-NNN --phase implementation
req:create 只会生成骨架，不代表 REQ 已可直接实施source-command-worktree-req.claude/.req-exempt 临时豁免，完成后应删除test:unit、check、build:prod 等非标准脚本语义npx harness-install 依赖包分发时暴露 bin，本地开发时优先使用 node scripts/harness-install.mjswatchdog、risk-tracker、测试、CI 和 .claude/commands/ 不在默认安装清单中创建 bugfix 型 REQ，通过 req:create --type bugfix 自动填充特化内容。
创建 feature 型 REQ，通过 req:create --type feature 自动填充特化内容。
创建 refactor 型 REQ，通过 req:create --type refactor 自动填充特化内容。
为 Claude Code 用户通过 claude --worktree 或手动 git worktree 启动并行 REQ。适用于已有活跃 REQ 时需要另开一条独立工作线。
交互式首个 REQ 向导，引导新用户在 5 分钟内创建第一个 REQ。自动识别项目类型，推荐模板字段。