# 快速开始

## 1. 安装

```shell
# 推荐：通过 Claude Code 插件市场
/plugin marketplace add nilecui/harness-zh-release
/plugin install harness-zh@harness-zh
```

## 2. 第一次运行

进入任意项目目录，启动 Claude Code：

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

粘贴触发短语（任选其一，**无需 `/` 前缀**）：

```
给这个项目搭一个 harness
```

```
为全栈开发设计一个 agent 团队
```

```
Build a harness for deep research ...
```

## 3. 会话节奏

Harness-ZH 会按 Phase 推进，**每个 Phase 结束时都向你确认**，不会默默改文件：

1. **Phase 0 审计** — 汇报项目中是否已有 agents/skills，询问是新建/扩展/运维。
2. **Phase 1–2 方案** — 输出领域分析 + 执行模式 + 架构模式建议。**此时审阅并修改**。
3. **Phase 3–4 产物** — 生成 `.claude/agents/*.md` 与 `.claude/skills/*/`。
4. **Phase 5–6 编排 + 验证** — 注册 trigger 指针、跑 dry-run + A/B。

## 4. 用刚造好的团队

Phase 6 结束后，直接用自然语言描述真实任务：

```
开始构建博客网站：首页、文章列表、后台管理……
```

Claude Code 会依据 `CLAUDE.md` 里的 trigger 指针自动激活刚生成的团队，**依然不需要 `/` 指令**。

## 5. 常见命令

| 意图 | 说话方式 |
|---|---|
| 查看现状 | `harness 点检` / `帮我审计一下现有 harness` |
| 新增一个 agent | `给现有 harness 增加一个 translator agent` |
| 只修 skill | `帮我更新 analyze skill，加上 ETag 校验` |
| 强制用中文产出 | `请将所有 agents 与 skills 以中文撰写` |
| 只用 subagent 模式 | `这次用 Subagents 模式，不要开团` |

## 6. 升级与卸载

```shell
# 升级
/plugin install harness-zh@harness-zh --upgrade

# 卸载
/plugin uninstall harness-zh
```

项目级安装（未通过市场）则直接删除 `.claude/skills/harness-zh/` 目录。