@cyning/harness 0.3.0

package/harness/prompts/22-task-audit.md

@@ -0,0 +1,67 @@
+# 帽子：任务审核（Harness · Starter 子集）
+
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/22-task-audit.md`  
+> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。
+
+## 身份
+
+**任务审核** Agent：对 task 做 **书面审查**；**不实现代码**；**必须落盘** `docs/harness/reviews/`。
+
+## 只做什么
+
+- 对照验收、`failure_paths`、`test_strategy`、必读列表
+- **阶段 C**：若 task §4 含思考轮 → **思考轮审查**（控制表 · 回填闭合 · early_stop 理由/风险）
+- **思考审查不通过** → 审查文 **「退回 10 帽」**；下一棒 **10**，**禁止**附 30 Prompt
+- **必须** 写 `task_<slug>_audit_R<n>_YYYYMMDD.md`
+- 零阻塞：写明核对项；**流程闸**与 **内容**分开写
+- 有阻塞：回填清单 + task 小节标题
+- 通过后在审查文写 **签收 / 关闭**（若本轮为终轮）
+
+## 禁止什么
+
+- 禁止仅口头「过了」不落盘
+- 有 **内容**阻塞时禁止指示 30 开工
+- **`HG-AUDIT-R1` 仍为 `pending` 时禁止附「下一棒 30」可复制 Prompt**（见下节）
+- 不代替 **50 复检** 做代码走查
+
+## 人工闸联动（22 → 30 分界）
+
+| 维度 | 22 R1 负责 | 维护者负责 |
+|------|------------|------------|
+| task **内容**可执行 | 书面审查 · 零内容阻塞 | — |
+| **流程闸** `HG-AUDIT-R1` | 审查文写明 pending/approved | **签 task 表** → `approved` |
+| 30 改码授权 | **不签发** | task 表 `approved` 才是真值 |
+
+审查通过后请维护者签 **`HG-AUDIT-R1`** → `approved`（blocks **30**）。
+
+### `HG-AUDIT-R1` = pending 时，审查文文末只输出
+
+**维护者签闸清单**（禁止附 30 Prompt）：
+
+```text
+## 维护者签闸（22 后 · 30 前）
+
+- [ ] 已读 R1 审查结论
+- [ ] 在 task 人工闸表将 HG-AUDIT-R1 改为 approved（维护者 · 日期）
+- [ ] commit task 文档或确认已签
+- [ ] 再下发 Harness 30 Prompt
+
+30 Agent 将以 task 表为准；pending 时必须拒开工（见 TEMPLATE_30_gate_stop.md）。
+```
+
+### `HG-AUDIT-R1` = approved 后，审查文或维护者才可附 30 Prompt
+
+前提在 Prompt 内写明：**task 表已 approved**（非「计划签」）。
+
+## 输出形状
+
+元信息 → 结论摘要（内容 / 流程闸分列）→ 阻塞/非阻塞 → 回填清单 → 签闸清单或（已签时）下一棒 30 Prompt
+
+## 交接物
+
+- 审查 md 路径 + invoke 快照（可选）
+- 按 HANDOFF 分仓 commit
+
+## 给 Cursor
+
+`Harness`、`22`、`reviews`、`_audit_`、`HG-AUDIT-R1`、`拒开工`

package/harness/prompts/30-execute-code.md

@@ -0,0 +1,50 @@
+# 帽子：执行编码（Harness · Starter 子集）
+
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/30-execute-code.md` · `40-self-check.md`  
+> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。
+
+## 身份
+
+**执行编码** Agent：在 task 边界内改代码/配置；以 **Verify** 证明未破坏关键路径。
+
+## 开工前（强制 · 先于任何改码）
+
+1. 读 `docs/tasks/active/task_*.md` **人工闸**表与 `failure_paths`
+2. **首输出** GATE_VERIFY 闸扫描（见 [`FRAGMENT_30_gate_verify_v1_zh.md`](./FRAGMENT_30_gate_verify_v1_zh.md) · [`TEMPLATE_30_gate_stop.md`](./TEMPLATE_30_gate_stop.md)）
+3. 任一 **blocks 30** 的闸为 `pending` → **拒开工**（仅 STOP + 签闸指引）；**禁止**改业务码、禁止落 30 invoke
+4. **真值在 task 表**；维护者 / invoke 聊天 **不能**替代 `HG-AUDIT-R1` = `approved`
+5. **声称 vs 表冲突**（用户或 invoke 写 approved 但 task 表 pending）→ **STOP** · 输出冲突表 · **以 task 表为准**
+
+## 只做什么
+
+- 读 task **必读列表** + `AGENTS.md` + `_tech_graph/` + L2（涉码）
+- `test_strategy: required` → **先** 可失败测试再改实现
+- 闸扫描通过后：运行 task **验证命令**；回填 `### 自检结论（执行者）`
+- invoke 快照落盘 `docs/harness/invokes/by-task/<task_slug>/`
+
+## 禁止什么
+
+- 缺验收 / failure_paths / 必读 → **仅阻塞清单**
+- 静默扩 scope；SPEC 矛盾走变更请求
+- **`HG-GRAPH-MODULES` pending** 时改业务码（D4-a）
+- **`HG-AUDIT-R1` pending** 时改码
+- 在自检中写「发 30 Prompt = 授权」
+
+## 输入假设
+
+- 22 R1 **内容**通过 **且** task 表 **`HG-AUDIT-R1` = `approved`**
+- cwd = task `worktree_root` 或子仓根
+
+## 输出形状
+
+- （拒开工）仅闸扫描 STOP 模板
+- （通过）diff + PR 验证说明 + invoke + task 自检回填 + 下一棒 40 Prompt
+
+## 交接物
+
+- 可合并 commit（仅本轮路径；禁止 `git add -A`）
+- 引用 task 内 `### 自检结论` 路径
+
+## 给 Cursor
+
+`Harness`、`30`、`Verify`、`test_strategy`、`human_gate`、`拒开工`、`HG-AUDIT-R1`、`自检结论`

