@cyning/harness 0.3.0

package/golden/POINTER_gold_epic_serial.md

@@ -0,0 +1,93 @@
+# POINTER · 金样：串行 Epic + invoke 链（M1 · 不复制业务代码）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` |
+| **日期** | 2026-06-09 |
+| **freeze_id** | `freeze_epic_orchestration_pilot_v1` |
+| **性质** | **只读指针**；金样真值在 Ink 私有工作区，本产品 **不复制** 业务代码或 invoke 全文 |
+
+---
+
+## 金样是什么
+
+**M1 已签收** 的前端 Epic 串行编排试点：Epic 总纲 + 00 编排 + **M01→M02→M03** 子 task 链 + invoke 落盘 + CI 绿 + PR merge。
+
+| 维度 | 值 |
+|------|-----|
+| **编排模式** | 单分支串行 · `Cursor Task 链` · `semi_auto: false` |
+| **子仓** | `ai-ink-brain/`（前端 Ink） |
+| **Epic slug** | `tech-debt-code-quality-frontend` |
+| **分支（已 merge）** | `task/tech-debt-code-quality-frontend` |
+| **人签** | `HG-M1-SIGNOFF` approved（2026-06-09） |
+
+---
+
+## 证据路径（Ink 私有工作区 · 只读）
+
+> 本地常名 `Projects/`（cyning-ink-workspace）。无访问权限时仅用本产品 `harness/templates/TASK_epic.md` 作结构对照。
+
+### 工作区 · M1 跟踪 task
+
+| 资产 | 路径 |
+|------|------|
+| M1 签收单 | `docs/harness/tasks/done/task_harness_m1_epic_orchestration_frontend_pilot_v1.md` |
+| Epic 编排 GUIDANCE | `docs/harness/guides/GUIDANCE_epic_orchestration_task_chain_v1_zh.md` |
+| PLAN §6 M1 行 | `docs/harness/guides/PLAN_self_hosted_runtime_mvp_phases_v1_zh.md` |
+
+### 前端子仓 · Epic 与 invoke
+
+| 资产 | 路径 |
+|------|------|
+| Epic 总纲（done） | `ai-ink-brain/docs/tasks/done/task_tech_debt_code_quality_frontend_epic_v1.md` |
+| **invoke 索引目录** | `ai-ink-brain/docs/harness/invokes/by-task/tech-debt-code-quality-frontend/` |
+| 关账 invoke | `…/invoke_20260609_CLOSE_epic.md` |
+| 00 编排 | `…/invoke_20260609_00_orchestrator.md` |
+
+### M1 签收子集（串行棒）
+
+| 棒 | 子 task（done） | 典型 invoke |
+|----|-----------------|-------------|
+| 00 | 编排派发 M01 | `invoke_20260609_00_orchestrator.md` |
+| M01 | `task_tech_debt_cq_frontend_m01_py_proxy_v1.md` | `invoke_20260609_40_m01_py_proxy.md` |
+| M02 | `task_tech_debt_cq_frontend_m02_bff_routes_v1.md` | `invoke_20260609_40_m02_bff_routes.md` |
+| M03 | `task_tech_debt_cq_frontend_m03_unified_chat_v1.md` | `invoke_20260609_40_m03_unified_chat.md` |
+
+M04～M06 为编码 Epic 延续（已关账），**不阻塞** M1 签收。
+
+### 外部链接
+
+| 项 | URL |
+|----|-----|
+| PR → production | https://github.com/Cyning12/ai-ink-brain/pull/64 |
+| PR → main | https://github.com/Cyning12/ai-ink-brain/pull/65 |
+
+---
+
+## 与本产品（cyning-harness）的关系
+
+| 本产品资产 | 对照金样 |
+|------------|----------|
+| [`harness/templates/TASK_epic.md`](../harness/templates/TASK_epic.md) | Epic 编排主表 §3.1 |
+| [`harness/templates/TASK_TEMPLATE.md`](../harness/templates/TASK_TEMPLATE.md) | 各 sub-task 结构 |
+| [`harness/invokes/TEMPLATE_invoke.md`](../harness/invokes/TEMPLATE_invoke.md) | invoke 快照格式 |
+| M2 本仓执行 invoke | 工作区 `docs/harness/invokes/by-task/cyning-harness-v0-1/`（**不**复制进产品仓） |
+
+**纪律**：clone `cyning-harness` 的用户 **打开金样** = 有权限时读上述 Ink 路径；否则按模板 + 本 POINTER 摘要演练。
+
+---
+
+## 后端编码 Epic（可选对照 · 非 M1 别名）
+
+| 项 | 路径 |
+|----|------|
+| CC W2～W8 Manifest | `ai-ink-brain-api-python/docs/tasks/active/task_standards_backend_api_modularization_manifest_v1.md` |
+| 说明 | 形态类似 Epic+PR，**≠** PLAN M1 编排试点；可作 M2 扩展金样来源 |
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-06-09 | M2 T6：M1 串行 Epic 金样 POINTER 首版 |

