Harness-ZH · Claude Code 简体中文元技能

Harness-ZH · 智能体团队与技能架构师（简体中文版）

简体中文 | English

一款面向 Claude Code 的元技能（meta-skill）：用一句话需求，就能为你的领域或项目自动生成一支多智能体团队，并一同产出团队所需的技能（skills）、编排协议与质量守护机制。

基于 revfactory/harness 原版（韩/英/日）的简体中文生产级重构版，并在 QA 与测试方法上补齐了时序一致性与对抗性测试两个维度。

---

✨ 核心能力

• 6 阶段工作流（Phase 0–7）：审计 → 领域分析 → 架构设计 → Agent 定义 → Skill 生成 → 集成编排 → 验证测试 → 运维维护
• 6 种架构模式：Pipeline / Fan-out·Fan-in / Expert Pool / Producer-Reviewer / Supervisor / Hierarchical Delegation
• 3 种执行模式：Agent Teams（默认）/ Subagents / Hybrid
• 5 维 QA：集成一致性、时序一致性、功能规范、设计质量、代码质量
• 对抗性测试：输入残缺 / 格式异常 / 矛盾指令 / 多义表达 4 类扰动，暴露 silent failure
• 分级模型策略：默认 opus，低复杂度任务可降级 sonnet
• Progressive Disclosure：主文件精简，参考文档按需加载，最小化上下文成本

🚀 安装

方式一：作为 Claude Code 插件安装（推荐）

# 1) 添加 marketplace
/plugin marketplace add nilecui/harness-zh-release

# 2) 安装插件
/plugin install harness-zh@harness-zh

方式二：作为全局 Skill 安装

git clone https://github.com/nilecui/harness-zh-release.git
cp -r harness-zh/skills/harness-zh ~/.claude/skills/harness-zh

方式三：项目级安装

# 在你的项目根目录
mkdir -p .claude/skills
cp -r /path/to/harness-zh/skills/harness-zh .claude/skills/

🎯 使用

安装完成后，在 Claude Code 中直接用自然语言触发，无需任何 / 指令：

给这个项目搭一个 harness
构建多 agent 协作体系
设计一个数据管道的 agent 团队
Build a harness for full-stack website development ...

详见 docs/USE_CASES.md 中的 8 个开箱即用场景（深度研究 / 全栈开发 / 代码评审 / 技术文档 / 数据管道 / 营销活动 / 网漫制作 / YouTube 策划）。

📁 仓库结构

harness-zh/
├── .claude-plugin/
│   ├── plugin.json           # Claude Code 插件清单
│   └── marketplace.json      # Marketplace 入口
├── skills/
│   └── harness-zh/
│       ├── SKILL.md          # 主技能（Phase 0–7 工作流）
│       └── references/       # 按需加载的 6 份参考文档
│           ├── agent-design-patterns.md
│           ├── orchestrator-template.md
│           ├── team-examples.md
│           ├── skill-writing-guide.md
│           ├── skill-testing-guide.md
│           └── qa-agent-guide.md
├── docs/
│   ├── USE_CASES.md          # 8 个场景详解
│   └── ARCHITECTURE.md       # 架构与设计理念
├── .github/                  # Issue/PR 模板与 CI
├── CHANGELOG.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── LICENSE                   # Apache-2.0
└── README.md

📊 生成物

在目标项目中触发后会生成：

your-project/
├── .claude/
│   ├── agents/               # Agent 定义（每个角色一份 .md）
│   └── skills/               # 团队使用的 skills
└── CLAUDE.md                 # 自动注册的 trigger 指针

🔄 与上游版本的关系

项	本仓库（harness-zh v2.0.0）	上游 revfactory/harness
语言	简体中文	韩文/英文/日文
Skill 名	harness-zh	harness
模型策略	默认 opus，允许 sonnet 分级	固定 opus
QA 维度	5 维（含时序一致性）	4 维
测试方法	A/B + 对抗性变体	A/B
领域示例	Web + 数据管道	Next.js 主导
触发短语	6 类（含泛化 agent 表达）	5 类

两者可并存安装（skill 名不同），按会话语言选其一即可。

🤝 贡献

欢迎提交 Issue 与 PR。提交前请阅读：

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md

📝 变更历史

见 CHANGELOG.md。

📜 许可证

Apache License 2.0 · 继承自上游 revfactory/harness。

🙏 致谢

• 上游作者 @revfactory 提供的原版元技能设计
• Anthropic Claude Code 团队