package/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md

@@ -0,0 +1,30 @@
+# FRAGMENT · 30 开工前 GATE_VERIFY（mandatory · 首输出）
+
+> 嵌入 **30 invoke** 与 `30-execute-code.md`。  
+> **禁止**在 invoke 中预写 `HG-AUDIT-R1 approved`；须 **读 task 人工闸表** 填表。
+
+## 首输出形状（未通过则 **零 diff**）
+
+```text
+## 人工闸扫描（GATE_VERIFY · 首输出）
+
+| human_gate_id | task表status | 用户/invoke声称 | 一致？ | blocks_30 | 30可开工？ |
+|---------------|--------------|-----------------|--------|-----------|------------|
+| HG-TASK-DRAFT | {读表} | {若有} | {Y/N} | {Y/N} | … |
+| HG-AUDIT-R1 | {读表} | {若有} | {Y/N} | Y | … |
+| HG-GRAPH-MODULES | {01_struct或—} | — | — | … | … |
+
+reviews：task_*_audit_R1_*.md 存在且 R1 通过？ {是/否}
+
+冲突规则：task表 pending 且用户/invoke 称 approved → **STOP** · 以 task 表为准
+
+结论：{STOP · 签闸指引 | 可进入读码/改码}
+
+机械辅助（可选）：CYNING_HARNESS/wizard/gate-check.sh --target <meta> --task docs/tasks/active/task_*.md
+```
+
+## Agent 纪律
+
+1. **先**输出上表，**再**读源码 / 改 `packages/**`。  
+2. 用户「确认…approved」= **须核验**，非已签事实。  
+3. task §5「可 30」= **预判**，闸真值 **仅** §人工闸表。

package/harness/prompts/FRAGMENT_30_invoke_block_v1_zh.md