package/golden/README.md

@@ -0,0 +1,30 @@
+# golden · 金样 pointer
+
+本目录仅存放 **外部金样链接说明**（invoke 链、验收口径摘要），**不复制**任何业务代码。
+
+## v0.1 已交付（T6 · M2）
+
+| 文件 | 状态 | 说明 |
+|------|------|------|
+| [`POINTER_gold_epic_serial.md`](./POINTER_gold_epic_serial.md) | ✅ | M1 串行 Epic 金样 · invoke 链索引 · PR 证据 |
+
+## 金样摘要
+
+| 项 | 值 |
+|----|-----|
+| **freeze_id** | `freeze_epic_orchestration_pilot_v1` |
+| **Epic slug** | `tech-debt-code-quality-frontend` |
+| **invoke 目录** | `ai-ink-brain/docs/harness/invokes/by-task/tech-debt-code-quality-frontend/` |
+| **M1 跟踪** | 工作区 `docs/harness/tasks/done/task_harness_m1_epic_orchestration_frontend_pilot_v1.md` |
+
+## 使用
+
+1. 读本目录 POINTER → 有权限时钻取 Ink 路径对照  
+2. 无私有工作区：用 [`harness/templates/TASK_epic.md`](../harness/templates/TASK_epic.md) 结构演练  
+3. **禁止** 将金样 invoke 全文或业务代码复制进产品仓分发包
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-06-09 | T6 M2 首版 POINTER |

package/graph/stubs/README.md

@@ -0,0 +1,6 @@
+# graph/stubs
+
+产品包 **不内置** 某上游 OSS 的预填图谱。
+
+- 默认 bootstrap：仅用 [`../templates/`](../templates/)（通用占位）+ 删除 `10_flow_MAIN*`。
+- 项目专用快照：见 [`../../examples/oss-fork/`](../../examples/oss-fork/)，通过 `--stub-dir` 显式加载。

package/graph/templates/00_main.ai.md

@@ -0,0 +1,28 @@
+```mermaid
+flowchart TD
+  %% version: YYYY-MM-DD — AI 协议版 · 须与 00_main.md 语义等价
+  %% 拓扑：见 99_mermaid_protocol.md
+
+  %% === 入口阶段 ===
+  Q[[用户 / 客户端请求]] --"->"--> E{"应用入口"}
+  // → src/main.py#L1 或 app/router/index.ts#L1（替换为真实锚点）
+
+  %% === 主业务分支 ===
+  E --"主路径 A"--> M1[[核心业务处理]]
+  // → 例：handlers/resource.py::handle_create
+  E --"主路径 B"--> M2[[次要路径]]
+  // → 例：handlers/health.py::health_check
+  E --"管理/批处理"--> ADM[[Admin / Job]]
+  // → 例：jobs/ingest.py::run_sync
+
+  %% === 子流程折叠 ===
+  M1 --"::triggers"--> FLOW_MAIN[[主路径子流程]]
+  FLOW_MAIN --"加载"--> FLOW_DOC[>10_flow_MAIN.md]
+
+  M1 --"->"--> DB[(持久化)]
+  // → 例：db/repository.py 或 ORM 层
+  ADM --"->"--> DB
+
+  %% === 按需加载（可选）===
+  E --"加载"--> STRUCT_DOC[>01_struct.md]
+```

package/graph/templates/00_main.md

