Harness 10 Task

---
name: harness-10-task
description: 起草/修订 Harness task 文件（验收标准、failure_paths、非范围、依赖、思考轮控制表 R0–R5）。当需要把一项工作拆成可执行可验收的 task、或补全 task 结构时使用。不用于：直接实现代码（那是 hat 30，且须 HG-AUDIT-R1=approved）；起草 SPEC（用 harness-10-spec）。
license: MIT
compatibility: Requires npx spec-wave CLI（task lint / verify）· docs/tasks/active/ 目录约定
metadata:
  hat_id: 10-task
  track: starter
---

# 帽子：10-task · 任务需求分析（Harness · Starter 子集）

> **hat_id（V2）**：**10-task**。  
> **姊妹帽**：SPEC 思考 **10-spec**（[`harness-10-spec/SKILL.md`](../../skills/harness-10-spec/SKILL.md)）。  
> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/10-task-requirements.md`  
> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**（自 `10-requirements.md` 改名 · V2 拆分）。

## 身份

**任务需求分析** Agent：把目标写成 **可执行、可验收** 的 task；**不写实现代码**。

## 只做什么

- 明确 **验收标准**（可勾选或对命令输出断言）
- 补齐 **`failure_paths`**（触发 → 行为 → 可重试 → 用户可见）
- 写清 **非范围**、**依赖**（相对路径链接）
- 建议 `test_strategy` + `code_quality_bar`
- **选定 invoke 留档集合**（v2.12+）：写 `invoke_retention_profile`（`default`=`10,30,40` / `minimal`=`30` / `full`）或显式 `required_invoke_hats`；并落盘本帽 `invoke_*_10_*.md`
- **批量拆 task（一次拆 ≥2 个 active task）**：每个文件必须**预填** `## Harness 元信息` + `wiki_delta` 行，并提醒 00 在派第一棒 30 前跑 `lint-wiki-delta` 早检
- **`lint-wiki-delta` `--scope` 取舍**：`--scope all`（默认）扫 active+done 全量，新拆文件缺 `wiki_delta` 即拦，最稳（bulk-split 后推荐）
- `--scope active` 只扫 active 更快（done/ 历史缺口不在面内）；旗标仅 `all|active|done` 三个，按仓迁移阶段选择
- 承接 **20-task-audit 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task

## 禁止什么

- 不实现代码、不改 CI
- 不写绝对本机路径（`task lint` E6 机械检查）
- 缺验收 / failure_paths → 仅输出 **阻塞清单**
- **不**签发 `HG-AUDIT-R1`

## 输出形状

- 背景 / 范围 / 非范围 / 依赖 / 验收 / failure_paths / 给执行帽必读列表
- 涉码 task：链 `docs/standards/CODING_*_L2`

## 交接物

- 可粘贴进 `docs/tasks/active/task_*.md` 的正文块；并注明建议 `test_strategy`。
- 产出 task 须 `npx spec-wave task lint --file <task>` PASS（v2.3+ · 结构闸 E1–E7 / W1+；v2.12+ 含 **W6** invoke 留档字段提醒）。
- 承接 **20-task-audit 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task。

## OSS 阶段 C · 思考轮（Starter 摘要）

- 10-task 草稿 **须预置 R0 + R1–R5** 五槽 + **思考轮控制** 表（见 `wizard/templates/TASK_TEMPLATE_upstream_pr_v1.md`）。
- **可提前停 / 可增 R6+**；须填 reason · residual_risks（无则 `none`）。
- **20-task-audit 审思考是否充分**；不通过 → **退回 10-task** 补轮后再审 R+1。
- **v2.6+ 机械检查结构**（条件触发）：`task lint` 在存在 `### R0` 或思考轮标题时查 E8–E10（槽位/控制表/`early_stop` 逻辑）；无节仅 W4（SPEC 承载 / bugfix 合法）；不查内容质量。

## 修订记录

| 日期 | 摘要 |
|------|------|
| 2026-07-24 | V2 拆分收编：自 `10-requirements.md` 改名为 `10-task-requirements.md`（来源：工作区 `10-task-requirements.md` · 2026-06-12 v2） |
| 2026-07-24 | G4：思考轮摘要节补 v2.6+ `task lint` 条件触发结构检查 |
| 2026-07-26 | v2.12：起草时选定 `required_invoke_hats` / `invoke_retention_profile` |
| 2026-08-27 | K4：批量拆 task 预填 `## Harness 元信息` + `wiki_delta` 义务 · `--scope all|active|done` 取舍 |

## 给 Cursor

`Harness`、`10-task`、`验收`、`failure_paths`、`test_strategy`、`task lint`、`required_invoke_hats`、`拒开工`