@@ -0,0 +1,27 @@
+# FRAGMENT · 30 开工可复制块（上游 PR / OSS bugfix）
+
+> 复制到 `docs/harness/invokes/by-task/<slug>/PROMPT_*` 末尾 **「30 开工」** 节。  
+> **禁止**写 `HG-AUDIT-R1 approved` 字面句。
+
+```text
+## 30 开工（签闸后 · 另开会话 · 须 GATE_VERIFY）
+
+@<meta>/docs/tasks/active/task_<slug>_v1.md
+@<meta>/docs/harness/prompts/30-execute-code.md
+@<meta>/docs/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md
+@<meta>/docs/_tech_graph/<graph_delta>.md
+
+【开工前】
+1. 首输出 FRAGMENT_30_gate_verify 闸扫描表（读 task **人工闸表**，比对用户声称）
+2. 仅当 HG-AUDIT-R1=approved（task 表）且 reviews R1 存在 → 可改码
+3. 可选：wizard/gate-check.sh --target <meta> --task <本 task 路径>
+
+【实现】
+- 分支：<git_branch> · 仅 task 所列路径 + .changeset
+- test_strategy: required → 先红后绿
+- PR：Fixes #<issue> · 不含 harness/task 进上游
+
+【禁止】
+- 采信聊天「已 approved」而不读 task 表
+- 闸 pending 时改 packages/**
+```

package/harness/prompts/README.md

@@ -0,0 +1,28 @@
+# harness/prompts
+
+从本目录向用户仓 **`docs/harness/prompts/`** 复制 **Starter 子集**（非 Ink 全量帽子库）。
+
+## v0.1 已交付（T3 · M2）
+
+| 文件 | 状态 | 说明 |
+|------|------|------|
+| [`10-requirements.md`](./10-requirements.md) | ✅ | 需求 / 任务分析 · 精简 + POINTER |
+| [`22-task-audit.md`](./22-task-audit.md) | ✅ | 任务审核 · 落盘 reviews · HG-AUDIT-R1 |
+| [`30-execute-code.md`](./30-execute-code.md) | ✅ v0.1.1 | 执行编码 · 强制闸扫描 · AUDIT approved |
+| [`TEMPLATE_30_gate_stop.md`](./TEMPLATE_30_gate_stop.md) | ✅ v0.1.1 | 30 拒开工输出模板 |
+
+## 完整库（POINTER · 不复制全文）
+
+Ink 工作区维护完整帽子链：`docs/harness/prompts/`（00/20/40/50、TEMPLATE-*-invoke、PROMPT_*_chain_*）。
+
+嵌入用户仓后可在 README 追加：
+
+```markdown
+## 完整 Harness 库
+- 上游：Cyning12/cyning-ink-workspace `docs/harness/prompts/`（只读对照）
+```
+
+## 链式执行
+
+- 串行 Task 链：工作区 `PROMPT_cursor_task_chain_serial_v1.md`（M3 `harness ctx` 前手工 `@` 引用）
+- 每帽 invoke：[`../invokes/TEMPLATE_invoke.md`](../invokes/TEMPLATE_invoke.md)

package/harness/prompts/TEMPLATE_30_gate_stop.md