@@ -0,0 +1,52 @@
+# 顶层流程总图（人类友好版）
+
+> **用途**：`docs/_tech_graph/00_main.md` — 本仓 **Happy Path** 主干；子流程折叠为 `10_flow_*.md` 链接。  
+> **双轨**：须与 [`00_main.ai.md`](./00_main.ai.md) 语义等价；flowchart 改 `.ai.md` 优先，再同步本文件。  
+> **协议**：[`99_mermaid_protocol.md`](./99_mermaid_protocol.md)
+
+## 维护说明
+
+1. 替换下方占位节点为你的 **真实入口**（HTTP 路由 / CLI / 事件总线等）。
+2. 子图节点 > 7 时折叠为 `[[Phase]]`，链至独立 `10_flow_*.md`。
+3. 异常分支可挂侧链；主干保持可读。
+
+```mermaid
+flowchart TD
+    %% version: YYYY-MM-DD — 替换为首次人签日期
+
+    %% === 入口 ===
+    Q[用户 / 客户端请求] --> E{应用入口<br/>例：src/main.py 或 app/router}
+
+    %% === 主业务分支（示例 · 按栈裁剪）===
+    E -->|主路径 A| M1[核心业务处理<br/>例：/api/v1/resource]
+    E -->|主路径 B| M2[次要路径<br/>例：/health 或 /metrics]
+    E -->|管理/批处理| ADM[Admin / Job<br/>例：ingest / sync]
+
+    %% === 子流程折叠 ===
+    M1 --> FLOW_MAIN[主路径子流程]
+    FLOW_MAIN --> FLOW_DOC[> 10_flow_MAIN.md]
+
+    M1 --> DB[(持久化<br/>例：PostgreSQL / 文件)]
+    ADM --> DB
+
+    %% === 样式（可选）===
+    classDef start fill:#e1f5fe,stroke:#01579b,stroke-width:2px
+    classDef main fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
+    classDef infra fill:#fff8e1,stroke:#ff6f00,stroke-width:1px
+
+    class Q,E start
+    class M1,M2,ADM main
+    class FLOW_MAIN,DB infra
+```
+
+## 待补 flow 清单（存量 S2+ 可用）
+
+| flow 文件 | 状态 | 说明 |
+|-----------|------|------|
+| `10_flow_MAIN.md` | 示例已提供 | 主请求路径；嵌入后替换为真实 API/页面流 |
+| `10_flow_*.md` | 待增量 | 每 Epic 或跨模块改动时补 1 张 |
+
+## 关联
+
+- 模块边界：[`01_struct.md`](./01_struct.md)（**HG-GRAPH-MODULES** 人签真值）
+- 拓扑协议：[`99_mermaid_protocol.md`](./99_mermaid_protocol.md)

package/graph/templates/01_struct.md

@@ -0,0 +1,38 @@
+# 模块边界登记表（L0-b · D4-a 人签真值）
+
+> **用途**：`docs/_tech_graph/01_struct.md` — **一级模块** 边界；**HG-GRAPH-MODULES** approved 后方可 **30 执行改码**。  
+> **不是**：全仓 flow 一次画完；flow 按 task **增量** 维护。  
+> **嵌入后**：删除示例行，填真实模块；维护者人签后更新 task 内 `HG-GRAPH-MODULES` → `approved`。
+
+## 模块表（必填）
+
+| module_id | 名称 | 路径 glob | 依赖方向（仅指向谁） | 负责人/备注 |
+|-----------|------|-----------|----------------------|-------------|
+| `core` | 核心业务 | `src/core/**` 或 `app/**` | → `infra` | 示例 · **替换** |
+| `api` | HTTP / RPC 入口 | `src/api/**` 或 `routes/**` | → `core` | 示例 · **替换** |
+| `infra` | DB / 缓存 / 外部 SDK | `src/infra/**` | —（被依赖） | 示例 · **替换** |
+| `_TODO_` | （待填） | `（glob）` | → | 新增行 |
+
+### 填写规则
+
+1. **module_id**：小写 snake_case；全仓唯一。
+2. **路径 glob**：能覆盖该模块源码根； monorepo 按 **子包** 分行。
+3. **依赖方向**：只写 **出边**（本模块允许 import / 调用谁）；禁止循环 unless 文档化。
+4. **一级模块**：通常 3～12 行；更细粒度放 Wiki 或子 task，不膨胀本表。
+
+## 跨模块契约（可选）
+
+| 契约 | 提供方 module_id | 消费方 | 说明 |
+|------|------------------|--------|------|
+| `（例：UserDTO）` | `core` | `api` | 共享类型 / OpenAPI schema |
+
+## 人签记录（嵌入后填写）
+
+| human_gate_id | status | 签核人 | 日期 | 说明 |
+|---------------|--------|--------|------|------|
+| HG-GRAPH-MODULES | pending | | | `01_struct` 模块表覆盖一级模块 |
+
+## 关联
+
+- 顶层图：[`00_main.md`](./00_main.md) · [`00_main.ai.md`](./00_main.ai.md)
+- 主 flow 示例：[`10_flow_MAIN.md`](./10_flow_MAIN.md)

