# ClaudeCode Harness Setup Assistant：九阶段构建完整Claude Code工具链

> 这是一个专为Claude Code设计的元工具插件，通过九阶段编排工作流为项目构建完整的工具链（harness），包括CLAUDE.md、设置、规则、代理、剧本和钩子。它解决了开发者在每个新项目重复配置Claude Code的痛点，通过自动化扫描和交互式访谈生成经过验证的工具配置。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-22T11:44:52.000Z
- 最近活动: 2026-04-22T11:58:27.891Z
- 热度: 148.8
- 关键词: Claude Code, 工具链, AI代理, 插件, 工作流, 自动化配置, 开发工具
- 页面链接: https://www.zingnex.cn/forum/thread/claudecode-harness-setup-assistant-claude-code
- Canonical: https://www.zingnex.cn/forum/thread/claudecode-harness-setup-assistant-claude-code
- Markdown 来源: ingested_event

---

# ClaudeCode Harness Setup Assistant：九阶段构建完整Claude Code工具链

## 从重复劳动到自动化工具链

对于使用Claude Code的开发者来说，每个新项目开始时的配置工作既熟悉又繁琐："需要哪些规则？""权限应该开放到什么程度？""需要哪些钩子？""这个项目需要代理团队还是单一技能就够了？"这些问题在每个项目都要重新回答，导致大量时间浪费在重复的配置工作上。

ClaudeCode Harness Setup Assistant（内部代号harness-architect）正是为解决这一痛点而生。它是一个元工具插件，通过九阶段编排工作流，自动扫描项目、进行必要的交互式访谈，然后逐步构建完整的Claude Code工具链——包括CLAUDE.md、设置文件、规则、代理定义、剧本、钩子和MCP配置。

## 什么是"工具链"（Harness）

在Claude Code生态中，"工具链"（harness）指的是围绕核心AI功能构建的一整套支持系统。一个完整的工具链包括：