@@ -0,0 +1,34 @@
+# 模板：30 拒开工 · 人工闸 STOP
+
+> **用途**：`HG-AUDIT-R1` 或其它 blocks **30** 的闸为 `pending` 时，**首输出**须为本形状；**禁止**改业务码、禁止落 30 invoke。  
+> **复制**：Agent 按此填空；维护者演练拒开工时可对照。
+
+---
+
+## 人工闸扫描（30 · 拒开工）
+
+| human_gate_id | task表status | 用户/invoke声称 | 一致？ | blocks_30 | 30 可开工？ |
+|---------------|--------------|-----------------|--------|-----------|-------------|
+| HG-TASK-DRAFT | {读表} | {若有} | {Y/N} | {Y/N} | … |
+| **HG-AUDIT-R1** | **{读表}** | {若有} | {Y/N} | Y | **{❌ 否 / ✅ 是}** |
+| HG-GRAPH-MODULES | {读表或 —} | — | — | … | … |
+
+**冲突**：task 表 `pending` 且声称 `approved` → **拒开工**（不得采信聊天）。
+
+**结论**：**拒开工** — task 表真值未满足 30 条件。
+
+**真值依据**：`docs/tasks/active/task_*.md` 人工闸表（**聊天 Prompt 不能替代 `approved`**）。
+
+**维护者下一步**：
+
+1. 在 task 表将阻塞闸改为 `approved`（附维护者 · 日期）
+2. `git add` + `commit` task 文档（或维护者确认已签）
+3. 重新下发 Harness 30 Prompt
+
+**禁止**：将「维护者发送 30 Prompt」视为闸已签收。
+
+---
+
+## 给 Cursor
+
+`Harness`、`30`、`拒开工`、`HG-AUDIT-R1`、`human_gate`

package/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md

@@ -0,0 +1,16 @@
+# FRAGMENT · task 关账域推断（v1）
+
+关账 `git mv` 目标子目录：
+
+| 规则 | `done/<domain>/` |
+|------|------------------|
+| `task_harness_cyning_harness_*` · `task_harness_m2_cyning_*` | `cyning-harness/` |
+| `task_harness_*` | `harness/` |
+| `task_engineering_*` | `engineering/` |
+| `task_governance_*` · `task_gov_*` | `governance/` |
+| `task_chatbi_*` | `chatbi/` |
+| `task_standards_*` | `standards/` |
+| `epic_*` · `*MANIFEST*` · `*_loop_*` 母单 | `epics/` |
+| task 元信息 `domain` 字段 | 以字段为准 |
+
+歧义时：**人**在关账 commit 说明中写明域。

package/harness/templates/README.md

@@ -0,0 +1,48 @@
+# harness/templates
+
+复制到用户仓 **`docs/tasks/`** 或 **`docs/harness/tasks/active/`**（按仓约定）。
+
+## v0.1 已交付（T3 · M2）
+
+| 模板 | 状态 | 说明 |
+|------|------|------|
+| [`TASK_TEMPLATE.md`](./TASK_TEMPLATE.md) | ✅ | 单 task · Harness 元信息 · human_gate |
+| [`TASK_epic.md`](./TASK_epic.md) | ✅ | Epic 总纲 + §3.1 编排主表 + 00 入口 |
+| [`TASK_graph_bootstrap.md`](./TASK_graph_bootstrap.md) | ✅ | D4-a · **`HG-GRAPH-MODULES`** blocks **30** |
+
+## v0.2.1 · done 分层索引
+
+| 模板 | 状态 | 说明 |
+|------|------|------|
+| [`TASK_done_README.md`](./TASK_done_README.md) | ✅ | `done/README.md` Hub（按域分组表） |
+| [`VIEW_done_by_domain.md`](./VIEW_done_by_domain.md) | ✅ | `_views/done_by_domain.md` |
+| [`VIEW_done_thin_pointer.md`](./VIEW_done_thin_pointer.md) | ✅ | `_views/done.md` 薄指针（≤15 行） |
+| [`FRAGMENT_task_domain_infer_v1_zh.md`](./FRAGMENT_task_domain_infer_v1_zh.md) | ✅ | 关账 `git mv` 域推断规则 |
+
+`wizard/install.sh` 在首次安装时创建 `done/<domain>/` 子目录并复制 Hub / views（仅当目标文件不存在）。
+
+## 嵌入步骤
+
+```bash
+mkdir -p docs/tasks/active docs/tasks/_views
+mkdir -p docs/tasks/done/{harness,cyning-harness,engineering,governance,chatbi,standards,epics}
+cp harness/templates/TASK_done_README.md docs/tasks/done/README.md
+cp harness/templates/VIEW_done_thin_pointer.md docs/tasks/_views/done.md
+cp harness/templates/VIEW_done_by_domain.md docs/tasks/_views/done_by_domain.md
+mkdir -p docs/harness/reviews docs/harness/invokes/by-task
+cp harness/templates/TASK_TEMPLATE.md docs/tasks/active/task_<slug>.md
+# 存量首次：优先 TASK_graph_bootstrap.md
+```
+
+工作区 Harness 将 `{tasks_root}` 换为 `docs/harness/tasks`。
+
+## 关账纪律
+
+1. `git mv` → `done/<domain>/`（见 [`FRAGMENT_task_domain_infer_v1_zh.md`](./FRAGMENT_task_domain_infer_v1_zh.md)）  
+2. 更新 `done/README.md` 域表 **一行**  
+3. **勿**向 `_views/done.md` 追加百行长列表  
+
+## 关联
+
+- 图谱模板：[`graph/templates/`](../../graph/templates/README.md)
+- ONBOARDING：[`docs/ONBOARDING.md`](../../docs/ONBOARDING.md) §3 · §7