package/graph/templates/10_flow_MAIN.ai.md

@@ -0,0 +1,43 @@
+```mermaid
+flowchart TD
+  %% Entry: 例 POST /api/v1/resource — 替换锚点为真实代码
+  %% 拓扑协议：见 99_mermaid_protocol.md
+
+  %% === 请求阶段 ===
+  IN[[HTTP 请求]] --"->"--> AUTH[[鉴权 / 会话校验]]
+  // → middleware/auth.py::require_user 或 src/auth/guard.ts
+
+  AUTH --"[ok]"--> VAL[[参数校验]]
+  AUTH --"[err]"--> ERR_AUTH[>Auth Failed]
+  // → middleware/auth.py#L42
+
+  VAL --"[ok]"--> SVC[[业务服务层]]
+  // → services/resource_service.py::handle
+  VAL --"[err]"--> ERR_VAL[>Validation Failed]
+
+  %% === 数据阶段 ===
+  SVC --"->"--> REPO[[仓储 / ORM]]
+  // → repositories/resource_repo.py::find_by_id
+
+  REPO --"->"--> DB[(数据库 / 存储)]
+  // → db/session.py 或 ORM model
+
+  REPO --"?>"--> HIT{record exists?}
+  HIT --"[no]"--> NOTFOUND[[404 / 空结果]]
+  HIT --"[yes]"--> SVC
+
+  SVC --"[err]"--> BIZERR[[4xx 业务错误]]
+  // → services/resource_service.py 业务规则分支
+
+  %% === 响应阶段 ===
+  SVC --"->"--> RESP[[组装响应 DTO]]
+  RESP --"->"--> OUT[[返回 JSON / 页面]]
+  // → handlers/resource.py::to_response
+
+  %% === 归档 ===
+  OUT --"::archives"--> LOG[[结构化日志]]
+  // → observability/logger.py
+
+  %% === 顶层链接 ===
+  IN --"加载"--> MAIN_DOC[>00_main.md]
+```

package/graph/templates/10_flow_MAIN.md

@@ -0,0 +1,47 @@
+# 主路径 Flow 示例（人类友好版）
+
+> **用途**：`docs/_tech_graph/10_flow_MAIN.md` — **至少 1 条**主业务流（新仓 / S0 必做）。  
+> **双轨**：须与 [`10_flow_MAIN.ai.md`](./10_flow_MAIN.ai.md) 语义等价。  
+> **嵌入后**：将占位路径替换为真实 handler / 路由 / 页面流。
+
+```mermaid
+flowchart TD
+    %% Entry: 例 GET/POST /api/v1/resource — 替换为真实入口
+
+    %% === 请求阶段 ===
+    IN[HTTP 请求] --> AUTH[鉴权 / 会话校验]
+    AUTH --> VAL[参数校验<br/>schema / DTO]
+    VAL --> SVC[业务服务层<br/>例：ResourceService]
+
+    %% === 数据阶段 ===
+    SVC --> REPO[仓储 / ORM<br/>例：ResourceRepository]
+    REPO --> DB[(数据库 / 存储)]
+
+    REPO -->|无记录| NOTFOUND[404 / 空结果]
+    SVC -->|业务规则失败| BIZERR[4xx 业务错误]
+
+    %% === 响应阶段 ===
+    SVC --> RESP[组装响应 DTO]
+    RESP --> OUT[返回 JSON / 页面]
+
+    %% === 可观测（可选）===
+    OUT --> LOG[结构化日志 / trace]
+
+    %% 样式
+    classDef request fill:#e1f5fe,stroke:#01579b,stroke-width:2px
+    classDef domain fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
+    classDef data fill:#fff8e1,stroke:#ff6f00,stroke-width:1px
+
+    class IN,AUTH,VAL request
+    class SVC,RESP,OUT domain
+    class REPO,DB,LOG data
+```
+
+## 与顶层图关系
+
+- 在 [`00_main.md`](./00_main.md) 中由 `M1` 或等价节点 **加载** 本文件。
+- 模块归属见 [`01_struct.md`](./01_struct.md) 中 `api` / `core` 等行。
+
+## 增量维护
+
+改 BFF / API 契约时：**同 task** 更新本 flow 或另开图谱子 task；Harness 关账 ≠ 图谱关账。

