Skip to content

Commit 0591a0f

Browse files
CyningMMcursoragent
andcommitted
docs(harness): Gate A 性能对比任务审核 R3 终局签收
落盘 R3 审查与 invoke 快照;对照 R2 回填清单确认无阻塞。 Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent c388920 commit 0591a0f

2 files changed

Lines changed: 102 additions & 0 deletions

File tree

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Harness invoke snapshot
2+
3+
| 字段 ||
4+
|------|-----|
5+
| hat_id | 22 |
6+
| template | `docs/harness/prompts/TEMPLATE-task-audit-invoke.md` §3(任务审核帽 · R3 复审) |
7+
| task_paths | `ai-ink-brain-api-python/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md` |
8+
| related_review_or_none | `ai-ink-brain-api-python/docs/harness/reviews/task_engineering_tech_graph_gate_a_perf_compare_v1_audit_R2_20260515.md` |
9+
| created_utc_or_local | 2026-05-15(CST,人填) |
10+
| notes | PR #28 已合入 `main` 并完成归档回填后,发起 R3 终局签收审查 |
11+
12+
## 可复制 Prompt 快照(与对话首条 user 一致)
13+
14+
```text
15+
你正在扮演工作区 Harness「任务审核帽」,严格遵循:
16+
- docs/harness/prompts/22-task-audit.md(身份、禁止项、输出形状、交接物)
17+
- docs/harness/reviews/README.md(文件命名、R1/R2 闭环)
18+
- docs/harness/HARNESS_V2_PLAN.md §5(test_strategy、failure_paths 等与 task 字段对齐)
19+
20+
输入(已由人工替换占位符;若你仍看到 {{…}} 或本段「待填」字样,须先追问用户,不得开工):
21+
- 待审 task 路径(相对工作区根 Projects/):
22+
ai-ink-brain-api-python/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md
23+
- 关联 SPEC / 总规路径(无则写「无」):
24+
docs/tech_graph/改进方向.md;docs/tech_graph/SPEC/json_graph/scheme_1_graph_json.md;ai-ink-brain-api-python/docs/tech_graph/gate_a_scheme1_backend.md;ai-ink-brain-api-python/docs/tech_graph/gate_a_scheme1_perf_compare_backend_detail.md
25+
- 上一轮审查文档路径(首轮写「无」;复审必填):
26+
ai-ink-brain-api-python/docs/harness/reviews/task_engineering_tech_graph_gate_a_perf_compare_v1_audit_R2_20260515.md
27+
28+
落盘文件建议名(须与文内元信息一致):
29+
ai-ink-brain-api-python/docs/harness/reviews/task_engineering_tech_graph_gate_a_perf_compare_v1_audit_R3_20260515.md
30+
31+
你必须完成:
32+
0. Invoke 快照:按 `docs/harness/invokes/README.md` 将本消息全文落盘到本仓 `docs/harness/invokes/`(与审查元信息 `invoke_snapshot` 互链)。
33+
1. 通读待审 task 全文及头部元信息。
34+
2. 对照 HARNESS_V2_PLAN.md §5 检查验收可观测性。
35+
3. 落盘审查文档至建议路径。
36+
4. 文内结构:元信息 → 审查结论摘要 → 阻塞 / 非阻塞 → 需任务帽回填清单(若有)→ 是否建议执行帽开工 → 「签收 / 关闭」→「下一棒可复制 Prompt」。
37+
5. 禁止仅在对话里说「过了」而不写 reviews;禁止在仍有阻塞时指示执行帽开工。
38+
6. 不要写业务实现代码;不要擅自改写 task 正文。
39+
7. 对话回复中输出与审查 md 末节完全相同的下一棒可复制 Prompt 全文。
40+
```
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
# 任务审核 · R3
2+
3+
## 元信息
4+
5+
| 字段 ||
6+
|------|-----|
7+
| 关联 task | `ai-ink-brain-api-python/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md` |
8+
| 审查轮次 | R3 |
9+
| 落盘日期 | 2026-05-15 |
10+
| 上一轮审查 | `ai-ink-brain-api-python/docs/harness/reviews/task_engineering_tech_graph_gate_a_perf_compare_v1_audit_R2_20260515.md` |
11+
| invoke_snapshot(本帽) | `docs/harness/invokes/invoke_20260515_22_gate-a-scheme1-perf-compare-task-audit-r3.md`(相对本仓根 `ai-ink-brain-api-python/`|
12+
| 合入与归档锚点(非 `freeze_id`| `PR #28` 合入 `main`(merge `2315937`);归档提交 `c388920``docs(tasks): 归档 Gate A 性能对比 task 并回填 PR #28`);专文交付链 tip `47a6f9e` |
13+
| 关联 SPEC / 总规(本轮对照 task 元信息) | `docs/tech_graph/改进方向.md``docs/tech_graph/SPEC/json_graph/scheme_1_graph_json.md``ai-ink-brain-api-python/docs/tech_graph/gate_a_scheme1_backend.md``ai-ink-brain-api-python/docs/tech_graph/gate_a_scheme1_perf_compare_backend_detail.md` |
14+
15+
**给下一棒**:本 R3 为 **终局签收** 轮次;全文真值在本文件。若仅追溯 R2 元信息表内「关联 task」仍写 `active/` 路径,以 **本表「关联 task」+ 仓库 `done/` 实际路径** 为准(历史审查快照不覆盖当前真值)。
16+
17+
---
18+
19+
## 审查结论摘要
20+
21+
- **相对 R2 的闭合情况**:R2 所列 **阻塞组**(§4.2「PR / CI」「归档」未勾;头部 `draft`;§10「PR / commit」未填)在 **当前 task 正文** 已全部 **回填并勾选**;头部 **`状态`****`done(2026-05-15 验收通过)`****`### 实现备忘`**「PR / commit」已写明 **`PR #28`**、merge **`2315937`**、tip **`47a6f9e`**,且明示 ****将 Actions run id 写入 **`freeze_id`** 行(与 R1/R2 约束一致)。
22+
- **仓库位置与索引**:task 文件位于 **`docs/tasks/done/`******滞留 `active/`);**`invoke_snapshot`** 已含需求帽与 **R2 审核** 两行路径;§11 修订记录与 **按审查回填** 段已链 **`...audit_R2_20260515.md`**,与 R2「回填清单」叙述一致。
23+
- **HARNESS_V2_PLAN §5**`test_strategy: recommended``test_strategy_note` 仍成对;`failure_paths` FP-A~I 表完整;**`freeze_id`** 仍为 `TECH_GRAPH_S1_FREEZE_20260514_V1_1_3`****夹带 CI run id。
24+
- **非阻塞备注**:R1/R2 审查 md 元信息表中「关联 task」曾写 `active/...`,属 **历史落盘路径****签收真值**以本 R3 元信息及 **`done/`** 目录为准。若团队希望历史审查文件与现路径一致,可 **另开** 纯文档勘误(****构成本单 Harness 阻塞)。
25+
26+
---
27+
28+
## 阻塞 / 非阻塞
29+
30+
| 类型 || 说明 |
31+
|------|-----|------|
32+
| **非阻塞** | R2 元信息「关联 task」写 `active/` | 当前仓库真值为 **`done/`**;本 R3 已写清关联路径。 |
33+
| **非阻塞** | invoke 正文文件部分仅存工作区 `Projects/docs/harness/invokes/` | task 已用工作区相对路径链需求帽 / R2;本帽 **invoke_snapshot** 已落盘于 **本仓** `docs/harness/invokes/`|
34+
| **阻塞** || ****(相对 R2 回填清单已全部闭合)。 |
35+
36+
---
37+
38+
## 需任务帽 / 维护者回填清单
39+
40+
- ****(R2 清单项已完成;后续若 **打回** 再按 task §11 与 `docs/tasks/README.md` 走勘误 + 新一轮审查)。
41+
42+
---
43+
44+
## 是否建议执行帽开工
45+
46+
**否。** 本 task 已 **`done`** 且文档与归档闭环已完成;****建议再以本单名义指示执行帽做 **新业务实现**。若产品启用 §3.2 浏览器向采数,应按 task **非范围** 另立 **前端 / 产品 task** 后再动。
47+
48+
---
49+
50+
## 签收 / 关闭
51+
52+
本 R3 声明:在 **`main`****`PR #28`** 合入、归档提交 **`c388920`** 已推送、且 task 位于 **`docs/tasks/done/`** 与头部 **`done(2026-05-15 验收通过)`**、§4.2 **全勾**、§10 **已填** 的前提下,**`task_engineering_tech_graph_gate_a_perf_compare_v1` 可作 Harness 终局签收关闭**;与 `docs/harness/reviews/README.md`「签收以落盘审查为准」一致。
53+
54+
---
55+
56+
## 下一棒可复制 Prompt
57+
58+
```text
59+
(本单已终局签收)若后续发现 task 与仓库事实漂移(例如 §4.2 误勾、文件未在 `done/`、`_views` 双轨):由任务帽按 `ai-ink-brain-api-python/docs/tasks/README.md` 修正,并在 task §11 追加一行 **「R4 打回原因」** 后,复制 `docs/harness/prompts/TEMPLATE-task-audit-invoke.md` §3 发起 **任务审核帽 R4**(`{{PREV_REVIEW_PATH_OR_NONE}}` 填 `ai-ink-brain-api-python/docs/harness/reviews/task_engineering_tech_graph_gate_a_perf_compare_v1_audit_R3_20260515.md`;`{{TASK_PATHS}}` 填当前 task 真值路径)。
60+
61+
若产品确认需用户页大图谱 Mermaid 并启用父文档 §3.2:**勿**以本已关闭 task 名义扩写浏览器主结论;请 **另开** `ai-ink-brain` 前端 task + 产品确认链后,再更新父文档 **§3.2 N/A** 策略与采数 task。
62+
```

0 commit comments

Comments
 (0)