# 快速上手

5 分钟带你跑通第一个自动化任务。

## 理解 Harness 工作模式

Harness 有三种工作模式：

| 模式 | 命令 | 用途 |
|------|------|------|
| **Dry Run** | `--dry-run` | 验证流水线配置，不调 LLM |
| **单次执行** | 默认 | 执行一个任务然后退出 |
| **持续循环** | `--continuous` | 7×24 自主取任务执行 |

## 5 分钟体验

### Step 1: 健康检查 (30s)

确保环境正常：

```bash
python -m skills.harness_healthcheck
```

预期看到 8 项检查全部 ✅：

```
[HARNESS-HEALTHCHECK] 开始系统健康检查...
  [1/8] Python 环境 ............. ✅ OK (Python 3.12.3)
  [2/8] 依赖完整性 .............. ✅ OK (45/45)
  [3/8] 配置文件 ................ ✅ OK
  [4/8] 目录结构 ................ ✅ OK
  [5/8] Git 状态 ................ ✅ OK
  [6/8] 测试覆盖率 .............. ✅ OK (82%)
  [7/8] 知识图谱 ................ ✅ OK
  [8/8] 飞书连通性 .............. ✅ OK
```

### Step 2: Dry Run (1min)

走完整流水线但不调用 LLM，验证集成：

```bash
python harness_run.py --dry-run \
  --task "写一个 hello world 函数" \
  --project test_project
```

预期输出：

```
[STEP-0] 初始化上下文 .................. [DRY-RUN] ✓
[STEP-1] 加载项目上下文 ............... [DRY-RUN] ✓
[STEP-2] 查询知识图谱 ................. [DRY-RUN] ✓
[STEP-3] Skill 分发 ................... [DRY-RUN] ✓
[STEP-4] Prompt 生成 .................. [DRY-RUN] ✓
[STEP-5] 任务执行 ..................... [DRY-RUN] ✓
[STEP-6] 结果验证 ..................... [DRY-RUN] ✓
[STEP-7] 知识更新 ..................... [DRY-RUN] ✓
```

### Step 3: 真跑第一个任务 (2min)

```bash
python harness_run.py \
  --task "创建一个 FastAPI 健康检查端点，返回 {'status':'ok'}" \
  --project my_service \
  --executor opencode
```

Harness 会自动完成：

1. 📋 **分析需求** → 识别为后端 API 开发任务
2. 🎯 **匹配合适 Skill** → 注入 backend-test-runner
3. 📝 **生成精细 prompt** → 包含 FastAPI 最佳实践
4. 💻 **调用执行器写代码** → OpenCode 生成完整代码
5. 🧪 **运行测试验证** → pytest 自动执行
6. 📊 **更新知识图谱** → 增量写入新节点

### Step 4: 查看结果 (30s)

```bash
# 查看生成的文件
ls harness-output/my_service/

# 查看任务报告
cat reports/latest_task_report.md

# 查看更新的知识
cat harness-context.md
```

## 持续开发模式

让 Harness 7×24 自主取任务执行：

```bash
python scripts/autonomous_driver.py \
  --continuous \
  --poll-interval 1800 \
  --project D:/project/aicoding/my_project
```

参数说明：

| 参数 | 默认值 | 说明 |
|------|--------|------|
| `--continuous` | - | 持续循环模式 |
| `--poll-interval` | 1800 | 队列轮询间隔（秒） |
| `--project` | cwd | 目标项目路径 |
| `--executor` | claude | 默认执行器 |

它会自动：
1. 轮询 `task_queue.json` 中的待处理任务
2. Claim → Execute → Verify → Reflect → Evolve
3. 队列为空时休眠，有新任务自动唤醒

## 任务队列格式

Harness 从 `task_queue.json` 读取任务：

```json
{
  "tasks": [
    {
      "id": "task-001",
      "title": "添加用户登录 API",
      "description": "使用 FastAPI 实现 JWT 登录端点",
      "priority": "high",
      "project": "user_auth",
      "skills": ["backend-api", "auth"],
      "spec": "specs/login-api.md"
    }
  ]
}
```

## 下一步

- 📖 [配置说明](configuration.md) — 深入定制 Harness
- 🏗️ [架构概览](../architecture/overview.md) — 理解完整系统
- 🛠️ [Skill 总览](../skills/overview.md) — 探索可用 Skills
- 💻 [开发环境搭建](../development/setup.md) — 参与开发