package/graph/templates/99_mermaid_protocol.md

@@ -0,0 +1,100 @@
+# Mermaid 拓扑协议（通用 · v2）
+
+> **用途**：`docs/_tech_graph/99_mermaid_protocol.md` — flowchart **双轨** 与边标记真值。  
+> **双轨制**：`.md` 人类友好；`.ai.md` AI / 脚本协议版；**语义等价**。
+
+| 后缀 | 维护者 | 特点 |
+|------|--------|------|
+| `.md` | 开发者 | 简洁可读；少量裸边可接受 |
+| `.ai.md` | LLM / 脚本 | 结构化标记、锚点分离、**零裸边** |
+
+**转换方向**：人写 `.md` → 按本协议生成/同步 `.ai.md` → 渲染审阅。
+
+---
+
+## 1. 边标记
+
+### 1.1 执行流
+
+| 标记 | 语义 | 何时用 |
+|------|------|--------|
+| `->` | 同步顺序执行 | 普通调用 |
+| `~>` | 异步 / await | 非阻塞 I/O |
+| `=>` | 赋值 / 映射 | 数据转换 |
+| `?>` | 条件分支 | if / switch / 路由 |
+
+### 1.2 状态与可靠性
+
+| 标记 | 语义 | 示例 |
+|------|------|------|
+| `[ok]` | 成功路径 | `validate() --"[ok]"--> save()` |
+| `[err]` | 失败 / 异常 | `parse() --"[err]"--> fallback()` |
+| `[retry=N]` | 重试 | `call_api() --"[retry=3]"--> call_api()` |
+| `[timeout]` | 超时降级 | `fetch() --"[timeout]"--> cache_get()` |
+
+### 1.3 元关系（`::` 命名空间）
+
+| 标记 | 语义 |
+|------|------|
+| `::yields` | 流式 / 生成器产出 |
+| `::triggers` | 触发子流程或后台任务 |
+| `::gates` | 门禁 / 鉴权 / 依赖注入 |
+| `::branches` | 并行分支 |
+| `::merges` | 多路归并 |
+| `::signoff` | 持久化确认 / 事务提交 |
+| `::archives` | 日志 / 审计归档 |
+
+---
+
+## 2. 节点形状（flowchart）
+
+| 形状 | 含义 | 示例 |
+|------|------|------|
+| `[[...]]` | 阶段 / 流程块 | `[[Query Phase]]` |
+| `[...]` | 函数 / 操作 | `[process_request]` |
+| `[(...)]` | 数据 / 模型 | `[(UserRecord)]` |
+| `{...}` | 判断 / 路由 | `{authorized?}` |
+| `>...]` | 里程碑 / 文档指针 | `>10_flow_MAIN.md]` |
+| `((...))` | 循环 / 归档 | `((write_log))` |
+
+---
+
+## 3. 锚点规则（`.ai.md` 强制）
+
+每条 **硬边** 须可追溯到代码或文档：
+
+```text
+// → src/handlers/foo.py#L42
+// → src/handlers/foo.py::handle_request
+// → migrations/001_init.sql#L12
+// → docs/_tech_graph/10_flow_MAIN.md
+```
+
+- 锚点用 **独立注释行** `// → path#Ln`，不塞进节点标签。
+- 跨模块调用：虚线或 `::triggers`，**不**展开对方内部。
+
+---
+
+## 4. 分层与折叠
+
+| 条件 | 操作 |
+|------|------|
+| 子图节点 ≤ 7 | 可在主图展开 |
+| 子图节点 > 7 | 折叠为 `[[Phase]]`，链独立 `10_flow_*.md` |
+| 异常分支 | 挂侧链；Happy Path 走主干 |
+
+---
+
+## 5. 禁止项
+
+- `.ai.md` 中 **禁止裸边**（须带 `"->"` 等标记）。
+- 禁止虚构文件路径；未知处用 `// → TBD` 并开 task 补锚点。
+- **禁止** onboarding 默认「全仓扫描生图」。
+
+---
+
+## 6. 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| YYYY-MM-DD | 嵌入用户仓时填写首次版本 |

