每次新建项目或打开已有项目时，都需要反复告诉 AI 同样的规则：技术栈是什么、测试怎么跑、哪些文件不能动。

Harness Starter 把这些重复劳动固化为 Hook 自动化机制。装一次，所有项目通用。

在 Claude Code 中输入：

帮我用 Harness Starter 初始化这个项目

AI 会：

1. 从 GitHub 拉取模板文件
2. 检测项目技术栈，填写 CLAUDE.md
3. 安装对应的 Language Server
4. 运行健康检查确认一切就绪

npx harness-starter              # 安装到当前目录
npx harness-starter /path/to/proj  # 安装到指定目录

然后 Claude Code 中输入 帮我初始化 Harness 完成配置。

# 复制模板文件
cp -r .claude/ CLAUDE.md .lsp.json /path/to/your-project/

# 在 Claude Code 中完成初始化
# 输入：帮我初始化 Harness

一条对话的生命周期中，Hook 按以下顺序自动触发：

flowchart LR
  A[PreToolUse] --> B[工具调用]
  C[PostToolUse] --> B
  B --> D[响应]
  D --> E[Stop]
  E --> F[SessionStart<br/>下次对话]
  G[PreCompact] -.->|压缩前| D

🔧 进阶：GC Agent（L4 自治） — 内置 scripts/gc-scan.mjs + harness-gc Skill，定时扫描项目健康状态。详见 CLAUDE.md 的 Loop Engineering 章节。新手可忽略。

在 Claude Code 中直接说：

帮我用 Harness Starter 初始化这个项目

AI 会自动完成全流程：

1. 拉取模板：从 GitHub 克隆最新版本
2. 复制文件：将 .claude/、CLAUDE.md、.lsp.json 复制到项目
3. 检测技术栈：读取 package.json / pyproject.toml / go.mod 等
4. 填写配置：替换 CLAUDE.md 占位符，安装 Language Server
5. 验证：运行 node scripts/check.mjs 确认一切就绪

如果文件已在项目中，直接说「帮我初始化 Harness」即可。

完整的初始化流程定义在 .claude/skills/harness-init/SKILL.md 中。

如果希望手动操作：

# 1. 克隆模板
git clone https://github.com/<your-org>/Harness-Starter.git /tmp/harness

# 2. 复制到项目
cp -r /tmp/harness/.claude/  /path/to/your-project/.claude/
cp    /tmp/harness/CLAUDE.md /path/to/your-project/CLAUDE.md
cp    /tmp/harness/.lsp.json /path/to/your-project/.lsp.json

# 3. 安装语言服务
npm install -g typescript-language-server   # TypeScript
pip install pyright                         # Python

# 4. 验证
cd /path/to/your-project && node scripts/check.mjs

# 5. 在 Claude Code 中完成初始化
# 输入：帮我初始化 Harness

your-project/
├── CLAUDE.md                   AI 行为规则
├── .lsp.json                   LSP 配置
├── package.json                npm 分发
├── scripts/
│   ├── check.mjs               安装健康检查
│   ├── init.mjs                一键安装
│   └── upgrade.mjs             升级同步
│
├── .claude/
│   ├── settings.json           Hook 注册
│   ├── .harness-state          阶段/模式感知
│   ├── skills/
│   │   ├── harness-init/       AI 安装向导
│   │   └── harness-mode/       工作流模式
│   └── hooks/
│       ├── pre-tool-check.mjs  安全拦截
│       ├── post-tool-check.mjs 自动格式化
│       ├── session-context.mjs 上下文注入
│       ├── session-review.mjs  变更审查
│       └── pre-compact.mjs     长会话保护
│
├── .github/
│   └── workflows/
│       └── harness-check.yml   CI 检查

.lsp.json 默认为 TypeScript。其他语言：

// Python
{ "python": { "command": "pyright-langserver", "args": ["--stdio"], "extensionToLanguage": { ".py": "python" } } }

// Go
{ "go": { "command": "gopls", "args": [], "extensionToLanguage": { ".go": "go" } } }

以下功能默认不开启，需要时按需解锁。

Harness 支持三种工作模式，自动调整审查严格度：

三种阶段也会影响行为：

当前状态由 .claude/.harness-state 驱动，SessionStart 自动注入。完整说明见 .claude/skills/harness-mode/SKILL.md。

将 Stop Hook 的审查结果接入自动化评估，跟踪 AI 输出质量趋势：

• 在审查报告中增加正确性评分
• 记录每次改动的缺陷率
• 建立质量基线，低于阈值时告警

进阶功能，新手可跳过。

Harness Starter 内置了 GC（Garbage Collection）Agent，用于定期扫描项目健康状态。

• 扫描脚本：scripts/gc-scan.mjs（纯 Node.js，8 个维度）
• 触发方式：node scripts/gc-scan.mjs 或 /loop 24h "node scripts/gc-scan.mjs"
• 数据持久化：.claude/loops/STATE.md + LOG.md
• 完整说明见 .claude/skills/harness-gc/SKILL.md

复杂任务可以拆分为多个 Agent 分工协作。适用场景：

• 同时探索多个方案并对比结果
• 前端/后端/测试分离并行
• 长期运行的任务与主会话隔离

cp -r .claude/ CLAUDE.md .lsp.json /path/to/new-project/

修改 CLAUDE.md 前三行，重新安装 language server，即可在新项目中使用。