package/harness/templates/TASK_TEMPLATE.md

@@ -0,0 +1,111 @@
+# Task：<动词 + 范围>
+
+> **状态**：`draft` / `pending` / `in_progress` / `done`  
+> **关联图谱**：`docs/_tech_graph/` 相关 flow（无则填「无」）  
+> **落盘**：`docs/tasks/active/task_<slug>.md`；验收后 `git mv` → `docs/tasks/done/`
+
+---
+
+## Harness 元信息
+
+| 字段 | 值 |
+|------|-----|
+| **task_slug** | `<slug>` |
+| **test_strategy** | `required` / `recommended` / `not_applicable` |
+| **test_strategy_note** | （`not_applicable` 时 **必填**） |
+| **code_quality_bar** | `strict` / `recommended` / `not_applicable` |
+| **freeze_id** | （可选 · 关账冻结） |
+| **orchestration** | `Cursor Task 链` / `MANIFEST 仅` |
+| **chain_prompt** | `docs/harness/prompts/PROMPT_cursor_task_chain_serial_v1.md`（嵌入后路径） |
+| **semi_auto** | **`false`**（禁止作总闸） |
+| **audit_profile** | `full` / `post_close` / `human_only` |
+| **git_branch** | `task/<slug>` |
+| **worktree_root** | （并行时填独立 worktree 目录） |
+| **experience_capture** | `required` / `recommended` / `not_applicable` |
+| **kpi_rubric** | `KPI_RUBRIC_v1_2` |
+| **kpi_aggregator** | `CLOSE`（默认） |
+
+### 人工闸
+
+| human_gate_id | status | blocks_hats | 说明 |
+|---------------|--------|-------------|------|
+| HG-TASK-DRAFT | pending | 22-R1, 30 | 初稿人扫 |
+| HG-AUDIT-R1 | pending | 30 | 22 R1 落盘后人签 |
+
+---
+
+## 背景与目标
+
+<短段落：完成态行为>
+
+---
+
+## 范围
+
+- [ ] …
+
+## 非范围
+
+- …
+
+---
+
+## 失败路径
+
+| 触发条件 | 系统行为 | 可重试 | 用户可见 |
+|----------|----------|--------|----------|
+| 22 未签 `HG-AUDIT-R1` 即 30 改码 | 执行 Agent **拒开工** | 是 | 须先 22 + 人签 |
+| … | … | 是/否 | … |
+
+---
+
+## 验收标准
+
+- [ ] …
+
+---
+
+## 给执行帽的必读列表
+
+1. `AGENTS.md` · `docs/meta/PROJECT_CONFIG_*.md`
+2. `docs/_tech_graph/` 相关 flow
+3. `docs/standards/CODING_*_L2`（涉码 task）
+4. 本 task 关联 SPEC（若有）
+
+---
+
+## 实现备忘（子 Agent 回填）
+
+| 项 | 状态 | 备注 |
+|----|------|------|
+| … | ⏳ | |
+
+---
+
+## 测试策略（Harness）
+
+**test_strategy**: `required` | `recommended` | `not_applicable`
+
+- `required`：先可失败自动化测试再改实现
+- `recommended`：文档演练或抽样验证
+- `not_applicable`：须附一行理由
+
+---
+
+### 自检结论（执行者）
+
+（30/40 回填）
+
+---
+
+### KPI（00）
+
+（`kpi_aggregator: CLOSE` · 关账回溯填写）
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| YYYY-MM-DD | 从 cyning-harness `TASK_TEMPLATE.md` 嵌入 |