package/graph/templates/README.md

@@ -0,0 +1,34 @@
+# graph/templates
+
+复制到用户仓 **`docs/_tech_graph/`**。
+
+## v0.1 已交付模板（T1 · M2）
+
+| 文件 | 状态 | 说明 |
+|------|------|------|
+| [`00_main.md`](./00_main.md) | ✅ | 顶层流程（人类友好版） |
+| [`00_main.ai.md`](./00_main.ai.md) | ✅ | 顶层流程（AI 协议版 · 双轨） |
+| [`01_struct.md`](./01_struct.md) | ✅ | **模块边界表**（D4-a · **HG-GRAPH-MODULES** 人签真值） |
+| [`99_mermaid_protocol.md`](./99_mermaid_protocol.md) | ✅ | Mermaid 拓扑协议 |
+| [`10_flow_MAIN.md`](./10_flow_MAIN.md) | ✅ | 主路径 flow 示例（人类版） |
+| [`10_flow_MAIN.ai.md`](./10_flow_MAIN.ai.md) | ✅ | 主路径 flow 示例（AI 版） |
+
+## 仍可选补（非 T1 硬门槛）
+
+| 文件 | 说明 |
+|------|------|
+| `02_version.md` | 版本时间线；新仓建议嵌入后首周补 |
+
+## 嵌入后
+
+- **新仓**：骨架 + 模块表人签 + 至少 1 主 flow（见 [`docs/ONBOARDING.md`](../../docs/ONBOARDING.md) §3）
+- **存量**：按 ONBOARDING 档位 S0～S3；**禁止**首次全 flow 构图
+- **人签**：`01_struct` 模块表 → **HG-GRAPH-MODULES** approved → 允许 30 改码
+
+## 复制命令
+
+```bash
+mkdir -p docs/_tech_graph
+cp -R cyning-harness/graph/templates/* docs/_tech_graph/
+# 按需删除 README 或本说明段
+```

package/harness/README.md

@@ -0,0 +1,18 @@
+# harness · 过程轨
+
+| 子目录 | 内容 | T3 状态 |
+|--------|------|---------|
+| [`templates/`](templates/) | task、Epic、graph_bootstrap | ✅ v0.1 |
+| [`prompts/`](prompts/) | 10/22/30 Starter 子集 | ✅ v0.1 |
+| [`invokes/`](invokes/) | invoke 落盘约定 + TEMPLATE | ✅ v0.1 |
+
+用户仓对应路径建议：`docs/tasks/`、`docs/harness/prompts/`、`docs/harness/invokes/`。
+
+## 嵌入一键清单
+
+```bash
+mkdir -p docs/tasks/active docs/harness/prompts docs/harness/invokes/by-task docs/harness/reviews
+cp -R harness/templates/* docs/tasks/   # 或按需单文件复制并重命名
+cp harness/prompts/*.md docs/harness/prompts/
+cp harness/invokes/TEMPLATE_invoke.md docs/harness/invokes/
+```

package/harness/invokes/README.md

@@ -0,0 +1,22 @@
+# harness/invokes
+
+## 约定
+
+- 路径：`docs/harness/invokes/by-task/<task_slug>/invoke_YYYYMMDD_<hat>_<slug>.md`
+- 每 **新帽** 开局落盘 §3 调用体（同帽追问不新增）
+- 与 task `### 自检结论`、`docs/harness/reviews/` 并列可追溯
+
+## v0.1 已交付（T3 · M2）
+
+| 文件 | 状态 | 说明 |
+|------|------|------|
+| [`TEMPLATE_invoke.md`](./TEMPLATE_invoke.md) | ✅ | 元信息表 + Prompt 快照 + 交付摘要骨架 |
+
+## 完整规范 POINTER
+
+Ink 工作区：`docs/harness/invokes/README.md`（命名、by-task 布局、pointer 策略）
+
+## 纪律
+
+- **M2 产品仓执行过程** invoke 可留工作区 `by-task/`（见 cyning-harness ONBOARDING）
+- 用户仓 Epic / task 执行 invoke **落本仓** `docs/harness/invokes/`

