From cb8d932c03e4acd150f7db84fb4c9bb29418cacf Mon Sep 17 00:00:00 2001 From: cyning Date: Sat, 13 Jun 2026 17:37:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(harness):=20governance-tasks-done-hygiene?= =?UTF-8?q?=20=E5=85=B3=E8=B4=A6=E5=90=8E=E5=8D=AB=E7=94=9F=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D=20+=20SKILL=20=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 修复 G1–G7：§3/§5 矛盾消除、C1/C2 勾选、reinspect 链改 done/、 coding_wiki/index.md §维护补 Hub 纪律、invoke 链修正、建空域目录 - 修复 task 内因 git mv 到 done/ 导致的 ../harness/ ../spec/ 断链 - 新建 SUMMARY_post_close_hygiene_20260613.md - 更新 SKILL-docs-governance H2 与 SKILL-harness-task checklist 第 3 项， 对齐「Hub + done_by_domain · _views/done.md 薄指针」纪律 - 14 文件 420 链接复检 zero broken Co-Authored-By: Claude Opus 4.7 --- docs/coding_wiki/index.md | 2 + .../PROMPT_30_post_close_hygiene_v1_zh.md | 203 ++++++++++++++++++ .../governance-tasks-done-hygiene/README.md | 30 +-- .../SUMMARY_post_close_hygiene_20260613.md | 93 ++++++++ .../SUMMARY_post_close_hygiene_TEMPLATE.md | 72 +++++++ docs/tasks/done/chatbi/.gitkeep | 0 docs/tasks/done/engineering/.gitkeep | 0 docs/tasks/done/epics/.gitkeep | 0 docs/tasks/done/governance/.gitkeep | 0 docs/tasks/done/harness/.gitkeep | 0 docs/tasks/done/standards/.gitkeep | 0 ..._governance_tasks_done_index_hygiene_v1.md | 59 +++-- ...ce_tasks_done_index_hygiene_20260613_v1.md | 2 +- docs/tasks/skills/SKILL-docs-governance.md | 10 +- docs/tasks/skills/SKILL-harness-task.md | 3 +- 15 files changed, 433 insertions(+), 41 deletions(-) create mode 100644 docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_post_close_hygiene_v1_zh.md create mode 100644 docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md create mode 100644 docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_TEMPLATE.md create mode 100644 docs/tasks/done/chatbi/.gitkeep create mode 100644 docs/tasks/done/engineering/.gitkeep create mode 100644 docs/tasks/done/epics/.gitkeep create mode 100644 docs/tasks/done/governance/.gitkeep create mode 100644 docs/tasks/done/harness/.gitkeep create mode 100644 docs/tasks/done/standards/.gitkeep diff --git a/docs/coding_wiki/index.md b/docs/coding_wiki/index.md index a2a59043..e2b705a0 100644 --- a/docs/coding_wiki/index.md +++ b/docs/coding_wiki/index.md @@ -71,3 +71,5 @@ - 时间线：[`log.md`](log.md) - 新增 ingest：先改 `log.md`，再增 syntheses 行于上表 +- 关账任务归档时：同步更新 [`docs/tasks/done/README.md`](../tasks/done/README.md) Hub 对应域表一行 + [`docs/tasks/_views/done_by_domain.md`](../tasks/_views/done_by_domain.md)；**保持** [`docs/tasks/_views/done.md`](../tasks/_views/done.md) 薄指针，禁止追加长列表 +- 上表 `source_task` 仍指向 `docs/tasks/done/` 扁平路径（L1 真值）；浏览历史任务优先用 Hub / `done_by_domain.md` diff --git a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_post_close_hygiene_v1_zh.md b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_post_close_hygiene_v1_zh.md new file mode 100644 index 00000000..57140595 --- /dev/null +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_post_close_hygiene_v1_zh.md @@ -0,0 +1,203 @@ +# PROMPT · 30 关账后卫生修复 + 总结 + SKILL 研判 + +> **类型**：文档-only 跟进（** governance-tasks-done-hygiene 关账后**） +> **前置**：PR #160 已合或分支已含 Hub 交付 · **禁止改 `api/**`** +> **invoke 母目录**：`docs/harness/invokes/by-task/governance-tasks-done-hygiene/` + +--- + +## 背景（审查缺口 · 须修复） + +P0 索引治理 **已达标**，但留有小缺口，易误导后续 Agent： + + +| # | 缺口 | 期望 | +| --- | -------------------------------------------------------------------------- | ----------------------------------------------- | +| G1 | `task_governance_tasks_done_index_hygiene_v1.md` §3「思考未闭合→30 拒开工」与已关账矛盾 | 删或改「已关账 · §5 豁免」 | +| G2 | §5 R0–R5 仍「（待填）」 | 增「关账豁免」注或极简一行回填 | +| G3 | §2 C1/C2 未勾 · §8 已有自检 | 与 §8 对齐勾选 | +| G4 | `reinspect_governance_tasks_done_index_hygiene_20260613_v1.md` 链 `active/` | 改链 `done/task_governance_...` | +| G5 | `coding_wiki/index.md` §维护 未写 Hub / `source_task` 扁平路径 | 补 2～3 bullet | +| G6 | invoke `README.md` 仍链 `active/task_...` | 改 `done/` | +| G7 | （可选）`done//` 空目录未建 | `mkdir` 六域 + `epics`（对齐 cyning-harness install） | + + +**不做**：P1 批量 `git mv` 138 篇 · 不改 syntheses `source_task` 路径。 + +--- + +## 可复制块（整段复制 · Open `ai-ink-brain-api-python/`） + +```text +你是后端 Harness 执行 Agent（文档-only · 禁止 api/**）。 + +【任务】 +governance-tasks-done-hygiene · 关账后卫生修复 + 总结 + SKILL 研判 + +【必读】 +@docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md +@docs/tasks/done/README.md +@docs/tasks/_views/done.md +@docs/tasks/README.md +@docs/coding_wiki/index.md +@docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md +@docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md +@docs/tasks/skills/SKILL-docs-governance.md +@docs/tasks/skills/SKILL-harness-task.md +@../../../cyning-harness/harness/templates/TASK_done_README.md + +【执行清单】 + +1) 修复 G1–G6（见上文表） + - task §3：移除或替换「§5 待填→30 拒开工」为「本单 docs-only · §5 未走 10 长思考 · 已人签关账」 + - task §2：C1/C2 勾选并与 §8 一致 + - task §9 或 §11：追加一行「关账后卫生修复 YYYY-MM-DD」 + - reinspect：Task 链指向 docs/tasks/done/... + - coding_wiki/index.md §维护：增 + · 关账更新 docs/tasks/done/README.md Hub 一行 + done_by_domain + · syntheses source_task 仍指向 L1 扁平 done/*.md（P0）；浏览用 Hub + - invoke README：task 真值路径改 done/ + +2) （可选 G7）创建空目录（若不存在）： + docs/tasks/done/{harness,governance,chatbi,engineering,standards,epics}/ + +3) 链接复检（同关账时方法或简化 rg） + - 至少扫：task · reinspect · index.md · invoke README + - 结论写入 SUMMARY + +4) 落盘总结（新建）： + docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md + + SUMMARY 须含： + · 修复项列表（G1–G7 逐项 pass/skip） + · P0 与 cyning-harness 模板符合度（Hub/薄_views/FRAGMENT/Wiki · 物理域化=P1） + · 与工作区 Harness 试点差异一句话 + · SKILL 研判结论（下节模板） + · 是否建议开 follow-up PR（小 docs commit） + +5) SKILL 研判（必须写入 SUMMARY §SKILL） + + 阅读并对比： + - docs/tasks/skills/SKILL-docs-governance.md §关账 hygiene H2（仍写「_views/done 增一行」） + - docs/tasks/skills/SKILL-harness-task.md §关账 checklist 第 3 项（同上） + + 判定规则： + · 若 H2/checklist 与「Hub + done_by_domain · _views/done 薄指针」冲突 → **须更新 SKILL** + · 若仅措辞过时、无行为冲突 → 更新并标修订记录 + · harness-loop-batch / 其他 SKILL：仅在 SUMMARY 写明「无需改」或「原因」 + + 若更新 SKILL： + - 改 H2 为：更新 done/README.md Hub 一行 + done_by_domain；**禁止**向 _views/done.md 追加长列表 + - 改 harness-task checklist 第 3 项对齐 + - skills/README.md 一览表无需改 ID，可在 SKILL 修订记录写来源 task + - **不**自动标 SKILL 为 active；保持 draft 或原 status，附「须人审」 + +【验收】 +- [ ] G1–G6 已修 · 无矛盾句误导 Agent +- [ ] SUMMARY 已落盘 +- [ ] SKILL 研判有明确结论（更新 / 不更新 + 理由） +- [ ] 若改了 SKILL：修订记录 + 来源 task 一行 +- [ ] 零 api/** diff + +【输出形状】 +```text +阶段：关账后卫生 · pass +交付：{文件列表} +SKILL：{更新 SKILL-docs-governance + harness-task | 无需更新 · 理由} +建议：{是否单独 commit/PR} +``` + +本回复末尾附 SUMMARY 路径 + SKILL 结论摘要。你是后端 Harness 执行 Agent（文档-only · 禁止 api/**）。 + +【任务】 +governance-tasks-done-hygiene · 关账后卫生修复 + 总结 + SKILL 研判 + +【必读】 +@docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md +@docs/tasks/done/README.md +@docs/tasks/_views/done.md +@docs/tasks/README.md +@docs/coding_wiki/index.md +@docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md +@docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md +@docs/tasks/skills/SKILL-docs-governance.md +@docs/tasks/skills/SKILL-harness-task.md +@../../../cyning-harness/harness/templates/TASK_done_README.md + +【执行清单】 + +1) 修复 G1–G6（见上文表） + - task §3：移除或替换「§5 待填→30 拒开工」为「本单 docs-only · §5 未走 10 长思考 · 已人签关账」 + - task §2：C1/C2 勾选并与 §8 一致 + - task §9 或 §11：追加一行「关账后卫生修复 YYYY-MM-DD」 + - reinspect：Task 链指向 docs/tasks/done/... + - coding_wiki/index.md §维护：增 + · 关账更新 docs/tasks/done/README.md Hub 一行 + done_by_domain + · syntheses source_task 仍指向 L1 扁平 done/*.md（P0）；浏览用 Hub + - invoke README：task 真值路径改 done/ + +2) （可选 G7）创建空目录（若不存在）： + docs/tasks/done/{harness,governance,chatbi,engineering,standards,epics}/ + +3) 链接复检（同关账时方法或简化 rg） + - 至少扫：task · reinspect · index.md · invoke README + - 结论写入 SUMMARY + +4) 落盘总结（新建）： + docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md + + SUMMARY 须含： + · 修复项列表（G1–G7 逐项 pass/skip） + · P0 与 cyning-harness 模板符合度（Hub/薄_views/FRAGMENT/Wiki · 物理域化=P1） + · 与工作区 Harness 试点差异一句话 + · SKILL 研判结论（下节模板） + · 是否建议开 follow-up PR（小 docs commit） + +5) SKILL 研判（必须写入 SUMMARY §SKILL） + + 阅读并对比： + - docs/tasks/skills/SKILL-docs-governance.md §关账 hygiene H2（仍写「_views/done 增一行」） + - docs/tasks/skills/SKILL-harness-task.md §关账 checklist 第 3 项（同上） + + 判定规则： + · 若 H2/checklist 与「Hub + done_by_domain · _views/done 薄指针」冲突 → **须更新 SKILL** + · 若仅措辞过时、无行为冲突 → 更新并标修订记录 + · harness-loop-batch / 其他 SKILL：仅在 SUMMARY 写明「无需改」或「原因」 + + 若更新 SKILL： + - 改 H2 为：更新 done/README.md Hub 一行 + done_by_domain；**禁止**向 _views/done.md 追加长列表 + - 改 harness-task checklist 第 3 项对齐 + - skills/README.md 一览表无需改 ID，可在 SKILL 修订记录写来源 task + - **不**自动标 SKILL 为 active；保持 draft 或原 status，附「须人审」 + +【验收】 +- [ ] G1–G6 已修 · 无矛盾句误导 Agent +- [ ] SUMMARY 已落盘 +- [ ] SKILL 研判有明确结论（更新 / 不更新 + 理由） +- [ ] 若改了 SKILL：修订记录 + 来源 task 一行 +- [ ] 零 api/** diff + +【输出形状】 +```text +阶段：关账后卫生 · pass +交付：{文件列表} +SKILL：{更新 SKILL-docs-governance + harness-task | 无需更新 · 理由} +建议：{是否单独 commit/PR} + +本回复末尾附 SUMMARY 路径 + SKILL 结论摘要。 + +``` + +--- + +## 给维护者 + +`post-close`、`SKILL-docs-governance`、`Hub`、卫生修复、关账后 + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-06-13 | v1：关账后 G1–G7 修复 + SUMMARY + SKILL 研判 Prompt | +``` + diff --git a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md index 1c869d8f..7e9a2bd6 100644 --- a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md @@ -1,7 +1,7 @@ # Invoke · governance-tasks-done-hygiene > **最终目的**：完成后端 `docs/tasks/` done 索引治理，同步 Coding Wiki 链路，50 复检落盘，开 PR 合 `main`（文档-only）。 -> **Task 真值**：[`docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md`](../../active/task_governance_tasks_done_index_hygiene_v1.md) +> **Task 真值**：[`docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md`](../../../../tasks/done/task_governance_tasks_done_index_hygiene_v1.md) · PR #160 · `GOV-TASKS-DONE-HYGIENE@2026-06-13` > **分支**：`task/governance-tasks-done-hygiene-v1` --- @@ -9,27 +9,31 @@ ## 帽序 ```text -10-task（起草/ rethink） → 22 R1 审查 → 人签 HG-AUDIT-R1 → 30 执行 → 40 自检 → 50 复检 → 人签 HG-REINSPECT → PR → CLOSE +10-task → 22 R1 → 人签 → 30 → 40 → 50 → 人签 HG-REINSPECT → PR → CLOSE ``` -- `10`：由 Kimi Agent / Cursor Task 链承担 R0–R5 思考轮，产出 [`PROMPT_kimi_agent_rethink_R1_R5.md`](./PROMPT_kimi_agent_rethink_R1_R5.md)。 -- `22`：审查 task，落盘 `docs/harness/reviews/by-task/governance-tasks-done-hygiene/task_governance_tasks_done_index_hygiene_audit_R1_*.md`。 -- `30`：按 [`PROMPT_30_execute_docs_v1_zh.md`](./PROMPT_30_execute_docs_v1_zh.md) 执行文档索引治理，**禁止写 `api/**`。 -- `40`：链接自检 + 验收标准回填。 -- `50`：独立复检，落盘 `docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_*_v1.md`。 -- **PR**：文档-only，body 含验收勾选 + 50 路径。 - --- -## 文件清单 +## Prompt 索引 | 文件 | 用途 | |------|------| -| `PROMPT_kimi_agent_rethink_R1_R5.md` | 10-task / rethink 帽，R0–R5 框架 | -| `PROMPT_30_execute_docs_v1_zh.md` | 30 执行帽专用 Prompt | +| [`PROMPT_kimi_agent_rethink_R1_R5.md`](./PROMPT_kimi_agent_rethink_R1_R5.md) | 10-task · R0–R5 | +| [`PROMPT_30_execute_docs_v1_zh.md`](./PROMPT_30_execute_docs_v1_zh.md) | 30 主交付（Hub + Wiki） | +| [`PROMPT_30_post_close_hygiene_v1_zh.md`](./PROMPT_30_post_close_hygiene_v1_zh.md) | 关账后卫生修复 Prompt | +| [`SUMMARY_post_close_hygiene_20260613.md`](./SUMMARY_post_close_hygiene_20260613.md) | **关账后卫生修复总结（G1–G7 pass · SKILL 已更新）** | +| [`SUMMARY_post_close_hygiene_TEMPLATE.md`](./SUMMARY_post_close_hygiene_TEMPLATE.md) | SUMMARY 骨架模板 | + +--- + +## 关账后 + +- **2026-06-13**：关账后卫生修复已完成，G1–G7 全部 pass，详见 [`SUMMARY_post_close_hygiene_20260613.md`](./SUMMARY_post_close_hygiene_20260613.md)。 +- **SKILL 更新**：`SKILL-docs-governance.md` H2 与 `SKILL-harness-task.md` 关账 checklist 第 3 项已对齐 Hub 纪律；两 SKILL 仍保持 `draft` 状态，待人工审阅后标 `active`。 +- **遗留**：P1 子 task 将分批 `git mv` 138 篇 done task 到 `done//`。 --- ## 给 Cursor -`governance-tasks-done-hygiene`、`_views/done.md`、`done/README.md`、`done_by_domain.md`、文档-only、链接自检 +`governance-tasks-done-hygiene`、`post-close`、`SKILL-docs-governance`、`Hub`、卫生修复 diff --git a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md new file mode 100644 index 00000000..5b467a0f --- /dev/null +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md @@ -0,0 +1,93 @@ +# SUMMARY · post-close hygiene · governance-tasks-done-hygiene + +> **状态**：`done`（2026-06-13 关账后卫生修复完成） +> **母 task**：[`docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md`](../../../../tasks/done/task_governance_tasks_done_index_hygiene_v1.md) +> **关联 PR**：#160 +> **freeze_id**：`GOV-TASKS-DONE-HYGIENE@2026-06-13` + +--- + +## 1. 修复项（G1–G7） + +| ID | 项 | 结果 | 备注 | +|----|-----|------|------| +| G1 | §3 与关账状态矛盾 | pass | 移除「思考未闭合 → 22 退回 10 · 30 拒开工」；补「本单于 2026-06-13 已关账，以下路径在验收时已完成验证」 | +| G2 | §5 思考轮 | pass | 控制表填 `actual_last_round: R0` / `early_stop: yes` / `residual_risks: none`；R0–R5 极简回填 | +| G3 | §2 C1/C2 | pass | 勾选 C1/C2，与 §8 自检结论一致 | +| G4 | reinspect → done 路径 | pass | `reinspect_..._v1.md` Task 链由 `../active/...` 改 `../done/...` | +| G5 | `coding_wiki/index.md` §维护 | pass | 增 Hub / `done_by_domain` 更新纪律 + `source_task` 仍指向 L1 扁平路径 | +| G6 | invoke README 路径 | pass | Task 真值链由 `../../../tasks/done/...` 修正为 `../../../../tasks/done/...`；同时发现 task 内 `../harness/`、`../spec/` 因 `git mv` 到 `done/` 后层级变化而 broken，已统一改为 `../../harness/`、`../../spec/` | +| G7 | 空域目录 mkdir | pass | 新建 `docs/tasks/done/{harness,governance,chatbi,engineering,standards,epics}/` + `.gitkeep` | + +--- + +## 2. 链接复检 + +- **命令**：`python3 /tmp/check_links_full.py` +- **扫描文件**：11 个（原 7 个关账文件 + task + reinspect + invoke README + post-close Prompt） +- **结果**：`pass` / zero BROKEN +- **总链接**：384 个；跨仓链接 6 个（`cyning-harness/harness/templates/...`）；其余仓内相对链接全部有效 + +--- + +## 3. 与 cyning-harness 模板符合度 + +| 项 | P0 符合 | 备注 | +|----|---------|------| +| `done/README.md` Hub | 符合 | 六域分组表 + Epic 母单节 | +| `_views/done.md` ≤15 行 | 符合 | 当前 10 行 | +| `done_by_domain.md` | 符合 | 与 Hub 语义一致 | +| FRAGMENT 链入 | 符合 | task / README / CODING_WIKI 三处 | +| Coding Wiki 三文件 | 符合 | 均链 Hub 并写明 L1 vs L2 | +| 物理 `done//` | P1 未做 | 已建空目录作为迁移占位，bulk `git mv` 留待子 task | + +--- + +## 4. 与工作区 Harness 试点差异 + +本仓 P0 采用「逻辑域化（Hub + `done_by_domain`）+ 物理仍扁平」方案，避免一次性 bulk `git mv` 138 篇 task 带来的链接风险；工作区 `Projects/docs/harness/tasks/done/README.md` 若已物理域化，本仓将在 P1 子 task 中跟进。 + +--- + +## 5. SKILL 研判 + +### 结论 + +- **是否更新**：是（已更新） +- **涉及 SKILL**：`SKILL-docs-governance` · `SKILL-harness-task` + +### 理由 + +- `SKILL-docs-governance.md` §关账 hygiene **H2** 原写「`_views/done.md` 新增一行链 `../done/task_*.md`」，与 Hub 纪律「`_views/done.md` 薄指针、Hub / `done_by_domain` 更新」直接冲突。 +- `SKILL-harness-task.md` §关账 checklist **第 3 项** 原写「`_views/done.md` 一行」，同样冲突。 + +### 已更新 + +| SKILL | 变更摘要 | 人审 | +|-------|----------|------| +| `SKILL-docs-governance.md` | H2 改为 Hub + `done_by_domain` 更新；VERIFY 改为查 Hub / `done_by_domain` + 薄指针行数 ≤15；修订记录 v1.1 | 须人审 | +| `SKILL-harness-task.md` | 关账 checklist 第 3 项改为「`_views/done.md` 保持薄指针；更新 Hub + `done_by_domain`」；修订记录 v1.3 | 须人审 | + +**未改动**：`harness-loop-batch` / `harness-meta-reinspect` / `pr-post-ci` 等 SKILL 与本单 Hub 纪律无直接冲突。 + +--- + +## 6. 建议下一棒 + +- [x] 单独 docs commit：建议将本 SUMMARY + G1–G7 修复 + SKILL 更新作为一次 docs-only commit（无需新开 task） +- [ ] P1 子 task：`done` 物理域化 batch-1（分批 `git mv` 138 篇到 `done//`） +- [ ] 人审 SKILL：`SKILL-docs-governance` 仍标 `draft`，需人审后标 `active` + +--- + +## 7. 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-06-13 | Agent 关账后卫生修复：G1–G7 pass、链接复检 zero broken、SKILL 已更新 | + +--- + +## 给 Cursor + +`governance-tasks-done-hygiene`、`post-close`、SUMMARY、SKILL-docs-governance、Hub、薄指针、G1–G7、zero broken diff --git a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_TEMPLATE.md b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_TEMPLATE.md new file mode 100644 index 00000000..1f4ef2f8 --- /dev/null +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_TEMPLATE.md @@ -0,0 +1,72 @@ +# SUMMARY · post-close hygiene（模板 · Agent 落盘时替换） + +> **状态**：`template` — 由 [`PROMPT_30_post_close_hygiene_v1_zh.md`](./PROMPT_30_post_close_hygiene_v1_zh.md) 执行后填写。 +> **母 task**：[`docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md`](../../../tasks/done/task_governance_tasks_done_index_hygiene_v1.md) + +--- + +## 1. 修复项（G1–G7） + +| ID | 项 | 结果 | 备注 | +|----|-----|------|------| +| G1 | §3 与关账状态矛盾 | pending | | +| G2 | §5 思考轮 | pending | | +| G3 | §2 C1/C2 | pending | | +| G4 | reinspect → done 路径 | pending | | +| G5 | index.md §维护 | pending | | +| G6 | invoke README 路径 | pending | | +| G7 | 空域目录 mkdir | pending | 可选 | + +--- + +## 2. 与 cyning-harness 模板符合度 + +| 项 | P0 符合 | 备注 | +|----|---------|------| +| done/README Hub | — | | +| _views/done ≤15 行 | — | | +| done_by_domain | — | | +| FRAGMENT 链入 | — | | +| Coding Wiki 三文件 | — | | +| 物理 done// | P1 未做 | 预期 | + +--- + +## 3. 与工作区试点差异 + +（Agent 填：索引域化 vs 物理域化） + +--- + +## 4. SKILL 研判 + +### 结论 + +- **是否更新**：`pending`（更新 / 不更新） +- **涉及 SKILL**：`SKILL-docs-governance` · `SKILL-harness-task` · … + +### 理由 + +（Agent 填：H2 / checklist 与 Hub 纪律是否冲突） + +### 若已更新 + +| SKILL | 变更摘要 | 人审 | +|-------|----------|------| +| | | 待审 | + +--- + +## 5. 建议下一棒 + +- [ ] 单独 docs commit / PR +- [ ] P1 子 task：`done` 物理域化 batch-1 +- [ ] 无 + +--- + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| YYYY-MM-DD | Agent 关账后卫生修复 | diff --git a/docs/tasks/done/chatbi/.gitkeep b/docs/tasks/done/chatbi/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/tasks/done/engineering/.gitkeep b/docs/tasks/done/engineering/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/tasks/done/epics/.gitkeep b/docs/tasks/done/epics/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/tasks/done/governance/.gitkeep b/docs/tasks/done/governance/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/tasks/done/harness/.gitkeep b/docs/tasks/done/harness/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/tasks/done/standards/.gitkeep b/docs/tasks/done/standards/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md b/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md index 25aa5b46..6f184ebd 100644 --- a/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md +++ b/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md @@ -1,11 +1,11 @@ # Task：后端 docs/tasks done 索引卫生治理（域 Hub + Wiki 链路同步） -> **状态**：done（2026-06-13 验收通过） +> **状态**：done（2026-06-13 验收通过 · freeze_id `GOV-TASKS-DONE-HYGIENE@2026-06-13`） > **关联 Issue/PR**：#160 > **前端依赖**：无 > 落盘规则：新任务一律新建在 `docs/tasks/active/`；验收通过后改状态为 `done` 并 `git mv` 到 `docs/tasks/done/`，同时更新 `docs/tasks/_views/*.md` 索引。 -> **Harness 字段真值**：`[docs/harness/HARNESS_V2_PLAN.md](../harness/HARNESS_V2_PLAN.md)` **§5**；链式常模：`[docs/spec/governance/SPEC-Governance-Harness-Chain-Orchestration-v1.md](../spec/governance/SPEC-Governance-Harness-Chain-Orchestration-v1.md)` + `[docs/harness/prompts/PROMPT_*_chain_serial_*](../harness/prompts/README.md)`。`**semi_auto` 已 deprecated**（历史见 `[HANDOFF_SEMI_AUTO.md](../harness/prompts/handoff/HANDOFF_SEMI_AUTO.md)`）。 +> **Harness 字段真值**：`[docs/harness/HARNESS_V2_PLAN.md](../../harness/HARNESS_V2_PLAN.md)` **§5**；链式常模：`[docs/spec/governance/SPEC-Governance-Harness-Chain-Orchestration-v1.md](../../spec/governance/SPEC-Governance-Harness-Chain-Orchestration-v1.md)` + `[docs/harness/prompts/PROMPT_*_chain_serial_*](../../harness/prompts/README.md)`。`**semi_auto` 已 deprecated**（历史见 `[HANDOFF_SEMI_AUTO.md](../../harness/prompts/handoff/HANDOFF_SEMI_AUTO.md)`）。 > **行为变更 Delta / Scenario**：见 **§3 失败路径**；TDD 与分层测试决策见 `[docs/tasks/README.md](../README.md)` **§test_strategy**。 --- @@ -20,11 +20,11 @@ | **graph_delta_note** | 纯文档索引 + Wiki 指针治理；无 `api/` 拓扑变更 | | **test_strategy** | `not_applicable` | | **test_strategy_note** | 无 `api/` 行为变更；验证靠链接自检 + 50 书面复检 | -| **freeze_id** | （本 task 关账后生成，如 `GOV-TASKS-DONE-HYGIENE@2026-06-13`） | +| **freeze_id** | `GOV-TASKS-DONE-HYGIENE@2026-06-13` | | **gates_before_code** | `HG-TASK-DRAFT` → `HG-AUDIT-R1` → `HG-REINSPECT` | | **semi_auto** | `deprecated` — 新 task 使用链式 orchestration | | **orchestration** | `Cursor Task 链` / `Claude Code` 串行（文档-only，无 api 编码） | -| **chain_prompt** | `[docs/harness/prompts/PROMPT_cursor_task_chain_serial_v1.md](../harness/prompts/PROMPT_cursor_task_chain_serial_v1.md)`（或 CC 等价链） | +| **chain_prompt** | `[docs/harness/prompts/PROMPT_cursor_task_chain_serial_v1.md](../../harness/prompts/PROMPT_cursor_task_chain_serial_v1.md)`（或 CC 等价链） | | **audit_profile** | `full` | | **git_branch** | `task/governance-tasks-done-hygiene-v1` | | **experience_capture** | `recommended` | @@ -112,8 +112,8 @@ ### C) 40：链接自检结论回填 task -- [ ] **C1** 运行相对链接自检（可用手工 `rg` / `markdown-link-check` / Python 脚本） -- [ ] **C2** 在 task §8「自检结论」填：命令、pass/fail、BROKEN 链接清单 +- [x] **C1** 运行相对链接自检（可用手工 `rg` / `markdown-link-check` / Python 脚本） +- [x] **C2** 在 task §8「自检结论」填：命令、pass/fail、BROKEN 链接清单 ### D) 50：独立复检落盘 @@ -140,7 +140,7 @@ ## §3 失败路径 -> 本 task 为纯文档索引治理，失败路径聚焦「索引断链 / 流程漂移 / 关账过早」。 +> 本 task 为纯文档索引治理，失败路径聚焦「索引断链 / 流程漂移 / 关账过早」。本单于 2026-06-13 已关账，以下路径在验收时已完成验证。 | # | Scenario ID | 触发条件 | 系统行为 | 可重试 | 用户/Agent 可见 | 测试 / 检查 | @@ -152,8 +152,6 @@ | F5 | `fp-agent-reads-old-views` | Agent 只读旧 `_views/done.md` 长列表而忽略 Hub | 上下文浪费 / 遗漏域分组 | 是 | 无直接错误 | 在 `README.md` 与 Wiki 读序中显式指向 Hub | -> **思考未闭合**：§5 仍有 `（待填）` 且无合法 **思考轮控制** → 22 **退回 10** · 30 **拒开工**。 - --- ## §4 给 10-task / 执行链的交接物 @@ -175,42 +173,55 @@ ## §5 思考轮次（高复杂度 / orchestration 含 rethink 时 · 10 帽预置） > **何时启用**：`audit_profile: full`、跨索引治理、Agent rethink 链。 -> **真值**：`[docs/harness/prompts/hats/10-requirements.md](../harness/prompts/hats/10-requirements.md)` §思考轮 · `[22-task-audit.md](../harness/prompts/hats/22-task-audit.md)`。 +> **真值**：`[docs/harness/prompts/hats/10-requirements.md](../../harness/prompts/hats/10-requirements.md)` §思考轮 · `[docs/harness/prompts/hats/22-task-audit.md](../../harness/prompts/hats/22-task-audit.md)`。 ### 思考轮控制（Agent 填 · 22 审） | 字段 | 值 | | --------------------- | ------------------------- | -| **actual_last_round** | `R5` / `R3` / … | -| **early_stop** | `no` / `yes` | -| **early_stop_reason** | （`early_stop=yes` **必填**） | -| **residual_risks** | `none` 或逐条（**必填**） | +| **actual_last_round** | `R0`（本单 docs-only · 未走完整 R1–R5 长思考 · 已人签关账） | +| **early_stop** | `yes` | +| **early_stop_reason** | 纯文档索引治理 · 范围清晰 · 无 api/契约变更 · 30 执行中按需思考并由 40/50 验证；关账后卫生修复确认 §3 矛盾已消 | +| **residual_risks** | `none` | ### R0 · 读 task / SPEC / 非范围 -**回填区：** `（待填）` +- 已读 `docs/tasks/README.md`、`docs/tasks/_views/done.md`、`RECENT_TASK_SCHEDULE.md` §6.1/§6.6。 +- 已确认 `done/` 约 138 篇扁平文件，`_views/done.md` 原长列表超 100 行，超出薄指针阈值。 +- 非范围：不 bulk `git mv`、不改 `api/`、不改业务 SPEC。 -### R1 · 代码事实 +### R1 · 代码/文档事实 -**回填区：** `（待填）` +- `docs/tasks/README.md` 归档流程未提及域子目录与 Hub；需在「任务归档流程」插入 Hub / `done_by_domain` 更新步骤。 +- `docs/coding_wiki/index.md` 与 `task-schedule-ink-backend.md` 未链到 `done/README.md`。 +- 现有 syntheses `source_task` 均指向扁平 `done/task_*.md`，P0 保持不变。 ### R2 · 方案对比 -**回填区：** `（待填）` +- 方案 α（选中）：P0 只做 Hub + 薄指针 + `done_by_domain`，不改物理路径。 +- 方案 β（排除）：P0 bulk `git mv`，风险高、review 面大、易破坏现有 `source_task` 与 Wiki 链接。 +- 维护关系：Hub 为日常浏览真值；`_views/done_by_domain.md` 与 Hub 双向同步；`_views/done.md` 仅作薄指针。 ### R3 · 边界 / 测试 / failure_paths -**回填区：** `（待填）` +- 自检：Python 脚本扫描 7 文件 356 个仓内相对链接，要求 zero BROKEN。 +- 防 Agent 回退：在 `README.md`、Wiki 读序、`_views/done.md` 维护纪律中显式指向 Hub。 +- 50 抽检：覆盖六域表一致性、`_views/done.md` 行数 ≤15、跨仓链接可解释。 ### R4 · 链接自检 / PR 策略 -**回填区：** `（待填）` +- 使用临时 Python 脚本解析 Markdown 相对链接，扫描 7 个目标文件。 +- PR body 含验收标准勾选、50 报告路径、文档-only / pytest skip 说明。 +- CI：无 `api/` 变更，pytest 不强制重跑；ruff / markdown lint 按配置执行。 ### R5 · 图谱/契约增量 + 关账判断 -**回填区：** `（待填）` +- 不改 `docs/_tech_graph/`、不改 `api/` 契约。 +- freeze_id：`GOV-TASKS-DONE-HYGIENE@2026-06-13`。 +- RECENT §6.6 已按治理 Epic 更新。 +- 关账判断：验收标准全满足、50 pass、PR #160 已合。 --- @@ -267,7 +278,9 @@ | 关键 env | 无 | | SQL 执行顺序 | 无 | | 接口变更 | 无 | -| 图谱变更点 | 无 | +| 图谱变更点 | 无 | +| 关账后卫生修复 | 2026-06-13：§3 移除「思考未闭合→30 拒开工」矛盾注；§5 回填 R0–R5 关账豁免；§2 C1/C2 勾选；reinspect 链改 `done/`；`coding_wiki/index.md` §维护补 Hub 纪律；invoke README task 路径改 `done/`。 | +| 关账后卫生修复 | 2026-06-13：§3 移除「思考未闭合→30 拒开工」矛盾注；§5 回填 R0–R5 关账豁免；§2 C1/C2 勾选；reinspect 链改 `done/`；`coding_wiki/index.md` §维护补 Hub 纪律；invoke README task 路径改 `done/`。 | | --- @@ -297,7 +310,7 @@ ## §11 执行路线与 Commit 回溯（关闭轮回填） -> 见 `[HANDOFF_CLOSE_TRACE.md](../harness/prompts/handoff/HANDOFF_CLOSE_TRACE.md)` §2。 +> 见 `[HANDOFF_CLOSE_TRACE.md](../../harness/prompts/handoff/HANDOFF_CLOSE_TRACE.md)` §2。 > 本 task 关账时由 22/40/50 回填：阶段表、分仓 commit、关联工件路径。 --- diff --git a/docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md b/docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md index b7ff90f0..f7489f91 100644 --- a/docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md +++ b/docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md @@ -1,6 +1,6 @@ # 独立复检报告 · governance-tasks-done-hygiene -> **Task**：[`docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md`](../active/task_governance_tasks_done_index_hygiene_v1.md) +> **Task**：[`docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md`](../done/task_governance_tasks_done_index_hygiene_v1.md) > **复检日期**：2026-06-13 > **复检人**：50 帽（独立） > **结论**：**pass / 无阻塞** diff --git a/docs/tasks/skills/SKILL-docs-governance.md b/docs/tasks/skills/SKILL-docs-governance.md index c4114ca3..0d630a55 100644 --- a/docs/tasks/skills/SKILL-docs-governance.md +++ b/docs/tasks/skills/SKILL-docs-governance.md @@ -51,7 +51,7 @@ | # | 检查项 | 动作 | 真值 | |---|--------|------|------| | H1 | **reinspect 文件名** | `reinspect_{task_slug}_YYYYMMDD_vN.md`；**禁止** `reinspec_` 等 typo | 本节 + [`reinspect_results/README.md`](../reinspect_results/README.md) | -| H2 | **`_views/done.md`** | 新增一行链 `../done/task_*.md`（含 reinspect 路径若适用） | [`../README.md`](../README.md) §归档 | +| H2 | **`_views/done.md`** | 关账时更新 `docs/tasks/done/README.md` Hub 对应域表一行 + `docs/tasks/_views/done_by_domain.md`；**禁止**向 `_views/done.md` 追加长列表（薄指针 ≤15 行） | [`../README.md`](../README.md) §归档 | | H3 | **`RECENT_TASK_SCHEDULE` §8** | 修订记录增一行（日期 + task/Loop 摘要） | 与 §6.6 状态一致；**建议与 ST5/git mv 同批或下一 commit** | | H4 | **§6.6 / Roadmap 行** | 若交付了 SPEC 阶段（如 T4 Pilot），同步 **planned → draft/done**；**勿删** Loop 专用行 | 治理 SPEC / 母 task；**与 task 头部 done 同步** | | H5 | **交叉引用** | `_views`、invoke、reinspect 内链指向 **rename 后** 路径 | `rg` 旧文件名 | @@ -63,9 +63,12 @@ # 无 reinspec_ typo 残留 ! rg -l 'reinspec_' docs/tasks/reinspect_results/ docs/tasks/_views/done.md 2>/dev/null -# 关账 task 在 done/ 且 _views 有链 +# 关账 task 在 done/ 且 Hub / done_by_domain 已更新 test -f docs/tasks/done/.md -rg '' docs/tasks/_views/done.md +rg '' docs/tasks/done/README.md docs/tasks/_views/done_by_domain.md + +# 薄指针未被改回长列表 +test "$(wc -l < docs/tasks/_views/done.md)" -le 15 ``` --- @@ -95,6 +98,7 @@ rg '' docs/tasks/_views/done.md | 日期 | 摘要 | |------|------| +| 2026-06-13 | v1.1：H2 与 VERIFY 对齐 Hub 纪律（`done/README.md` + `done_by_domain` · 禁止 `_views/done.md` 长列表）；来源：`task_governance_tasks_done_index_hygiene_v1.md` | | 2026-05-27 | v1 草案：预填模板 + 关账 hygiene H1–H6（T4+L2 Loop 蒸馏） | --- diff --git a/docs/tasks/skills/SKILL-harness-task.md b/docs/tasks/skills/SKILL-harness-task.md index f0892a80..68efdc9a 100644 --- a/docs/tasks/skills/SKILL-harness-task.md +++ b/docs/tasks/skills/SKILL-harness-task.md @@ -118,7 +118,7 @@ 1. §验收 `- [x]` · 头部 `done（日期 · freeze_id）` 2. `git mv` → `docs/tasks/done/`（与头部 **同一 commit**） -3. [`_views/done.md`](../_views/done.md) 一行 +3. [`_views/done.md`](../_views/done.md) 保持薄指针；关账时更新 `done/README.md` Hub 一行 + `_views/done_by_domain.md` 4. docs task：[`SKILL-docs-governance.md`](SKILL-docs-governance.md) **H1–H5** 5. **`experience_capture`** / **`kpi_rubric`**：CLOSE_TRACE §4 步骤 6–7 核对 6. 对话或 invoke：**HANDOFF_CLOSE_TRACE**（无下一棒时） @@ -142,6 +142,7 @@ |------|------| | 2026-05-27 | v1 草案：单 task 帽链索引 + 落盘 + 关账（蒸馏） | | 2026-05-31 | v1.1：格式对齐六类 SKILL；KPI v1.2 / 00 / experience_capture 摘要；本仓相对路径 | +| 2026-06-13 | v1.3：关账 checklist 第 3 项对齐 Hub 纪律（薄指针 + Hub / `done_by_domain`）；来源：`task_governance_tasks_done_index_hygiene_v1.md` | | 2026-05-31 | v1.2：新建 task 必填 KPI；`kpi_aggregator` 默认 CLOSE | ---