一句话总结：Harness Suite 是基于 OpenSpec + Superpowers 理念，专门为 Claude Code 打造的 AI 辅助研发工作流框架。它给 Claude Code 装上了一套"需求→设计→开发→评审→归档"的标准流程。

什么是 Harness Suite？

如果你之前听过 OpenSpec（规范层）和 Superpowers（技能层），那 Harness Suite 就是把这两者完美结合的产物。

核心公式：

OpenSpec（规范层） + Superpowers（技能层） → Harness（编排层）

Harness Suite 是一个开源项目（MIT 协议），专门为 Claude Code 设计，把 AI 辅助开发从"自由发挥"变成了"标准化流程"。

GitHub 地址：github.com/windchargerKang/my-harness-suite

三层架构解析

OpenSpec（规范层）—— 定规则

OpenSpec 回答一个问题：系统和外部世界之间用什么语言交流？

它定义了：

• 系统有哪些能力接口
• 每个接口的输入输出格式
• 错误处理标准
• 版本兼容性

在 Harness Suite 中的体现：

• openspec/changes/<change-id>/proposal.md —— 需求提案
• openspec/changes/<change-id>/design.md —— 技术方案
• openspec/changes/<change-id>/tasks.md —— 执行任务

这些文件构成了"变更工件"，任何开发都必须基于明确的规范，不允许随意发挥。

Superpowers（技能层）—— 出能力

Superpowers 回答一个问题：系统实际能做什么？

每个 Superpower 是一个独立的技能模块，可插拔、可替换：

关键特征：

• 模块化：每个技能独立开发、独立升级
• 可插拔：可以装、可以卸、可以替换
• 符合规范：每个技能都遵守 OpenSpec 定义的接口

Harness（编排层）—— 做指挥

Harness 回答一个问题：这些技能怎么配合完成复杂任务？

它是大脑和指挥系统，负责：

• 理解用户意图
• 拆解任务步骤
• 按顺序调用合适的技能
• 处理流程分支和异常
• 把结果组装成最终输出

完整工作流（6 个阶段）

Harness Suite 把研发流程标准化为 6 个阶段：

1. Propose（提需求）

/harness-propose "用户登录功能"

生成 proposal.md（需求文档），明确要做什么。

核心原则：没有 OpenSpec change，不允许直接开始开发。

2. Plan（战略设计）

/harness-plan user-login-20260409-01

调用 superpowers:brainstorming 进行深度设计探索，生成：

• design.md —— 技术方案
• tasks.md —— 执行任务分解

3. Apply（开发实现）

/harness-apply user-login-20260409-01

按 tasks.md 逐条执行，有里程碑检查。只允许实现 tasks.md 中明确列出的内容，不允许超出范围自行扩展。

4. Review（并行评审）

/harness-review user-login-20260409-01

同时执行多个评审技能：

• superpowers:receive-code-review —— 代码质量审查
• prepare-review —— 变更摘要
• spring-architecture-review —— Spring 架构评审
• sql-risk-review —— SQL 风险评估

5. Archive（归档）

/harness-archive user-login-20260409-01

把完成的变更归档到 openspec/changes/archive/，形成完整的历史记录。

6. Knowledge（知识管理）

/harness-knowledge              # 查看所有知识
/harness-knowledge add          # 添加新知识
/harness-knowledge clean        # 清理过时知识

在 apply 和 review 阶段会自动捕获隐性知识，也支持手动添加。

三个核心规约文件

这三个文件定义了 Claude Code 在项目中的行为边界，不是靠 AI 自觉，而是硬约束。

Hooks 硬约束

Harness Suite 把安全检查写进了 Claude Code 的 hooks 系统：

编辑代码前 → guard_write.py（写保护）
执行命令前 → ensure_change_context.py（确保有变更上下文）
编辑代码后 → run_checks.sh（编译检查）

目的：防止 AI 乱改文件、越权操作。这和我们的会议管理系统设计思路完全一致——规则在前，执行在后。

目录结构

harness-suite/
├── setup/                      # 初始化入口
│   └── SKILL.md
├── workflow/                   # 工作流 Skills
│   ├── propose/                # 创建需求
│   ├── plan/                   # 战略设计 + 任务分解
│   ├── apply/                  # 执行实现
│   ├── review/                 # 并行评审
│   └── archive/                # 归档
├── review-skills/              # 专项评审
│   ├── prepare-review/         # 变更摘要
│   ├── spring-architecture-review/
│   └── sql-risk-review/
├── agents/
│   └── reviewer.md             # 评审代理
├── hooks/                      # 安全钩子
│   ├── guard_write.py          # 写保护
│   ├── ensure_change_context.py
│   └── run_checks.sh           # 编译检查
├── docs_template/              # 文档模板
├── AGENTS.md                   # 代理行为规范
├── CLAUDE.md                   # 技术规约
└── REVIEW.md                   # 评审标准

安装和使用

一键安装

git clone --branch main --depth 1 \
  "https://github.com/windchargerKang/my-harness-suite" \
  ".harness-suite-tmp" && \
  bash ".harness-suite-tmp/install.sh" --target "$(pwd)" && \
  rm -rf ".harness-suite-tmp"

初始化

# 在项目根目录执行
/harness-setup

这将创建完整的规约骨架，并自动探索项目背景（技术栈、目录结构、现有文档等）。

适合谁用？

✅ 推荐场景

1. 用 Claude Code 做开发的团队：希望流程规范化，不是让 AI 自由发挥
2. Java/Spring Boot 项目：内置了 Spring 架构评审和 SQL 风险评估
3. 多人协作：需要评审机制和变更追踪的项目
4. 重视代码质量：有硬约束，不是靠自觉

⚠️ 需要注意

1. 偏 Java 生态：Spring 架构评审为主，其他语言支持有限
2. 依赖 Claude Code：需要 Claude Code 的 skills 机制
3. 流程较重：个人小项目可能觉得过度设计

我的看法

Harness Suite 最值得学习的是它的设计理念：

规则在前，执行在后。

它把"AI 辅助开发"从"让 AI 随便写"变成了"AI 在规则内发挥"。这和会议管理系统的 Pre-meeting note 理念完全一致——准备度决定主动权，规范度决定质量上限。

三个亮点：

1. Hooks 硬约束：不是靠 AI 自觉，是系统级拦截
2. 知识自动沉淀：越用越有价值，隐性知识不丢失
3. 评审标准化：降低代码审查的主观性

如果你用 Claude Code 做开发，或者你的团队在用 AI 辅助编程，Harness Suite 值得研究一下。

GitHub 地址：github.com/windchargerKang/my-harness-suite 协议：MIT