package/harness/invokes/TEMPLATE_invoke.md

@@ -0,0 +1,59 @@
+# Harness invoke 快照模板
+
+> **用途**：每 **新帽** 开局时，将 **占位符已全部替换** 的 §3 Prompt 落盘。  
+> **路径**：`docs/harness/invokes/by-task/<task_slug>/invoke_YYYYMMDD_<hat>_<slug>.md`
+
+---
+
+## 元信息表（必填）
+
+| 字段 | 值 |
+|------|-----|
+| hat_id | 10 / 22 / 30 / 40 / 50 / 00 / CLOSE |
+| task_slug | `<slug>` |
+| freeze_id | （可选） |
+| task_paths | `docs/tasks/active/task_….md` |
+| related_review_or_none | `docs/harness/reviews/…` 或 `无` |
+| git_branch | `task/<slug>` |
+| worktree_root | （并行时必填 · 相对仓根） |
+| created_utc_or_local | YYYY-MM-DD |
+| notes | （可选） |
+
+---
+
+## 可复制 Prompt 快照
+
+```text
+（粘贴本帽 TEMPLATE-*-invoke §3 全文 · 占位符须全部替换）
+```
+
+---
+
+## 交付摘要（本帽结束时填）
+
+- **验证命令** + 退出码
+- **变更路径** 列表
+- **下一棒** slug 或「交还 00」
+
+---
+
+## 纪律
+
+| 规则 | 说明 |
+|------|------|
+| 同帽追问 | **不** 新增 invoke；沿用本节路径 |
+| 打回重开 | 新文件或 `_r2` 后缀 |
+| 与 reviews 分工 | reviews = 结论；invoke = **当时指令** |
+| commit | 落盘 + task 回填后再 commit（见 HANDOFF） |
+
+---
+
+## 完整库 POINTER
+
+Ink 工作区：`docs/harness/invokes/README.md` · 各 `TEMPLATE-*-invoke.md` §3
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| YYYY-MM-DD | 从 cyning-harness 嵌入 |

package/harness/prompts/10-requirements.md

@@ -0,0 +1,42 @@
+# 帽子：需求 / 任务分析（Harness · Starter 子集）
+
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/10-requirements.md`  
+> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。
+
+## 身份
+
+**需求与任务分析** Agent：把目标写成 **可执行、可验收** 的 task；**不写实现代码**。
+
+## 只做什么
+
+- 明确 **验收标准**（可勾选或对命令输出断言）
+- 补齐 **`failure_paths`**（触发 → 行为 → 可重试 → 用户可见）
+- 写清 **非范围**、**依赖**（相对路径链接）
+- 建议 `test_strategy` + `code_quality_bar`
+- 承接 **22 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task
+
+## 禁止什么
+
+- 不实现代码、不改 CI
+- 不写绝对本机路径
+- 缺验收 / failure_paths → 仅输出 **阻塞清单**
+
+## 输出形状
+
+- 背景 / 范围 / 非范围 / 依赖 / 验收 / failure_paths / 给执行帽必读列表
+- 涉码 task：链 `docs/standards/CODING_*_L2`
+
+## 交接物
+
+- 可粘贴进 `docs/tasks/active/task_*.md` 的正文块；并注明建议 `test_strategy`。
+- 承接 **22 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task。
+
+## OSS 阶段 C · 思考轮（Starter 摘要）
+
+- 10 帽草稿 **须预置 R0 + R1–R5** 五槽 + **思考轮控制** 表（见 `wizard/templates/TASK_TEMPLATE_upstream_pr_v1.md`）。  
+- **可提前停 / 可增 R6+**；须填 reason · residual_risks（无则 `none`）。  
+- **22 审思考是否充分**；不通过 → **退回 10** 补轮后再 22 R+1。完整版：`Projects/docs/harness/prompts/10-requirements.md` § OSS fork。
+
+## 给 Cursor
+
+`Harness`、`10`、`验收`、`failure_paths`、`test_strategy`、`拒开工`