package/harness/templates/TASK_done_README.md

@@ -0,0 +1,75 @@
+# done/ · 已完成任务导航（Hub）
+
+> **用途**：日常浏览 **只打开本文件**；`_views/done.md` 为薄指针。  
+> **真值**：各 task 文件头部 `状态` + 本目录（或域子目录）物理位置。  
+> **落盘约定**：业务仓 `docs/tasks/done/` · 工作区 Harness `docs/harness/tasks/done/`（路径替换下方 `{tasks_root}`）。
+
+---
+
+## 域目录（domain）
+
+| 域 slug | 目录 | 典型前缀 / 规则 |
+|---------|------|-----------------|
+| `harness` | `done/harness/` | `task_harness_*`（非产品里程碑） |
+| `cyning-harness` | `done/cyning-harness/` | `task_harness_cyning_harness_*` · `task_harness_m2_cyning_*` |
+| `engineering` | `done/engineering/` | `task_engineering_*` |
+| `governance` | `done/governance/` | `task_governance_*` · `task_gov_*` |
+| `chatbi` | `done/chatbi/` | `task_chatbi_*` |
+| `standards` | `done/standards/` | `task_standards_*` |
+| `epics` | `done/epics/` | Epic / MANIFEST 母单 · CLOSE 卡 |
+
+**推断**：关账时按文件名前缀落入域目录；歧义时 task 元信息填 **`domain`** 字段。
+
+---
+
+## harness
+
+| 关账日 | task | freeze_id / 摘要 |
+|--------|------|------------------|
+| YYYY-MM-DD | [`harness/task_<slug>_v1.md`](./harness/task_<slug>_v1.md) | … |
+
+---
+
+## cyning-harness（产品里程碑）
+
+| 关账日 | task | tag / 摘要 |
+|--------|------|------------|
+| YYYY-MM-DD | [`cyning-harness/task_<slug>_v1.md`](./cyning-harness/task_<slug>_v1.md) | … |
+
+---
+
+## engineering
+
+| 关账日 | task | 摘要 |
+|--------|------|------|
+| YYYY-MM-DD | [`engineering/task_<slug>_v1.md`](./engineering/task_<slug>_v1.md) | … |
+
+---
+
+## epics（母单 · MANIFEST）
+
+| 关账日 | Epic / CLOSE | 子 task 索引 |
+|--------|--------------|--------------|
+| YYYY-MM-DD | [`epics/epic_<slug>.md`](./epics/epic_<slug>.md) | 见母单 §编排主表 |
+
+---
+
+## 关账维护（checklist）
+
+1. `git mv {tasks_root}/active/<file>.md {tasks_root}/done/<domain>/`  
+2. 头部 `> **状态**：done（YYYY-MM-DD 验收通过）`  
+3. **本 Hub** 对应域表 **追加一行**（日期 · 链接 · freeze_id 一行摘要）  
+4. **禁止**向 `_views/done.md` 追加长列表（保持 ≤15 行薄指针）  
+5. 可选：同步 `_views/done_by_domain.md` 分组表  
+
+---
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| YYYY-MM-DD | 初版 Hub（cyning-harness 模板嵌入） |
+
+## 给维护者
+
+`done`、`domain`、`Hub`、`_views`、`freeze_id`、`Epic`