- **CLAUDE.md**：Claude理解项目的基础文档
- **.claude/settings.json**：权限、环境变量、钩子、MCP配置
- **.claude/rules/**：始终应用的规则
- **.claude/agents/**：代理定义（适用于代理项目）
- **.claude/skills/**：可复用的技能
- **docs/{request-name}/**：设计产出物（参考用）

与简单的代理团队配置不同，完整工具链涵盖了从项目理解到执行监控的全方位支持。

## 九阶段编排工作流

harness-architect的核心是其精心设计的九阶段工作流，每个阶段都有明确的输入、输出和负责代理：

| 阶段 | 内容 | 负责代理 |
|------|------|---------|
| 0 | 目标项目路径收集 + 请求名生成 + 基本性能级别提示收集 | （编排器） |
| 1-2 | 扫描 + 访谈 + 基础工具链 | phase-setup |
| 2.5 | 领域研究（可选） | phase-domain-research |
| 3 | 工作流设计 | phase-workflow |
| 4 | 管道设计 | phase-pipeline |
| 5 | 代理团队编排 + 模型层级矩阵分配 | phase-team |
| 6 | SKILL/剧本编写 | phase-skills |
| 6+ | 模型确认门——代理-模型-技能整合表格最终确认 | （编排器） |
| 7-8 | 钩子/MCP安装 | phase-hooks |
| 9 | 最终验证 | phase-validate |
| 每阶段 | 独立批评审查 | red-team-advisor |

这种分阶段设计允许会话在中断后从任意阶段自动恢复，所有中间产出都保存在docs/{request-name}/目录中。

## 三种执行模式

插件支持三种不同的执行模式，适应不同复杂度的项目：

**fresh-setup**：全新项目工具链配置，完整执行所有九阶段。

**cursor-migration**：将Cursor IDE设置迁移到Claude Code，处理配置转换和兼容性问题。

**harness-audit**：诊断和改进现有的Claude Code设置，识别配置缺陷和优化机会。

## 领域特定研究

当项目的核心领域被识别后（如深度研究、网站制作、网络漫画、YouTube内容、代码审查、技术文档、数据管道、营销活动、前端设计等），阶段1-2升级会触发领域研究代理（phase-domain-research）。

该代理会：

1. 查询knowledge/domains/下的精选知识库（9种，6种完整+3种存根）
2. 使用WebSearch/WebFetch收集该领域的标准工作流、角色分工、工具栈、反模式
3. 将研究结果保存到docs/{request-name}/02b-domain-research.md

后续阶段3-6的剧本在有此产出时会自动读取并引用领域参考。所有外部主张强制要求来源URL+摘录日期，顾问会抽样验证URL。

如果用户输入包含"不适用"、空白、--fast、"快速"等关键词，阶段2.5自动跳过，直接进入阶段3。

## 前端设计专项支持

对于React/Vue/Svelte + Tailwind等UI层中心项目，阶段1-2升级会在用户确认后自动注入前端设计专用配置：

- **frontend-designer + frontend-ux-reviewer代理对**：所有生成工作必须经过8维度（D1-D8）审查
- **自包含色彩规则**：OKLCH、APCA Lc≥60、WCAG AA、双层token、60-30-10配色、色盲友好，无需外部技能
- **生成-审查配对强制**：3轮升级阶梯（1轮自动重做→2轮用户3选1→3轮中止）
- **所有权保护**：注入的预设文件在阶段5·6及轻量轨道中禁止重写覆盖

## 严格六步编码工作流

.claude/templates/workflows/strict-coding-6step/目录包含严格的六步编码工作流预设（8个代理+8个剧本）：

1. 研究
2. 问题起草
3. 设计·红队
4. 实现·计划
5. 实现
6. 白盒/黑盒QA

该预设自动复制到相应类型项目中。

## 编排器路由协议

生成的工具链的CLAUDE.md自动包含编排器路由协议，根据用户请求规模（S/M/L）指导主会话是直接处理还是走完整管道。需要代码确认时，主会话不直接Read，而是先调用code-researcher代理——这一原则已帮助避免实测18美元以上的不必要成本超支。

## 安装与使用

### 通过GitHub托管市场安装

```bash
# 1) 插件市场注册（只需一次）
/plugin marketplace add leee880619-commits/ClaudeCode-Harness-Setup-Assistant

# 2) 安装插件
/plugin install harness-architect@harness-architect-marketplace
```

### 本地开发安装

```bash
git clone https://github.com/leee880619-commits/ClaudeCode-Harness-Setup-Assistant
cd ClaudeCode-Harness-Setup-Assistant
claude --plugin-dir .
```

### 运行工具链构建

```bash
cd /path/to/your/project
claude

# 会话内执行
/harness-architect:harness-setup

# 或预指定路径（跳过阶段0的项目路径询问）
/harness-architect:harness-setup /path/to/your/project
```

## 预计耗时

根据项目类型不同，构建时间有所差异：

| 项目类型 | 路径 | 预计耗时 |
|---------|------|---------|
| 个人Web应用·CLI（自动判定） | 轻量轨道阶段L | 25-35分钟 |
| 个人Web应用·CLI（--fast指定） | 快速轨道 | 10-15分钟 |
| 团队Web应用 | 标准 | 20-45分钟 |
| 代理管道 | 快速前进 | 30-40分钟 |

（实际时间取决于用户响应速度和项目复杂度）

## 运营审计功能

工具链构建完成后，可以运行运营审计：

```bash
/harness-architect:ops-audit
```

从运行时·运营角度审计5个维度（会话连续性、失败恢复、代理-技能双重管理、产出物版本控制、跨工作流结构重复），以RISK-HIGH/MED/LOW等级输出评估结果。此命令只读，不修改文件。

## 安全与防护机制

插件内置多层安全防护：

**目标项目工作期保护**：插件自身文件不会被修改（ownership-guard.sh钩子通过PreToolUse(Write|Edit)拦截）

**危险模式拦截**：Bash(*)、sudo rm *等危险模式在插件默认设置中被建议拦截

**密钥隔离**：API密钥·token通过settings.local.json（gitignored）引导存储

**元泄漏防护**：生成文件不包含该插件自身规则或Claude Code架构描述，通过meta-leakage-guard规则和检查清单验证

## 与revfactory/harness的对比

| 特性 | harness-architect（本插件） | revfactory/harness |
|------|---------------------------|-------------------|
| 范围 | 完整工具链（设置/规则/代理/剧本/钩子/MCP） | 代理/技能团队中心 |
| 输入 | 项目路径扫描 + 交互式访谈 | 用户叙述式请求 |
| 工作流 | 9阶段编排 + 阶段门 + 恢复 | 单一会话6阶段 |
| 设计审查 | 红队顾问（每阶段独立批评）+ 管道审查门自动注入 | 无内置 |
| 核心模式 | 代理-剧本分离（WHO/HOW）、纯编排器 | 用户主导设计 |

定位差异：revfactory/harness适合快速创建代理/技能团队；harness-architect适合构建可恢复、可验证的完整工具链。

## 局限与注意事项

**非自动更新**：插件不会自动更新。获取新版本需要执行：

```bash
# 1) 刷新市场缓存
/plugin marketplace update harness-architect-marketplace

# 2) 打开插件管理TUI
/plugin update
```

**资源需求**：完整工具链构建需要一定的计算资源和时间投入，不适合极其简单的项目。

**学习曲线**：理解九阶段工作流和各代理职责需要一定学习成本。

## 结语

ClaudeCode Harness Setup Assistant代表了AI辅助开发工具向专业化、系统化方向的演进。它不再满足于简单的代码生成，而是着眼于构建完整的AI-人类协作基础设施。

对于频繁使用Claude Code的开发者，这个插件可以显著降低项目启动的认知负担，确保每个项目都有经过验证的、一致的配置基础。九阶段工作流虽然看似复杂，但这种结构化的方法正是处理复杂软件项目所需要的。

随着AI编程助手从新奇玩具转变为严肃开发工具，像harness-architect这样的基础设施项目将变得越来越重要。它们不仅提高了效率，更重要的是建立了可重复、可验证、可维护的最佳实践。