package/harness/templates/TASK_epic.md

@@ -0,0 +1,101 @@
+# Epic：<主题 · 总纲>
+
+> **状态**：`draft` / `in_progress` / `done`  
+> **freeze_id**：`freeze_<epic_slug>`  
+> **落盘**：`docs/tasks/active/epic_<slug>.md` 或 `docs/harness/tasks/active/`（按仓约定）
+
+---
+
+## Harness 元信息
+
+| 字段 | 值 |
+|------|-----|
+| **task_slug** | `epic-<slug>` |
+| **test_strategy** | `not_applicable` |
+| **test_strategy_note** | Epic 跟踪单；可执行验收在 **子 task** |
+| **orchestration** | `Cursor Task 链` + **人工 00**（首棒） |
+| **chain_prompt** | `docs/harness/prompts/PROMPT_cursor_task_chain_serial_v1.md` |
+| **semi_auto** | `false` |
+| **audit_profile** | `full` / `post_close` |
+| **git_branch** | `task/<epic-branch>` |
+| **experience_capture** | `recommended` |
+| **kpi_rubric** | `KPI_RUBRIC_v1_2` |
+| **kpi_aggregator** | `CLOSE` |
+
+### 人工闸（Epic 级）
+
+| human_gate_id | status | blocks_hats | 说明 |
+|---------------|--------|-------------|------|
+| HG-EPIC-SIGNOFF | pending | CLOSE | 全部子 task 验收 + invoke 齐全后人签 |
+
+---
+
+## 背景与目标
+
+<Epic 完成态：子 task 列表与 freeze_id>
+
+**不做（Epic 范围外）**：
+
+- …
+
+---
+
+## 任务编排（Epic 主表 · 必填）
+
+| 棒 / slug | parallel_group | depends_on | 开工闸门 | worktree_root（可选） |
+|-----------|----------------|------------|----------|------------------------|
+| task-a | — | — | 22 R1 ✅ | `<repo-root>` |
+| task-b | — | task-a | 22 R1 ✅ | `<repo-root>` |
+| CLOSE | — | task-b | 40/50 | — |
+
+- 子 task 正文只写一行：`epic: epic_<slug> · depends_on: task-a`
+- **并行**：同 `parallel_group` 须 **独立 worktree** + 不同 `git_branch`
+
+### 编排入口（00）
+
+| 项 | 路径 |
+|----|------|
+| entry_invoke | `docs/harness/invokes/by-task/<epic_slug>/invoke_*_00_orchestrator.md` |
+| orchestrator | `docs/harness/prompts/00-orchestrator.md`（完整库 POINTER） |
+| 过程 invoke 索引 | `docs/harness/invokes/by-task/<epic_slug>/README.md` |
+
+---
+
+## 失败路径
+
+| 触发条件 | 系统行为 | 可重试 | 用户可见 |
+|----------|----------|--------|----------|
+| 子 task 未 22 即派发 30 | 00 **拒派发** | 是 | 缺审查 / 人签 |
+| 并行共分支改同一目录 | 执行 **拒开工** | 是 | 须 worktree |
+
+---
+
+## 验收标准
+
+- [ ] 编排主表 + 00 invoke 落盘
+- [ ] 各 sub-task `done` + 40 自检 + CI 绿（涉码）
+- [ ] invoke 目录证据齐全
+- [ ] `HG-EPIC-SIGNOFF` approved
+- [ ] `freeze_id` 写入 CHANGELOG / 关账 invoke
+
+---
+
+## 给执行帽的必读列表
+
+- 各子 task 全文
+- Epic 编排主表（本文件 §任务编排）
+- `docs/harness/invokes/by-task/<epic_slug>/`
+
+---
+
+### 自检结论（执行者）
+
+（40 汇总或各子 task 分别回填）
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| YYYY-MM-DD | 从 cyning-harness `TASK_epic.md` 嵌入 |