diff --git a/docs/coding_wiki/CODING_WIKI.md b/docs/coding_wiki/CODING_WIKI.md index b45b764b..799b50e4 100644 --- a/docs/coding_wiki/CODING_WIKI.md +++ b/docs/coding_wiki/CODING_WIKI.md @@ -63,12 +63,13 @@ pytest tests/test_coding_wiki_graph_nodes_lint.py -q 1. 仅 **done** task（或已 accepted 的 SPEC 摘要）进入 `syntheses/`。 2. 每页：**摘要**（背景、决策、验收要点）+ **wikilink** 至 L1；**禁止**复制 review/SPEC 全文。 3. 更新 `index.md` 与 `log.md`（`YYYY-MM-DD` 前缀行）。 -4. **进行中** task 仅可在 `log.md` 记一行，不写 `syntheses/`。 +4. 同步在 [`docs/tasks/done/README.md`](../tasks/done/README.md) Hub 对应域表追加一行，并更新 [`docs/tasks/_views/done_by_domain.md`](../tasks/_views/done_by_domain.md)。域推断见 [`FRAGMENT_task_domain_infer_v1_zh.md`](../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)。 +5. **进行中** task 仅可在 `log.md` 记一行，不写 `syntheses/`。 ### 4.2 Query 1. 先读 `index.md` → 按主题打开 1～3 页。 -2. **任务规划 / 开工前**：读 [`concepts/task-schedule-ink-backend`](concepts/task-schedule-ink-backend.md) 或 L1 [`RECENT_TASK_SCHEDULE.md`](../tasks/RECENT_TASK_SCHEDULE.md) §0·§1.1，再打开目标 `active/task_*.md`（排期真值 **不** 以 Wiki 替代 RECENT）。 +2. **任务规划 / 开工前**：读 [`concepts/task-schedule-ink-backend`](concepts/task-schedule-ink-backend.md) 或 L1 [`RECENT_TASK_SCHEDULE.md`](../tasks/RECENT_TASK_SCHEDULE.md) §0·§1.1；浏览历史 done task 优先用 [`docs/tasks/done/README.md`](../tasks/done/README.md) 域 Hub 或 [`_views/done_by_domain.md`](../tasks/_views/done_by_domain.md)。再打开目标 `active/task_*.md`（排期真值 **不** 以 Wiki 替代 RECENT）。 3. 若 frontmatter 含 `graph_nodes`：记下种子 `id`，对每个 id 执行 `python tools/tech_graph_graph_query.py neighbors `，再按需 `downstream`/`upstream`。 4. 需影响面/依赖遍历 → **并行** 使用 `graph_query`（L0），不以 Wiki 替代。 5. 答案可写回 Wiki 时：小改直接编辑；大改走新 task + 再 ingest。 diff --git a/docs/coding_wiki/concepts/task-schedule-ink-backend.md b/docs/coding_wiki/concepts/task-schedule-ink-backend.md index f18b67d2..3cd52200 100644 --- a/docs/coding_wiki/concepts/task-schedule-ink-backend.md +++ b/docs/coding_wiki/concepts/task-schedule-ink-backend.md @@ -24,9 +24,10 @@ graph_nodes: [] ## Agent 读序（规划 / 开工前） 1. 本页或 [`RECENT_TASK_SCHEDULE.md`](../../tasks/RECENT_TASK_SCHEDULE.md) §0 · §1.1 -2. 打开 1～3 个 `docs/tasks/active/task_*.md` -3. 若改接口/表/RPC → `python tools/tech_graph_graph_query.py` + `_manifest.json` -4. 若关账回顾 → [`index.md`](../index.md) → `syntheses/.md` → pointer L1 done task +2. 浏览历史 done task 优先用 [`docs/tasks/done/README.md`](../../tasks/done/README.md) Hub 或 [`_views/done_by_domain.md`](../../tasks/_views/done_by_domain.md)；L1 真值仍在 `done/task_*.md`，Hub 只改善浏览。 +3. 打开 1～3 个 `docs/tasks/active/task_*.md` +4. 若改接口/表/RPC → `python tools/tech_graph_graph_query.py` + `_manifest.json` +5. 若关账回顾 → [`index.md`](../index.md) → `syntheses/.md` → pointer L1 done task **禁止**：仅读本 Wiki 页推断排期或改 `api/`；与 RECENT 矛盾时 **L1 为准**。 @@ -107,6 +108,7 @@ graph_nodes: [] ## 链接 - 排期真值：[`RECENT_TASK_SCHEDULE.md`](../../tasks/RECENT_TASK_SCHEDULE.md) +- **done 任务 Hub**：[`docs/tasks/done/README.md`](../../tasks/done/README.md) · 分组表 [`_views/done_by_domain.md`](../../tasks/_views/done_by_domain.md) - Task 落盘规则：[`docs/tasks/README.md`](../../tasks/README.md) - P2 Loop SKILL：[`SKILL-harness-loop-batch.md`](../../tasks/skills/SKILL-harness-loop-batch.md) - 三方读序 smoke：[`conclusion_smoke_zh.md`](../../harness/experiments/task_schedule_read_smoke_v1/conclusion_smoke_zh.md) diff --git a/docs/coding_wiki/index.md b/docs/coding_wiki/index.md index 0b198027..a2a59043 100644 --- a/docs/coding_wiki/index.md +++ b/docs/coding_wiki/index.md @@ -52,6 +52,8 @@ | `governance-recent-schedule-wiki-sync` | [[syntheses/governance-recent-schedule-wiki-sync]] | `docs/tasks/done/task_governance_recent_schedule_wiki_sync_v1.md` | | `wiki-ctx-ab-multi-bq3-recheck` | [[syntheses/wiki-ctx-ab-multi-bq3-recheck]] | `docs/tasks/done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md` | +> **L1 真值说明**：上表 `source_task` 指向 `docs/tasks/done/` 扁平路径（task 文件本身）。浏览历史任务优先用 [`docs/tasks/done/README.md`](../tasks/done/README.md) 域 Hub 或 [`_views/done_by_domain.md`](../tasks/_views/done_by_domain.md)；Hub 只改善浏览，**不**替代 `source_task` 指向的 L1 真值。 + --- ## 治理与实验 diff --git a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_execute_docs_v1_zh.md b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_execute_docs_v1_zh.md new file mode 100644 index 00000000..94419b91 --- /dev/null +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_30_execute_docs_v1_zh.md @@ -0,0 +1,185 @@ +# PROMPT · 30 执行帽（governance-tasks-done-hygiene） + +> **阶段**：30 execute +> **目标**：按 task 范围完成 `docs/tasks/` done 索引治理 + Coding Wiki 链路同步，40 自检通过，为 50 复检做准备。 +> **约束**：**禁止写 `api/**`；禁止改业务代码；文档-only PR。** + +--- + +## 0. 开帽前检查 + +- [ ] `HG-TASK-DRAFT` 状态为 `approved` +- [ ] `HG-AUDIT-R1` 状态为 `approved` +- [ ] 已读 [`docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md`](../../active/task_governance_tasks_done_index_hygiene_v1.md) 全文 +- [ ] 已读本 Prompt 的「必读」与「执行清单」 + +若任一闸为 `pending`：立即停止，只输出阻塞的 `human_gate_id` 与文件路径。 + +--- + +## 1. 必读（按顺序） + +1. [`docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md`](../../active/task_governance_tasks_done_index_hygiene_v1.md) +2. [`docs/tasks/README.md`](../../../tasks/README.md) +3. [`docs/tasks/_views/done.md`](../../../tasks/_views/done.md) +4. [`docs/tasks/RECENT_TASK_SCHEDULE.md`](../../../tasks/RECENT_TASK_SCHEDULE.md) §6.1 / §6.6 +5. [`docs/coding_wiki/CODING_WIKI.md`](../../../coding_wiki/CODING_WIKI.md) +6. [`docs/coding_wiki/index.md`](../../../coding_wiki/index.md) +7. [`docs/coding_wiki/concepts/task-schedule-ink-backend.md`](../../../coding_wiki/concepts/task-schedule-ink-backend.md) +8. [`cyning-harness/harness/templates/TASK_done_README.md`](../../../../../../cyning-harness/harness/templates/TASK_done_README.md) +9. [`cyning-harness/harness/templates/VIEW_done_by_domain.md`](../../../../../../cyning-harness/harness/templates/VIEW_done_by_domain.md) +10. [`cyning-harness/harness/templates/VIEW_done_thin_pointer.md`](../../../../../../cyning-harness/harness/templates/VIEW_done_thin_pointer.md) +11. [`cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md`](../../../../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md) +12. [`docs/harness/prompts/handoff/HANDOFF_CLOSE_TRACE.md`](../../../prompts/handoff/HANDOFF_CLOSE_TRACE.md) + +--- + +## 2. 执行清单 + +### A) `docs/tasks` 索引层 + +#### A1 · 新建 `docs/tasks/done/README.md` + +- 用途：日常浏览只打开本文件；`_views/done.md` 为薄指针。 +- 真值：task 头部 `状态` + `docs/tasks/done//` 物理位置。 +- 按域分组表： + - `harness`：`task_harness_*`（非产品里程碑） + - `governance`：`task_governance_*` · `task_gov_*` + - `chatbi`：`task_chatbi_*` + - `engineering`：`task_engineering_*` + - `standards`：`task_standards_*` + - `epics`：Epic / MANIFEST / Loop 母单 +- 每行格式：`关账日 | [task_slug](../done/task_*.md) | freeze_id / 一行摘要` +- Epic 母单单独一节。 +- 底部链 `FRAGMENT_task_domain_infer_v1_zh.md`。 + +#### A2 · 新建 `docs/tasks/_views/done_by_domain.md` + +- 与 Hub 语义一致，路径用 `../done/task_*.md`（P0 仍扁平）。 +- 每域一张表：`关账日 | 链接 | 一行摘要`。 +- Epic 母单单独一节。 + +#### A3 · 重写 `docs/tasks/_views/done.md` 为薄指针 + +- ≤15 行。 +- 内容： + - 标题「Tasks 状态视图：已完成（done）」 + - 说明：完整导航见 `../done/README.md`；分组表见 `done_by_domain.md`。 + - 快速入口表：Hub、`done_by_domain.md`、`in_progress.md`。 + - 维护纪律：关账时更新 Hub / `done_by_domain`；勿在本文件追加长列表。 + +#### A4 · `docs/tasks/done//` 目录结构声明 + +- 在 `done/README.md` 顶部或对应域节前说明：P0 不 mass `git mv`，目标子目录 slug 见域表。 + +#### A5 · 索引表链到现有 `done/task_*.md` + +- 路径仍用扁平相对路径。 +- 确保所有链接相对 `_views/` 或 `done/README.md` 有效。 + +#### A6 · 更新 `docs/tasks/README.md` + +- 在「任务归档流程」checklist 中新增： + - 第 4 步（或插入）：更新 `done/README.md` Hub 对应域表一行。 + - 第 5 步：更新 `_views/done_by_domain.md`。 + - 原第 4 步 `_views/done.md` 改为「保持薄指针，不追加长列表」。 +- 新增「域子目录 + Hub 纪律」段落： + - 说明 `done//` 规划。 + - 引用 `FRAGMENT_task_domain_infer_v1_zh.md`。 + +### B) Coding Wiki 同步 + +#### B1 · `docs/coding_wiki/concepts/task-schedule-ink-backend.md` + +- 在「链接」节或「Epic 分区」前增 Hub 指针： + - `docs/tasks/done/README.md` — done 任务按域 Hub + - `docs/tasks/_views/done_by_domain.md` — 按域分组表 +- 写明：L1 真值仍在 `RECENT` 与 `done/task_*.md`，L2 Wiki 只链不替代。 + +#### B2 · `docs/coding_wiki/index.md` + +- 在「综合」表下方或「维护」前增一段说明： + - syntheses `source_task` 指向 L1 `done/` 扁平路径。 + - 浏览历史任务优先用 `docs/tasks/done/README.md` Hub。 + - Hub 不替代 `source_task` 真值。 + +#### B3 · `docs/coding_wiki/CODING_WIKI.md` + +- §4.1 ingest：关账后除更新 `index.md` / `log.md` 外，还需在 `docs/tasks/done/README.md` Hub 对应域表追加一行。 +- §4.2 query：Agent 读序增「浏览 done 任务先 Hub / `done_by_domain`」。 +- 链 `FRAGMENT_task_domain_infer_v1_zh.md`。 + +#### B4 · 保持 syntheses `source_task` 有效 + +- P0 不改 frontmatter 路径。 +- 若发现已有 synthesis 链到将迁移的子目录路径，本 task 不改动，留待 P1 子 task 统一处理。 + +--- + +## 3. 40 自检（执行后必须做） + +运行以下检查并回填 task §8： + +```bash +# 1. 行数检查 +wc -l docs/tasks/_views/done.md + +# 2. 相对链接检查（手动或脚本） +python tools/verify_markdown_links.py docs/tasks/done/README.md docs/tasks/_views/done_by_domain.md docs/tasks/_views/done.md docs/tasks/README.md docs/coding_wiki/concepts/task-schedule-ink-backend.md docs/coding_wiki/index.md docs/coding_wiki/CODING_WIKI.md + +# 3. ruff（若 CI 配置） +ruff check . +``` + +若 `verify_markdown_links.py` 不存在，可用以下等价命令： + +```bash +grep -nE '\[([^\]]+)\]\(([^)]+)\)' docs/tasks/done/README.md docs/tasks/_views/done_by_domain.md docs/tasks/_views/done.md | while read line; do ...; done +``` + +要求： + +- `_views/done.md` ≤15 行。 +- 所有相对链接 zero BROKEN。 +- `done_by_domain.md` 与 Hub 无域级不一致。 + +--- + +## 4. 验收标准（逐条勾选） + +- [ ] `done/README.md` 已创建，覆盖主域 +- [ ] `_views/done.md` ≤15 行，指向 Hub +- [ ] `_views/done_by_domain.md` 已创建，与 Hub 一致 +- [ ] `docs/tasks/README.md` 归档流程已更新 +- [ ] Coding Wiki 三文件已链 Hub 并写明 L1 vs L2 +- [ ] 链接自检 zero BROKEN +- [ ] 40 自检结论已回填 task §8 +- [ ] 未修改 `api/**` 或业务代码 + +--- + +## 5. 禁止 + +- **不写 `api/**`。** +- **不改 `packages/**`。** +- **不批量 `git mv` `done/` 文件。** +- **不修改 `HG-*` 人工闸状态。** +- **不为本 task 新建 synthesis。** +- **不改现有 syntheses 的 `source_task` 路径（除非发现明显 404）。** + +--- + +## 6. 输出 / 交接 + +30 完成后输出： + +1. 修改文件列表（相对仓库根）。 +2. 40 自检结果（命令 + 结论 + 要点）。 +3. 是否建议进入 40/50（yes/no + 理由）。 +4. 若自检失败，列出阻塞项与修复建议。 + +--- + +## 给 Cursor + +`governance-tasks-done-hygiene`、30 execute、文档-only、`done/README.md`、`_views/done.md`、`_views/done_by_domain.md`、链接自检、禁止写 api diff --git a/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_kimi_agent_rethink_R1_R5.md b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_kimi_agent_rethink_R1_R5.md new file mode 100644 index 00000000..0864f2b6 --- /dev/null +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/PROMPT_kimi_agent_rethink_R1_R5.md @@ -0,0 +1,116 @@ +# PROMPT · Kimi Agent rethink R1–R5（governance-tasks-done-hygiene） + +> **阶段**：10-task / rethink +> **目标**：在 22 R1 审查前，完成 task `task_governance_tasks_done_index_hygiene_v1.md` 的 R0–R5 思考轮回填，确保索引治理方案可行、链接不漂移、50 有落盘路径。 +> **约束**：不写 `api/**`；不改业务代码；只补全 task 文档与 invoke。 + +--- + +## 1. 必读（按顺序） + +1. [`docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md`](../../active/task_governance_tasks_done_index_hygiene_v1.md) +2. [`docs/tasks/README.md`](../../../tasks/README.md) +3. [`docs/tasks/_views/done.md`](../../../tasks/_views/done.md) +4. [`docs/tasks/RECENT_TASK_SCHEDULE.md`](../../../tasks/RECENT_TASK_SCHEDULE.md) §6.1 / §6.6 +5. [`docs/coding_wiki/CODING_WIKI.md`](../../../coding_wiki/CODING_WIKI.md) +6. [`docs/coding_wiki/concepts/task-schedule-ink-backend.md`](../../../coding_wiki/concepts/task-schedule-ink-backend.md) +7. [`cyning-harness/harness/templates/TASK_done_README.md`](../../../../../../cyning-harness/harness/templates/TASK_done_README.md) +8. [`cyning-harness/harness/templates/VIEW_done_by_domain.md`](../../../../../../cyning-harness/harness/templates/VIEW_done_by_domain.md) +9. [`cyning-harness/harness/templates/VIEW_done_thin_pointer.md`](../../../../../../cyning-harness/harness/templates/VIEW_done_thin_pointer.md) +10. [`cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md`](../../../../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md) + +--- + +## 2. 思考轮问题（必须逐条回答） + +### R0 · 读 task / SPEC / 非范围 + +- `done/` 当前到底有多少篇 `.md`？列出最近 20 篇文件名前缀分布。 +- 哪些域最拥挤？哪些域最稀疏？ +- 现有 `_views/done.md` 多少行？是否已超过「薄指针」阈值？ +- 本 task 明确排除的 bulk `git mv` 会带来什么风险？ + +### R1 · 代码/文档事实 + +- `docs/tasks/README.md` 当前归档流程是否提到域子目录？若否，需在哪里插入 Hub 纪律？ +- `docs/coding_wiki/index.md` 与 `task-schedule-ink-backend.md` 当前是否链到 `done/README.md`？若否，最佳插入点在哪里？ +- 现有 syntheses 的 `source_task` 是否都指向扁平 `done/task_*.md`？是否需要因本 task 而改动？ +- `done/` 中是否有 `legacy/` 或命名不规范文件需要特殊处理？ + +### R2 · 方案对比 + +- 方案 α：P0 只做 Hub + 薄指针，不改物理路径。 +- 方案 β：P0 同步 bulk `git mv` 到域子目录。 +- 本 task 为何选 α？代价是什么？P1 子 task 应如何描述？ +- `_views/done_by_domain.md` 与 Hub 的维护关系：双向同步还是 Hub 单向真值？ + +### R3 · 边界 / 测试 / failure_paths + +- 如何确保 Hub 中链接不 404？自检命令是什么？ +- 如何防止 Agent 只读旧 `_views/done.md` 而忽略 Hub？ +- 50 复检应抽检哪些域/链接？ +- 若 `done/README.md` 与 `_views/done_by_domain.md` 不一致，失败路径 F2 如何触发？ + +### R4 · 链接自检 / PR 策略 + +- 推荐用什么工具/命令做相对链接自检？（可手工 `rg` / Python / markdown-link-check） +- PR body 应包含哪些验收勾选？ +- 文档-only PR 的 CI 如何处理？（无 pytest 回归，但可能有 ruff / markdown lint） + +### R5 · 图谱/契约增量 + 关账判断 + +- 本 task 是否改 `docs/_tech_graph/`？（否） +- 本 task 是否改 `api/` 契约？（否） +- 关账时必须生成的 `freeze_id` 建议格式？ +- 是否存在必须回填到 `RECENT_TASK_SCHEDULE.md` 的条目？ + +--- + +## 3. 输出格式 + +在 task 文件 `docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md` 的 **§5 思考轮次** 中逐条回填： + +```markdown +### R0 · 读 task / SPEC / 非范围 + +- 回答 1 +- 回答 2 +... +``` + +并更新 **思考轮控制表**： + +```markdown +| 字段 | 值 | +|------|-----| +| **actual_last_round** | `R5` | +| **early_stop** | `no` | +| **early_stop_reason** | — | +| **residual_risks** | `none` 或逐条 | +``` + +--- + +## 4. 禁止 + +- 不写 `api/**`。 +- 不改 `packages/**`。 +- 不新建 `docs/spec/` 行为变更。 +- 不批量 `git mv` `done/` 文件。 +- 不修改 `HG-*` 闸的 `status`（仅人可改）。 + +--- + +## 5. 交接物 + +完成 R0–R5 后，输出： + +1. 已更新的 task 文件路径。 +2. 是否建议进入 22 R1（yes/no + 理由）。 +3. 若有阻塞，列出清单并建议退回 10 补全。 + +--- + +## 给 Kimi + +`governance-tasks-done-hygiene`、R0–R5、Hub、薄指针、域子目录、链接自检、文档-only 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 new file mode 100644 index 00000000..1c869d8f --- /dev/null +++ b/docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md @@ -0,0 +1,35 @@ +# 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/governance-tasks-done-hygiene-v1` + +--- + +## 帽序 + +```text +10-task（起草/ rethink） → 22 R1 审查 → 人签 HG-AUDIT-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_kimi_agent_rethink_R1_R5.md` | 10-task / rethink 帽，R0–R5 框架 | +| `PROMPT_30_execute_docs_v1_zh.md` | 30 执行帽专用 Prompt | + +--- + +## 给 Cursor + +`governance-tasks-done-hygiene`、`_views/done.md`、`done/README.md`、`done_by_domain.md`、文档-only、链接自检 diff --git a/docs/tasks/README.md b/docs/tasks/README.md index b3bef928..12afce3a 100644 --- a/docs/tasks/README.md +++ b/docs/tasks/README.md @@ -77,7 +77,7 @@ docs/tasks/ - **`reinspect_results/`**：**50 帽三方复检** — 关账必选。 - **Harness**：[`../harness/README.md`](../harness/README.md)；10 结束输出 **下一棒 A（22）+ B（30）**，由人择一。 -审查回填清单由 **需求帽**（[`../harness/prompts/10-requirements.md`](../harness/prompts/10-requirements.md)）更新本仓 `docs/tasks/`、`docs/spec/`。 +审查回填清单由 **需求帽**（[`../harness/prompts/hats/10-requirements.md`](../harness/prompts/hats/10-requirements.md)）更新本仓 `docs/tasks/`、`docs/spec/`。 --- @@ -107,12 +107,35 @@ docs/tasks/ 2. **更新头部状态**：将 `> **状态**：...` 改为 `done（YYYY-MM-DD 验收通过）`（日期为实际验收日）。 3. **移动文件**：在仓库根执行 `git mv docs/tasks/active/<文件名>.md docs/tasks/done/`，**禁止**仅复制内容而遗留 `active/` 同名文件。 - **硬规则**：**禁止**只把头部改成 `done` 而文件仍留在 `active/`（会误导 Agent）；**`done` 状态与 `git mv` 须在同一提交内完成**，真值以 **目录位置 + 头部状态** 双一致为准。 -4. **更新已完成索引**：在 `docs/tasks/_views/done.md` 追加一行指向 `../done/<文件名>.md` 的相对链接（可附简短验收说明，与现有条目风格一致）。 +4. **更新已完成索引**： + - 在 `docs/tasks/done/README.md` Hub 对应域表追加一行（日期 · 链接 · freeze_id / 一行摘要）。 + - 同步在 `docs/tasks/_views/done_by_domain.md` 对应域表追加一行。 + - **`docs/tasks/_views/done.md` 保持薄指针（≤15 行），禁止追加长列表**。 5. **若任务曾列入进行中视图**：检查 `docs/tasks/_views/in_progress.md`，移除或更新对该任务的引用（避免双轨）。 6. **配对前端 / 跨仓任务**：若头部或正文引用了 `ai-ink-brain/content/tasks/active/task_*.md`，须在 `ai-ink-brain` 仓按 **`content/tasks/README.md`** 执行归档：**`git mv`** 至 **`content/tasks/done/`**，更新 **`content/tasks/_views/done.md`**，头部 **`状态`** 改为 `done（YYYY-MM-DD 验收通过）`。（**不**移动 `docs/spec/` 下规格文件，规格持续维护、不因任务归档而搬迁。） > 说明：`_views/*.md` 只做链接聚合，不作为真值；真值以任务文件头部 `状态` + 文件所在目录（`active/` 或 `done/`）为准。 +### 域子目录 + Hub 纪律（P0 起生效） + +为降低 `done/` 扁平堆积与 `_views/done.md` 过长导致的浏览成本，引入 **域 Hub** 模式： + +- **日常浏览入口**：`docs/tasks/done/README.md`（按域分组表）。 +- **薄指针**：`docs/tasks/_views/done.md` ≤15 行，只链 Hub 与 `done_by_domain.md`。 +- **分组视图**：`docs/tasks/_views/done_by_domain.md` 与 Hub 语义一致。 +- **P0 不 mass `git mv`**：物理文件仍扁平存放于 `done/`，Hub 与 `done_by_domain.md` 中的链接仍使用 `../done/.md`。 +- **P1 批量迁移**：未来子 task 将物理文件 `git mv` 到 `done//`，届时 Hub / `done_by_domain.md` 链接同步更新。 +- **域推断**：[`FRAGMENT_task_domain_infer_v1_zh.md`](../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)。 + +| 域 slug | 说明 | 目标目录 | +|---------|------|----------| +| `harness` | 本仓流程 / CI / 帽子 | `done/harness/` | +| `governance` | Wiki / 索引 / 治理线 | `done/governance/` | +| `chatbi` | ChatBI V2/V3 · unified chat | `done/chatbi/` | +| `engineering` | 图谱闸口 / RAG / 跨仓工程 | `done/engineering/` | +| `standards` | 编码规范 · api 模块化 Epic | `done/standards/` | +| `epics` | 母单 · MANIFEST · Loop | `done/epics/` | + --- ## specs / legacy 的边界 diff --git a/docs/tasks/_views/done.md b/docs/tasks/_views/done.md index 4aed53c2..061911c8 100644 --- a/docs/tasks/_views/done.md +++ b/docs/tasks/_views/done.md @@ -1,145 +1,10 @@ # Tasks 状态视图：已完成（done） -> 说明：本视图只做聚合索引，不改变原任务文件。 - -## 已完成 - -- `../done/task_harness_semi_auto_retirement_manifest_v1.md`（2026-06-08：semi_auto 退场 Epic MANIFEST · A+B 双轨 CLOSE · G1 #135 · G2 #137/#138 · `GOV-HARNESS-CHAIN-SEMI-AUTO-RETIRE@2026-06-08`） -- `../done/task_harness_semi_auto_retirement_phase2_v1.md`（2026-06-08：semi_auto **物理退场** Phase 2 G3 · SPEC 全面生效 · DEPRECATED 横幅 · `GOV-HARNESS-SEMI-AUTO-RETIRE-P2@2026-06-08`） -- `../done/task_chatbi_intent_llm_retry_u1_5_v1.md`（2026-06-08：ChatBI Intent LLM 外呼重试 U1.5 · B 轨补关账 · PR #137/#138 · T1 explore→22→30→40→50→CLOSE · `required` + 50 reinspect · 323 passed 全集绿 · `GOV-HARNESS-CHAIN-SEMI-AUTO-RETIRE@2026-06-08`） -- `../done/task_harness_chain_orchestration_spec_v1.md`（2026-06-08：Harness 链式编排 SPEC · semi_auto 退场 A 轨 · PR #135 · orchestration Claude Code · T1 explore→22→30→40→CLOSE · `not_applicable` · skip 50） -- `../done/task_governance_kimi_harness_pilot_recentsync_v1.md`（2026-06-08：Kimi Code Harness 试点 · RECENT §1.2 同步 + gov-docs-noise done 状态卫生 · PR #134 · orchestration Kimi · KPI 92% pass · diary `2026-06-08-kimi-harness-pilot-recentsync_zh.md`） -- `../done/task_governance_docs_noise_line_manifest_v1.md`（2026-06-06：docs-noise 治理线 **母单 MANIFEST** · P0–P3 排期与索引 · T3 CLOSE · 治理线全量收尾） -- `../done/task_gov_docs_noise_p1_archived_v1.md`（2026-06-06：docs-noise P1 archived 横幅 + flows README · PR #123 @ `2de2902` · Task 链 T2b · Claude Code 串行 spawn · **unblocks** P2 子批） -- `../done/task_gov_docs_noise_p2_readorder_v1.md`（2026-06-06：docs-noise P2 读序对齐 · PROJECT_CONFIG/AGENTS/docs README/根 README + legacy 6 文件消化 · PR #126 @ `08d51bd` · Task 链 T2c · Claude Code 串行 spawn · **unblocks** P3 子批） -- `../done/task_gov_docs_noise_p3_index_v1.md`（2026-06-06：docs-noise P3 SPEC 收敛索引 · governance 分组表 + showcase README + C6 superseded · PR #129 @ `1c52f27` · Task 链 T2d · Claude Code 串行 spawn · **docs-noise 治理线全量 CLOSE**） -- `../done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md`（2026-06-06：P2-4 消化 legacy · FTS alias v2 分隔符/版本号/标识符已落地 · `supabase/sql/hybrid_search.sql`） -- `../done/task_rag_b2_fts_alias_backfill_v1.md`（2026-06-06：P2-4 消化 legacy · FTS 日期 alias + 回填已落地 · `supabase/sql/hybrid_search.sql`） -- `../done/task_rag_b1_metadata_structured_recall_v1.md`（2026-06-06：P2-4 消化 legacy · metadata `date_norm` 结构化召回已落地） -- `../done/task_rag_keyword_websearch_date_normalize_v1.md`（2026-06-06：P2-4 消化 legacy · `websearch_to_tsquery` + 日期归一化已落地） -- `../done/task_03_hybrid_search_implementation.md`（2026-06-06：P2-4 消化 legacy · Hybrid Search Vector + FTS + RRF 已落地） -- `../done/Task 04.md`（2026-06-06：P2-4 消化 legacy · 引用溯源 `x-sources` + `---RAG_SOURCES_JSON---` 已落地） -- `../done/task_gov_docs_noise_p0_readme_v1.md`（2026-06-06：docs-noise P0 C1–C3 README 指针 · PR #121 @ `5184c10` · KPI 100% pass · Task 链 T1 试点 · **unblocks** P1/P2 子批） -- `../done/task_chatbi_intent_hints_step2_v1.md`（2026-06-06：Intent Hints Step2 C-mid · router 同步 + LLM 仲裁 · PR #111 @ `0fe7d2d` · KPI 88% pass · 50 `reinspect_chatbi_intent_hints_step2_v1_20260604_v1.md` · **unblocks** Step3） -- `../done/task_chatbi_baseline_merge_gate_v1.md`（2026-06-06：ChatBI 基线合并闸 · v3 clarify 测试环境 + contract label · PR #106 @ `26e1c45` · KPI 100% pass · 50 `reinspect_chatbi_baseline_merge_gate_v1_20260604_v1.md` · **unblocks** P0 Graph） -- `../done/task_chatbi_graph_p0_foundation_v1.md`（2026-06-04：LangChain 路线图 P0 · 共享层抽取 + State/边表 + Graph stub 路由 · PR #107 · 50 `reinspect_chatbi_graph_p0_foundation_v1_20260603_v1.md` · `main@f53327a` · **blocks** P1 Task-B · 关账 #115） -- `../done/task_chatbi_intent_hints_step1_v1.md`（2026-06-04：Intent Hints Step1 C-lite · yaml+loader+Prompt 注入 · KPI 94% pass-with-notes · `CHATBI-INTENT-HINTS@2026-06-09` · reinspect `reinspect_chatbi_intent_hints_step1_v1_20260604_v1.md` · 分支 `task/chatbi-intent-hints-step1-v1` · 实现 `bb59beb` · **待人 HG-REINSPECT + PR CI + RUNBOOK 集成**） -- `../done/task_harness_invokes_by_task_prompts_sync_v1.md`（2026-06-02：prompts/HANDOFF + 05 rule 对齐 by-task invoke 落盘 · 配对 Ink PR #48 · `HARNESS-INVOKES-BY-TASK-PROMPTS@2026-06-02`） -- `../done/task_chatbi_v3_lowconf_rag_preview_v1.md`（2026-05-31：§5-3 RAG 预览+token · KPI 100% pass · `CHATBI-LOWCONF-RAG-PREVIEW@2026-05-31` · reinspect `reinspect_chatbi-v3-lowconf-rag-preview_20260531_v1.md` · 分支 `task/chatbi-v3-lowconf-rag-preview` · Ink `72f8f0c`） -- `../done/task_chatbi_v3_lowconf_sql_preview_v1.md`（2026-05-31：§5-2 Text2SQL 预览+token · KPI 100% pass · `CHATBI-LOWCONF-SQL-PREVIEW@2026-05-31` · reinspect `reinspect_chatbi-v3-lowconf-sql-preview_20260531_v1.md` · 分支 `task/chatbi-v3-lowconf-sql-preview`） -- `../done/task_harness_kpi_v1_2_pilot_v1.md`（2026-05-31：KPI v1.2 试点 · 00 编排帽链 · Task_KPI% 100 pass · `KPI-RUBRIC-PILOT@2026-05-31` · reinspect `reinspect_harness-kpi-v1-2-pilot_20260531_v1.md`） -- `../done/task_backend_improve_batch_a_p0_v1.md`（2026-05-31 验收通过：FAQ Batch A IMP-B-01/02/10/11/20 · PR #96 · 22 CLOSE `reviews/by-task/backend-improve-batch-a-p0/`） -- `../done/task_tech_graph_p0_handoff_and_drift_check_v1.md` -- `../done/task_tech_graph_p1_manifest_and_validation_v1.md` -- `../done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md` -- `../done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md` -- `../done/task_tech_graph_p4_ci_guardrail_v1.md` -- `../done/task_tech_graph_p5_auto_render_from_manifest_v1.md` -- `../done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md` -- `../done/task_tech_graph_p7_contract_ci_guardrail_v1.md` -- `../done/task_rag_i18n_crosslingual_recall_v1.md`（文件内标注：2026-04-24 验收通过） -- `../done/task_docs_truth_and_rag_unify_v1.md`（2026-04-28 验收通过：PROJECT_CONFIG / `99_spec` Backlog 表 / `api/rag_shared` 初批） -- `../done/task_unified_chat_router_observability_full_trace_v1.md`（2026-04-30 验收通过） -- `../done/task_unified_chat_router_trace_text2sql_exec_v1.md`（2026-04-30 验收通过） -- `../done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md`（2026-05-11 归档：P1-Eval） -- `../done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md`（2026-05-11 归档：P1-C） -- `../done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md`（2026-05-11 归档：P1-D） -- `../done/task_chatbi_v2_agent_p1_behavior.md`（2026-05-11 归档：P1 总览） -- `../done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md`（2026-05-11：V2 SPEC/任务验收归档索引） -- `../done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md`（2026-05-11 验收通过：RAG 改写上链 + LLM Prompt 可观测） -- `../done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md`（2026-05-14 验收通过：P1-1 Text2SQL 后闸 SQL AST 硬化） -- `../done/task_chatbi_v3_prompt_injection_guard_poc_v1.md`（2026-05-20：P1-2 Prompt 注入 PoC；22 帽 CLOSE · `docs/harness/reviews/by-task/chatbi_v3_prompt_injection_guard_poc_v1/task_chatbi_v3_prompt_injection_guard_poc_v1_audit_CLOSE_20260520.md`） -- `../done/task_chatbi_v3_p2_resilience_v1.md`（2026-05-24 验收通过：P2-1 拆单 docs-only，子单 health/limit/circuit 已建立） -- `../done/task_chatbi_v3_p2_resilience_health_ready_v1.md`（2026-05-25 验收通过：P2-1a `/live` + `/ready` 健康探针；50 复检 `reinspect_chatbi_v3_p2_1a_health_ready_20260525_v1.md`） -- `../done/task_engineering_chatbi_sse_first_v1.md`（2026-05-15：ChatBI 工程纪律 SSE 优先；Harness R2 签收后归档） -- `../done/task_engineering_tech_graph_graph_json_export_v1.md`（2026-05-15：方案1 `graph.json` 导出 / `--check` / pytest / `tech-graph` CI；闸口 A 收口归档） -- `../done/task_engineering_tech_graph_gate_a_token_compare_v1.md`（2026-05-15：闸口 A token 粗估附录工具与 CI；与 graph 导出同批次验收归档） -- `../done/task_engineering_tech_graph_gate_a_perf_compare_v1.md`（2026-05-15 验收通过：闸口 A 代号 A/B 性能对比专文单一真值；`PR #28` / merge `2315937`） -- `../done/task_engineering_tech_graph_v2_graph_query_v1.md`（2026-05-17：graph_v2 + graph_query + 闸口 B；Harness CLOSE · `freeze_id` `TECH_GRAPH_S2_FREEZE_20260517_V2_0`） -- `../done/task_engineering_tech_graph_scheme2_completion_v1.md`（2026-05-17：方案2 API/文档补全 · PR #31） -- `../done/task_engineering_tech_graph_v2_query_coverage_v1.md`（graph_v2 查询覆盖与 pytest） -- `../done/task_engineering_tech_graph_v2_p4_extended_v1.md`（2026-05-17：P2-4a · freeze `V2_2`；4b/4c 见该单 §1.1，无独立 follow-up task） -- `../done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md`（2026-05-18：闸口 C · D vs E · `TECH_GRAPH_GATE_C_FREEZE_20260518_V1_0`） -- `../done/task_engineering_tech_graph_gate_c_prime_f1_v1.md`（2026-05-20：闸口 C′ · T002 物化 · `TECH_GRAPH_GATE_C_PRIME_F1_FREEZE_20260520_V1_0`） -- `../done/task_engineering_tech_graph_gate_c_double_prime_v1.md`（2026-05-20：闸口 C″ T003 物化 · batch `102810` · PR #37+#38 · `TECH_GRAPH_GATE_C_DOUBLE_PRIME_FREEZE_20260520_V1_0`） -- `../done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md`（2026-04-29 验收通过） -- `../done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md`（待补日期：请核对任务头部 `状态`） -- `../done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md`（2026-04-29 验收通过） -- `../done/done_unified_chat_backend_v1.md`（2026-04-28 验收通过） -- `../done/done_unified_chat_streaming_backend_sse_v1.md`（2026-04-28 验收通过） -- `../done/task_chatbi_level_gate_v1.md`（2026-05-13 归档） -- `../done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md`（2026-05-12 验收通过） -- `../done/task_chatbi_v2_agent_p0_backend.md`（2026-04-29 验收通过） -- `../done/task_chatbi_v2_incremental_sse_backend_v1.md`（2026-05-11 归档） -- `../done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md`（2026-05-11 归档） -- `../done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md`（待补日期：请核对任务头部 `状态`） -- `../done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md`（2026-05-11 归档） -- `../done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md`（待补日期：请核对任务头部 `状态`） -- `../done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md`（2026-05-21 验收通过） -- `../done/task_intent_router_backend_v1.md`（2026-05-13 归档） -- `../done/task_text2sql_schema_prefetch_before_mutate_v1.md`（2026-05-13 归档） -- `../done/task_unified_chat_router_evidence_event_v1.md`（2026-04-30 验收通过） -- `../done/task_unified_chat_router_evidence_observability_v1.md`（2026-04-30 验收通过：`router.evidence.details` SSE + `metadata.router_debug` 落库） -- `../done/task_chatbi_v2_acceptance_runner_v1.md`（2026-05-22 验收通过：L0–L7 Runner 归档） -- `../done/task_docs_tasks_reorg_move_v1.md`（2026-05-22 验收通过：`docs/tasks/` 按 active/done/specs/templates/legacy 规整；顶层无混放 SPEC/模板） -- `../done/task_05_query_rewrite_observability.md`（2026-05-22 验收通过：query_compare 可观测 + Harness P0-B/C 试点；PR #46 · 首份新 `reviews/by-task/05_query_rewrite_observability/task_05_*_audit_R1_*.md`） -- `../done/task_harness_in_repo_prompts_and_rules_v1.md`（2026-05-22 验收通过：Harness prompts/rules 内嵌后端仓，active→done 归档完成） -- `../done/task_harness_theory_align_p0_v1.md`（2026-05-29 验收通过：理论对齐 P0 · PR #90 · 50 `reinspect_harness_theory_align_p0_20260529_v1.md` · `GOV-HARNESS-THEORY-ALIGN-P0@2026-05-29`） -- `../done/task_harness_theory_align_p1_v1.md`（2026-05-29 验收通过：理论对齐 P1 · PR #92 · 50 `reinspect_harness_theory_align_p1_20260529_v1.md` · `GOV-HARNESS-THEORY-ALIGN-P1@2026-05-29`） -- `../done/task_harness_p1_docs_consolidation_v1.md`（2026-05-23 验收通过：P1-3 human_gate 速查 + P1-2 skills 索引；路径 B 10→30→50 关账） -- `../done/task_coding_wiki_pilot_v1.md`（2026-05-26 验收通过：Coding Wiki 试点 T1b · `docs/coding_wiki/` · 50 复检 `reinspect_coding_wiki_pilot_20260526_v1.md` · `freeze_id` `CODING-WIKI-PILOT@2026-05-25`） -- `../done/task_harness_workspace_taxonomy_promote_v1.md`（2026-05-26：T3 工作区 Harness taxonomy 关账 · pointer → Projects `docs/harness/tasks/done/` · `HARNESS-TAXONOMY-T3@2026-05-25`） -- `../done/task_wiki_ctx_ab_v1.md`（2026-05-26 验收通过：Wiki-CTX-AB P1+P2 · H-lean vs W 降幅 78.8% · 推荐默认 `coding_wiki/` 读序 · 50 复检 `reinspect_wiki_ctx_ab_p2_20260526_v1.md` · `freeze_id` `WIKI-CTX-AB@2026-05-25`） -- `../done/task_coding_wiki_t1c_test_archive_v1.md`（2026-05-26 验收通过：Coding Wiki T1c 测试过程档案 · `decisions/` + 2× synthesis §测试变更 · 50 复检 `reinspect_coding_wiki_t1c_20260526_v1.md` · `freeze_id` `CODING-WIKI-T1C@2026-05-26`） -- `../done/task_wiki_ctx_ab_multi_slug_v1.md`（2026-05-26 验收通过：Wiki-CTX-AB Multi slug · H-lean vs W × 2 域 · 降幅 86.3%/61.4% · slug B W 3/4 部分外推 · 50 复检 `reinspect_wiki_ctx_ab_multi_20260526_v1.md` · `freeze_id` `WIKI-CTX-AB-MULTI@2026-05-26`） -- `../done/task_coding_wiki_ingest_test_strategy_v1.md`（2026-05-26 验收通过：Wiki Loop A1 · synthesis `test_strategy: recommended` · `reinspect_wiki-a1-ingest-test-strategy_20260526_v1.md` · `freeze_id` `CODING-WIKI-A1-TEST-STRATEGY@2026-05-26`） -- `../done/task_coding_wiki_schema_test_strategy_rule_v1.md`（2026-05-26 验收通过：Wiki Loop A2 · `CODING_WIKI.md` §8.1 ingest 纪律 · `reinspect_wiki-a2-schema-test-strategy_20260526_v1.md` · `freeze_id` `CODING-WIKI-A2-SCHEMA-RULE@2026-05-26`） -- `../done/task_governance_wiki_spec_comparison_sync_v1.md`（2026-05-26 验收通过：Wiki Loop A3 · SPEC §2 + 对比表 #12/#46 · `reinspect_wiki-a3-spec-comparison_20260526_v1.md` · `freeze_id` `GOV-WIKI-A3-SPEC-SYNC@2026-05-26`） -- `../done/task_governance_recent_schedule_wiki_sync_v1.md`（2026-05-26 验收通过：Wiki Loop A4 · `RECENT_TASK_SCHEDULE` §6.6 · `reinspect_wiki-a4-recent-schedule_20260526_v1.md` · `freeze_id` `GOV-WIKI-A4-SCHEDULE@2026-05-26`） -- `../done/task_harness_wiki_loop_a1_a4_v1.md`（2026-05-26 验收通过：Wiki Loop 母单 A1–A4 · 单 PR `task/wiki-loop-a1-a4-v1` · `WIKI-LOOP-A1-A4@2026-05-26`） -- `../done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md`（2026-05-26 验收通过：Wiki Loop B-Q3 R1 · W 载荷 §Recheck · slug B W 4/4 · `reinspect_wiki-bq3-r1-payload-scorecard_20260526_v1.md` · `freeze_id` `WIKI-BQ3-R1-PAYLOAD@2026-05-26`） -- `../done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md`（2026-05-26 验收通过：Wiki Loop B-Q3 R2 · conclusion §5 + 对比表 #46 · `reinspect_wiki-bq3-r2-conclusion_20260526_v1.md` · `freeze_id` `WIKI-BQ3-R2-CONCLUSION@2026-05-26`） -- `../done/task_governance_wiki_bq3_spec_schedule_sync_v1.md`（2026-05-26 验收通过：Wiki Loop B-Q3 R3 · SPEC/RECENT 治理 · `reinspect_wiki-bq3-r3-gov-sync_20260526_v1.md` · `freeze_id` `GOV-WIKI-BQ3-SYNC@2026-05-26`） -- `../done/task_harness_wiki_loop_bq3_recheck_v1.md`（2026-05-26 验收通过：Wiki Loop B-Q3 Recheck 母单 · 第二 harness-loop-batch Loop · 单 PR `task/wiki-loop-bq3-recheck-v1` · `WIKI-LOOP-BQ3-RECHECK@2026-05-26`） -- `../done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md`（2026-05-26 验收通过：Wiki Loop C2 Verify R1 · RECENT §6.6 in_progress 行 · invoke C2 全绿 · `reinspect_wiki-c2-r1-schedule-draft_20260526_v1.md` · `freeze_id` `WIKI-C2-R1-SCHEDULE@2026-05-26`） -- `../done/task_governance_loop_c2_verify_r2_index_sync_v1.md`（2026-05-26 验收通过：Wiki Loop C2 Verify R2 · invoke README 验收说明 · RECENT §6.6 done · `reinspect_wiki-c2-r2-index-sync_20260526_v1.md` · `freeze_id` `WIKI-C2-R2-INDEX@2026-05-26`） -- `../done/task_harness_wiki_loop_c2_verify_v1.md`（2026-05-26 验收通过：Wiki Loop C2 Verify 母单 · 第三 harness-loop-batch Loop · invoke C2 全绿 · 单 PR `task/wiki-loop-c2-verify-v1` · `WIKI-LOOP-C2-VERIFY@2026-05-26`） -- `../done/task_governance_wiki_t4_r1_pilot_v1.md`（2026-05-27 验收通过：Wiki Loop T4+L2 R1 · T4 Pilot · graph_nodes + CODING_WIKI + 99_spec + RECENT · 50 复检 `reinspect_wiki-t4-r1-pilot_20260527_v1.md` · `freeze_id` `GOV-T4-R1-PILOT@2026-05-27`） -- `../done/task_governance_wiki_t4_r2_l0_align_v1.md`（2026-05-27 验收通过：Wiki Loop T4+L2 R2 · T4 L0 对齐 · VERIFY + drift 已知债务标注 · 50 复检 `reinspect_wiki-t4-r2-l0-align_20260527_v1.md` · `freeze_id` `GOV-T4-R2-L0-ALIGN@2026-05-27`） -- `../done/task_governance_l2_r3_test_manifest_v1.md`（2026-05-27 验收通过：Wiki Loop T4+L2 R3 · L2 manifest 草案 · `_test_manifest.json` 6 entries + 99_spec + CODING_WIKI + RECENT done · 50 复检 `reinspect_gov-l2-r3-test-manifest_20260527_v1.md` · `freeze_id` `GOV-L2-R3-TEST-MANIFEST@2026-05-27`） -- `../done/task_harness_wiki_loop_t4_l2_v1.md`（2026-05-27 验收通过：Wiki Loop T4+L2 母单 · 单 PR `task/gov-spec-t4-l2-v1` · `WIKI-LOOP-T4-L2@2026-05-27`） -- `../done/task_governance_wiki_t4_expand_v2.md`（2026-05-27 验收通过：T4 扩面 Post-Pilot · 3 synthesis 含 `graph_nodes` · CODING_WIKI + RECENT 同步 · 50 复检 `reinspect_gov-wiki-t4-expand_20260527_v1.md` · `freeze_id` `GOV-T4-EXPAND@2026-05-27`） -- `../done/task_governance_l2_manifest_ci_v1.md`（2026-05-27 验收通过：L2 Phase B · manifest ≥12 + `tech_graph_test_manifest_check.py` + pytest + CI workflow · 50 复检 `reinspect_gov-l2-manifest-ci_20260527_v1.md` · `freeze_id` `GOV-L2-MANIFEST-CI@2026-05-27`） -- `../done/task_governance_wiki_agent_readorder_v1.md`（2026-05-27 验收通过：Agent Coding Wiki 默认读序 · AGENTS 必读第 5 条 · `reinspect_gov-wiki-agent-readorder_20260527_v1.md` · `freeze_id` `GOV-WIKI-AGENT-READORDER@2026-05-27`） -- `../done/task_governance_wiki_ingest_batch_v1.md`（2026-05-27 验收通过：Coding Wiki 批量 ingest 10 slug · syntheses 15 · `reinspect_gov-wiki-ingest-batch_20260527_v1.md` · `freeze_id` `GOV-WIKI-INGEST-BATCH@2026-05-27`） -- `../done/task_governance_wiki_ctx_ab_representative_v1.md`（2026-05-27 验收通过：Wiki-CTX-AB 6 slug 代表性扩面 · T7/T8 pass · `reinspect_wiki-ctx-ab-representative_20260527_v1.md` · `freeze_id` `WIKI-CTX-AB-REP@2026-05-27` · 建议前端 P1-4 立项） -- `../done/task_governance_t4_spec_active_v1.md`（2026-05-27 验收通过：P2 Loop R1 · T4 Bridge SPEC draft→active · `reinspect_gov-t4-spec-active_20260527_v1.md` · `freeze_id` `GOV-T4-SPEC-ACTIVE@2026-05-27` · 单 PR `task/wiki-loop-p2-followup-v1`） -- `../done/task_governance_l2_phase_c_design_v1.md`（2026-05-27 验收通过：P2 Loop R2 · L2 Phase C design §4.4 · `reinspect_gov-l2-phase-c-design_20260527_v1.md` · `GOV-L2-PHASE-C-DESIGN@2026-05-27`） -- `../done/task_governance_l2_phase_c_impl_v1.md`（2026-05-28 验收通过：单元 B · `--check-failure-paths` 双向校验 · `reinspect_gov-l2-phase-c-impl_20260528_v1.md` · `GOV-L2-PHASE-C-IMPL@2026-05-28`） -- `../done/task_governance_wiki_ingest_batch_2_v1.md`（2026-05-27 验收通过：P2 Loop R3 · Batch-2 5 slug · syntheses 20 · `reinspect_gov-wiki-ingest-batch-2_20260527_v1.md` · `GOV-WIKI-INGEST-BATCH-2@2026-05-27`） -- `../done/task_harness_wiki_loop_p2_followup_v1.md`（2026-05-27 验收通过：P2 Loop 母单 META · R1–R3 · `WIKI-LOOP-P2-FOLLOWUP@2026-05-27` · REPORT `wiki-loop-p2-followup/REPORT_completion_wiki_loop_p2_followup_v1.md`） -- `../done/task_governance_wiki_docs_hygiene_v1.md`（2026-05-28 验收通过：Wiki Loop 单元 A R1 · 对比表 #36/#37 同步 · P2 SPEC 母单链 done · RECENT §6.6 in_progress · 50 复检 `reinspect_gov-wiki-docs-hygiene_20260528_v1.md` · `freeze_id` `GOV-WIKI-DOCS-HYGIENE@2026-05-28`） -- `../done/task_governance_wiki_t4_rollout_v1.md`（2026-05-28 验收通过：Wiki Loop 单元 A R2 · T4 graph_nodes 铺量 14 篇 · 20/20 synthesis 含 frontmatter · 50 复检 `reinspect_gov-wiki-t4-rollout_20260528_v1.md` · `freeze_id` `GOV-WIKI-T4-ROLLOUT@2026-05-28`） -- `../done/task_governance_wiki_ingest_batch_3_v1.md`（2026-05-28 验收通过：Wiki Loop 单元 A R3 · Batch-3 5 slug ingest · syntheses 25 · 50 复检 `reinspect_gov-wiki-ingest-batch-3_20260528_v1.md` · `freeze_id` `GOV-WIKI-INGEST-BATCH-3@2026-05-28`） -- `../done/task_harness_wiki_loop_unit_a_v1.md`（2026-05-28 验收通过：Wiki Loop 单元 A 母单 META · R1–R3 全关账 · 单 PR `task/wiki-unit-ab-plan-v1` · `WIKI-LOOP-UNIT-A@2026-05-28` · REPORT `REPORT_completion_wiki_loop_unit_a_v1.md`） -- `../done/task_governance_wiki_unit_ab_closeout_v1.md`（2026-05-28 验收通过：Wiki 单元 A/B 叙事收口 · #79–#81 对齐 · SKILL B 臂 case · `reinspect_gov-wiki-unit-ab-closeout_20260528_v1.md` · `GOV-WIKI-UNIT-AB-CLOSEOUT@2026-05-28`） -- `../done/task_governance_wiki_t4_ops_v1.md`（2026-05-29 验收通过：T4 运营化 · lint · 25/25 graph_nodes · PR #83 · `GOV-WIKI-T4-OPS@2026-05-29`） -- `../done/task_governance_task_schedule_wiki_bridge_v1.md`（2026-05-29 验收通过：排期 Wiki hub · `concepts/task-schedule-ink-backend` · `GOV-TASK-SCHEDULE-WIKI@2026-05-29`） -- `../done/task_chatbi_v3_p2_resilience_rate_limit_v1.md`（2026-05-29 验收通过：P2-1b 限流 · PR #86 · 50 复检 `reinspect_chatbi_v3_p2_1b_rate_limit_20260529_v1.md` · Loop R1 归档） -- `../done/task_governance_wiki_milestone_acceptance_expand_v1.md`（2026-05-29 验收通过：Wiki 里程碑验收 diary 扩充 · PR #87 · Loop R1 归档 · `GOV-WIKI-MILESTONE-ACCEPT@2026-05-29`） -- `../done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md`（2026-05-29 验收通过：P2 Loop R1 关账 · #0b/#W1 归档 · RECENT 同步 · `CHATBI-P2-R1-CLOSEOUT@2026-05-29`） -- `../done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md`（2026-05-29 验收通过：P2-1c 外呼熔断 · Loop R2 · 50 `reinspect_chatbi_v3_p2_loop_r2_circuit_breaker_20260529_v1.md`） -- `../done/task_chatbi_v3_p2_resilience_loop_v1.md`（2026-05-29 验收通过：P2 Loop 母单 META · R1+R2 · `CHATBI-P2-LOOP@2026-05-29` · REPORT `REPORT_completion_chatbi_v3_p2_loop_v1.md`） -- `../done/task_governance_wiki_t4_ops_v1.md`（2026-05-29 验收通过：T4 运营化 · `coding_wiki_graph_nodes_lint.py` · syntheses 25/25 · Bridge §5.1 · `reinspect_gov-wiki-t4-ops_20260529_v1.md` · `GOV-WIKI-T4-OPS@2026-05-29`） -- `../done/task_harness_p0_task_validate_v1.md`（2026-05-30 验收通过：P0 Loop R1 · `harness_task_validate` CLI + pytest · 50 `reinspect_p0-task-validate_20260530_v1.md` · `HARNESS-P0-TASK-VALIDATE@2026-05-30`） -- `../done/task_harness_p0_audit_selfcheck_v1.md`（2026-05-30 验收通过：P0 Loop R2 · 22/40 帽 OpenSpec×TDD 补丁 · R3 预审查 · `HARNESS-P0-AUDIT-SELFCHECK@2026-05-30`） -- `../done/task_harness_p0_status_cursor_v1.md`（2026-05-30 验收通过：P0 Loop R3 · change_status JSON + Cursor commands · `HARNESS-P0-STATUS-CURSOR@2026-05-30`） -- `../done/task_harness_p0_openspec_tdd_loop_v1.md`（2026-05-30 验收通过：P0 OpenSpec×TDD Loop 母单 META · R1–R3 · REPORT `p0-openspec-tdd/REPORT_completion_20260530_v1.md` · `HARNESS-P0-OPENSPEC-TDD-LOOP@2026-05-30`） -- `../done/task_portfolio_rag_demo_v1.md`（2026-06-03 验收通过：Portfolio W2/W3/W5 RUNBOOK + sync + 五问留证 · KPI 100% · `PORTFOLIO-RAG-DEMO@2026-06-01` · reinspect `reinspect_portfolio_rag_demo_w5_20260603_v1.md` · 分支 `task/portfolio-rag-w5-v1`） -- `../done/task_api_env_rag_env_consolidation_w1.md`（2026-06-09 验收通过：Epic T1 W1 · `index.py` env 收敛至 `rag_env` · PR #146 · 50 `task_api_env_rag_env_consolidation_w1_reinspect_2026-06-09.md` · `CODING_BACKEND_L2@2026-06-09`） -- `../done/task_api_agent_loop_split_w6.md`（2026-06-09 验收通过：Epic W6 · agent tool runner + persist 子模块 · PR #153 · `CODING_BACKEND_L2@2026-06-09`） -- `../done/task_api_tools_registry_split_w7.md`（2026-06-09 验收通过：Epic W7 · tools RAG/Text2SQL 子模块 · PR #155 · `CODING_BACKEND_L2@2026-06-09`） -- `../done/task_api_intent_stack_split_w8.md`（2026-06-09 验收通过：Epic W8 · intent rules + LLM 子模块 · PR #157 · `CODING_BACKEND_L2@2026-06-09`） -- `../done/task_standards_backend_api_modularization_manifest_v1.md`（2026-06-09 Epic CLOSE：W1～W8 全 done · `CODING_BACKEND_L2@2026-06-09`） -- `../done/task_standards_backend_p3_p4_l3_ruff_v1.md`（2026-06-09 验收通过：P3+P4 L3 `.mdc` + Ruff CI · PR #145 · `CODING_BACKEND_L2@2026-06-09`） - +> **薄指针**：完整导航见 [`../done/README.md`](../done/README.md) · 分组表见 [`done_by_domain.md`](./done_by_domain.md)。 +> **维护纪律**：关账时更新 Hub / `done_by_domain`；**勿**在本文件追加长列表。 + +| 视图 | 路径 | +|------|------| +| Hub（首选） | [`../done/README.md`](../done/README.md) | +| 按域分组 | [`done_by_domain.md`](./done_by_domain.md) | +| 进行中 | [`in_progress.md`](./in_progress.md) | diff --git a/docs/tasks/_views/done_by_domain.md b/docs/tasks/_views/done_by_domain.md new file mode 100644 index 00000000..050acc55 --- /dev/null +++ b/docs/tasks/_views/done_by_domain.md @@ -0,0 +1,181 @@ +# Tasks 视图：已完成 · 按域分组（done_by_domain） + +> **说明**：聚合索引 · **非真值**。真值：`done/` 各 task 文件 + [`../done/README.md`](../done/README.md) Hub。 +> **维护**：关账时在对应域表追加一行；Epic 母单单独一节。 + +--- +## harness（本仓流程 / CI / 帽子） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-02 | [../done/task_harness_invokes_by_task_prompts_sync_v1.md](../done/task_harness_invokes_by_task_prompts_sync_v1.md) | — | +| 2026-05-30 | [../done/task_harness_p0_task_validate_v1.md](../done/task_harness_p0_task_validate_v1.md) | — | +| 2026-05-30 | [../done/task_harness_p0_status_cursor_v1.md](../done/task_harness_p0_status_cursor_v1.md) | — | +| 2026-05-30 | [../done/task_harness_p0_audit_selfcheck_v1.md](../done/task_harness_p0_audit_selfcheck_v1.md) | — | +| 2026-05-29 | [../done/task_harness_theory_align_p1_v1.md](../done/task_harness_theory_align_p1_v1.md) | — | +| 2026-05-29 | [../done/task_harness_theory_align_p0_v1.md](../done/task_harness_theory_align_p0_v1.md) | — | +| 2026-05-26 | [../done/task_harness_workspace_taxonomy_promote_v1.md](../done/task_harness_workspace_taxonomy_promote_v1.md) | — | +| 2026-05-23 | [../done/task_harness_p1_docs_consolidation_v1.md](../done/task_harness_p1_docs_consolidation_v1.md) | — | +| 2026-05-22 | [../done/task_harness_in_repo_prompts_and_rules_v1.md](../done/task_harness_in_repo_prompts_and_rules_v1.md) | — | +| — | [../done/task_harness_semi_auto_retirement_phase2_v1.md](../done/task_harness_semi_auto_retirement_phase2_v1.md) | — | +| — | [../done/task_harness_kpi_v1_2_pilot_v1.md](../done/task_harness_kpi_v1_2_pilot_v1.md) | — | +| — | [../done/task_harness_chain_orchestration_spec_v1.md](../done/task_harness_chain_orchestration_spec_v1.md) | — | + +## governance（Wiki / 索引 / 治理线） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-08 | [../done/task_governance_kimi_harness_pilot_recentsync_v1.md](../done/task_governance_kimi_harness_pilot_recentsync_v1.md) | — | +| 2026-06-06 | [../done/task_gov_docs_noise_p3_index_v1.md](../done/task_gov_docs_noise_p3_index_v1.md) | — | +| 2026-06-06 | [../done/task_gov_docs_noise_p2_readorder_v1.md](../done/task_gov_docs_noise_p2_readorder_v1.md) | — | +| 2026-06-06 | [../done/task_gov_docs_noise_p1_archived_v1.md](../done/task_gov_docs_noise_p1_archived_v1.md) | — | +| 2026-06-06 | [../done/task_gov_docs_noise_p0_readme_v1.md](../done/task_gov_docs_noise_p0_readme_v1.md) | — | +| 2026-05-29 | [../done/task_governance_wiki_t4_ops_v1.md](../done/task_governance_wiki_t4_ops_v1.md) | — | +| 2026-05-29 | [../done/task_governance_wiki_milestone_acceptance_expand_v1.md](../done/task_governance_wiki_milestone_acceptance_expand_v1.md) | — | +| 2026-05-29 | [../done/task_governance_task_schedule_wiki_bridge_v1.md](../done/task_governance_task_schedule_wiki_bridge_v1.md) | — | +| 2026-05-28 | [../done/task_governance_wiki_unit_ab_closeout_v1.md](../done/task_governance_wiki_unit_ab_closeout_v1.md) | — | +| 2026-05-28 | [../done/task_governance_wiki_t4_rollout_v1.md](../done/task_governance_wiki_t4_rollout_v1.md) | — | +| 2026-05-28 | [../done/task_governance_wiki_ingest_batch_3_v1.md](../done/task_governance_wiki_ingest_batch_3_v1.md) | — | +| 2026-05-28 | [../done/task_governance_wiki_docs_hygiene_v1.md](../done/task_governance_wiki_docs_hygiene_v1.md) | — | +| 2026-05-28 | [../done/task_governance_l2_phase_c_impl_v1.md](../done/task_governance_l2_phase_c_impl_v1.md) | — | +| 2026-05-27 | [../done/task_governance_wiki_t4_expand_v2.md](../done/task_governance_wiki_t4_expand_v2.md) | — | +| 2026-05-27 | [../done/task_governance_wiki_ingest_batch_v1.md](../done/task_governance_wiki_ingest_batch_v1.md) | — | +| 2026-05-27 | [../done/task_governance_wiki_ingest_batch_2_v1.md](../done/task_governance_wiki_ingest_batch_2_v1.md) | — | +| 2026-05-27 | [../done/task_governance_wiki_ctx_ab_representative_v1.md](../done/task_governance_wiki_ctx_ab_representative_v1.md) | — | +| 2026-05-27 | [../done/task_governance_wiki_agent_readorder_v1.md](../done/task_governance_wiki_agent_readorder_v1.md) | — | +| 2026-05-27 | [../done/task_governance_t4_spec_active_v1.md](../done/task_governance_t4_spec_active_v1.md) | — | +| 2026-05-27 | [../done/task_governance_l2_phase_c_design_v1.md](../done/task_governance_l2_phase_c_design_v1.md) | — | +| 2026-05-27 | [../done/task_governance_l2_manifest_ci_v1.md](../done/task_governance_l2_manifest_ci_v1.md) | — | +| 2026-05-26 | [../done/task_wiki_ctx_ab_v1.md](../done/task_wiki_ctx_ab_v1.md) | — | +| 2026-05-26 | [../done/task_wiki_ctx_ab_multi_slug_v1.md](../done/task_wiki_ctx_ab_multi_slug_v1.md) | — | +| 2026-05-26 | [../done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md](../done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md) | — | +| 2026-05-26 | [../done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md](../done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md) | — | +| 2026-05-26 | [../done/task_governance_wiki_spec_comparison_sync_v1.md](../done/task_governance_wiki_spec_comparison_sync_v1.md) | — | +| 2026-05-26 | [../done/task_governance_wiki_bq3_spec_schedule_sync_v1.md](../done/task_governance_wiki_bq3_spec_schedule_sync_v1.md) | — | +| 2026-05-26 | [../done/task_governance_recent_schedule_wiki_sync_v1.md](../done/task_governance_recent_schedule_wiki_sync_v1.md) | — | +| 2026-05-26 | [../done/task_governance_loop_c2_verify_r2_index_sync_v1.md](../done/task_governance_loop_c2_verify_r2_index_sync_v1.md) | — | +| 2026-05-26 | [../done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md](../done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md) | — | +| 2026-05-26 | [../done/task_coding_wiki_t1c_test_archive_v1.md](../done/task_coding_wiki_t1c_test_archive_v1.md) | — | +| 2026-05-26 | [../done/task_coding_wiki_schema_test_strategy_rule_v1.md](../done/task_coding_wiki_schema_test_strategy_rule_v1.md) | — | +| 2026-05-26 | [../done/task_coding_wiki_pilot_v1.md](../done/task_coding_wiki_pilot_v1.md) | — | +| 2026-05-26 | [../done/task_coding_wiki_ingest_test_strategy_v1.md](../done/task_coding_wiki_ingest_test_strategy_v1.md) | — | +| 2026-05-22 | [../done/task_docs_tasks_reorg_move_v1.md](../done/task_docs_tasks_reorg_move_v1.md) | — | +| 2026-04-28 | [../done/task_docs_truth_and_rag_unify_v1.md](../done/task_docs_truth_and_rag_unify_v1.md) | — | +| — | [../done/task_governance_wiki_t4_r2_l0_align_v1.md](../done/task_governance_wiki_t4_r2_l0_align_v1.md) | — | +| — | [../done/task_governance_wiki_t4_r1_pilot_v1.md](../done/task_governance_wiki_t4_r1_pilot_v1.md) | — | +| — | [../done/task_governance_l2_r3_test_manifest_v1.md](../done/task_governance_l2_r3_test_manifest_v1.md) | — | + +## chatbi（ChatBI V2/V3 · unified chat） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-04 | [../done/task_chatbi_intent_hints_step1_v1.md](../done/task_chatbi_intent_hints_step1_v1.md) | — | +| 2026-06-04 | [../done/task_chatbi_graph_p0_foundation_v1.md](../done/task_chatbi_graph_p0_foundation_v1.md) | — | +| 2026-05-29 | [../done/task_chatbi_v3_p2_resilience_rate_limit_v1.md](../done/task_chatbi_v3_p2_resilience_rate_limit_v1.md) | — | +| 2026-05-29 | [../done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md](../done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md) | — | +| 2026-05-29 | [../done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md](../done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md) | — | +| 2026-05-25 | [../done/task_chatbi_v3_p2_resilience_health_ready_v1.md](../done/task_chatbi_v3_p2_resilience_health_ready_v1.md) | — | +| 2026-05-24 | [../done/task_chatbi_v3_p2_resilience_v1.md](../done/task_chatbi_v3_p2_resilience_v1.md) | — | +| 2026-05-22 | [../done/task_chatbi_v2_acceptance_runner_v1.md](../done/task_chatbi_v2_acceptance_runner_v1.md) | — | +| 2026-05-22 | [../done/task_05_query_rewrite_observability.md](../done/task_05_query_rewrite_observability.md) | — | +| 2026-05-20 | [../done/task_chatbi_v3_prompt_injection_guard_poc_v1.md](../done/task_chatbi_v3_prompt_injection_guard_poc_v1.md) | — | +| 2026-05-14 | [../done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md](../done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md) | — | +| 2026-05-11 | [../done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md](../done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md) | — | +| 2026-05-11 | [../done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md](../done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md) | — | +| 2026-05-11 | [../done/task_chatbi_v2_incremental_sse_backend_v1.md](../done/task_chatbi_v2_incremental_sse_backend_v1.md) | — | +| 2026-05-11 | [../done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md](../done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md) | — | +| 2026-05-11 | [../done/task_chatbi_v2_agent_p1_behavior.md](../done/task_chatbi_v2_agent_p1_behavior.md) | — | +| 2026-05-06 | [../done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md](../done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md) | — | +| 2026-04-30 | [../done/task_unified_chat_router_trace_text2sql_exec_v1.md](../done/task_unified_chat_router_trace_text2sql_exec_v1.md) | — | +| 2026-04-30 | [../done/task_unified_chat_router_observability_full_trace_v1.md](../done/task_unified_chat_router_observability_full_trace_v1.md) | — | +| 2026-04-30 | [../done/task_unified_chat_router_evidence_observability_v1.md](../done/task_unified_chat_router_evidence_observability_v1.md) | — | +| 2026-04-30 | [../done/task_unified_chat_router_evidence_event_v1.md](../done/task_unified_chat_router_evidence_event_v1.md) | — | +| 2026-04-29 | [../done/task_chatbi_v2_agent_p0_backend.md](../done/task_chatbi_v2_agent_p0_backend.md) | — | +| 2026-04-29 | [../done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md](../done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md) | — | +| 2026-04-29 | [../done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md](../done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md) | — | +| 2026-04-28 | [../done/done_unified_chat_streaming_backend_sse_v1.md](../done/done_unified_chat_streaming_backend_sse_v1.md) | — | +| 2026-04-28 | [../done/done_unified_chat_backend_v1.md](../done/done_unified_chat_backend_v1.md) | — | +| — | [../done/task_text2sql_schema_prefetch_before_mutate_v1.md](../done/task_text2sql_schema_prefetch_before_mutate_v1.md) | — | +| — | [../done/task_portfolio_rag_demo_v1.md](../done/task_portfolio_rag_demo_v1.md) | — | +| — | [../done/task_intent_router_backend_v1.md](../done/task_intent_router_backend_v1.md) | — | +| — | [../done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md](../done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md) | — | +| — | [../done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md](../done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md) | — | +| — | [../done/task_chatbi_v3_lowconf_sql_preview_v1.md](../done/task_chatbi_v3_lowconf_sql_preview_v1.md) | — | +| — | [../done/task_chatbi_v3_lowconf_rag_preview_v1.md](../done/task_chatbi_v3_lowconf_rag_preview_v1.md) | — | +| — | [../done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md](../done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md) | — | +| — | [../done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md](../done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md) | — | +| — | [../done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md](../done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md) | — | +| — | [../done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md](../done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md) | — | +| — | [../done/task_chatbi_level_gate_v1.md](../done/task_chatbi_level_gate_v1.md) | — | +| — | [../done/task_chatbi_intent_llm_retry_u1_5_v1.md](../done/task_chatbi_intent_llm_retry_u1_5_v1.md) | — | +| — | [../done/task_chatbi_intent_hints_step2_v1.md](../done/task_chatbi_intent_hints_step2_v1.md) | — | +| — | [../done/task_chatbi_baseline_merge_gate_v1.md](../done/task_chatbi_baseline_merge_gate_v1.md) | — | +| — | [../done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md](../done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md) | — | + +## engineering（图谱闸口 / RAG / 跨仓工程） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-06 | [../done/task_rag_keyword_websearch_date_normalize_v1.md](../done/task_rag_keyword_websearch_date_normalize_v1.md) | — | +| 2026-06-06 | [../done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md](../done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md) | — | +| 2026-06-06 | [../done/task_rag_b2_fts_alias_backfill_v1.md](../done/task_rag_b2_fts_alias_backfill_v1.md) | — | +| 2026-06-06 | [../done/task_rag_b1_metadata_structured_recall_v1.md](../done/task_rag_b1_metadata_structured_recall_v1.md) | — | +| 2026-06-06 | [../done/task_03_hybrid_search_implementation.md](../done/task_03_hybrid_search_implementation.md) | — | +| 2026-06-06 | [../done/Task 04.md](../done/Task 04.md) | — | +| 2026-05-21 | [../done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md](../done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md) | — | +| 2026-05-20 | [../done/task_engineering_tech_graph_gate_c_prime_f1_v1.md](../done/task_engineering_tech_graph_gate_c_prime_f1_v1.md) | — | +| 2026-05-20 | [../done/task_engineering_tech_graph_gate_c_double_prime_v1.md](../done/task_engineering_tech_graph_gate_c_double_prime_v1.md) | — | +| 2026-05-19 | [../done/task_engineering_tech_graph_v2_query_coverage_v1.md](../done/task_engineering_tech_graph_v2_query_coverage_v1.md) | — | +| 2026-05-18 | [../done/task_engineering_tech_graph_scheme2_completion_v1.md](../done/task_engineering_tech_graph_scheme2_completion_v1.md) | — | +| 2026-05-18 | [../done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md](../done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md) | — | +| 2026-05-17 | [../done/task_engineering_tech_graph_v2_p4_extended_v1.md](../done/task_engineering_tech_graph_v2_p4_extended_v1.md) | — | +| 2026-05-17 | [../done/task_engineering_tech_graph_v2_graph_query_v1.md](../done/task_engineering_tech_graph_v2_graph_query_v1.md) | — | +| 2026-05-15 | [../done/task_engineering_tech_graph_graph_json_export_v1.md](../done/task_engineering_tech_graph_graph_json_export_v1.md) | — | +| 2026-05-15 | [../done/task_engineering_tech_graph_gate_a_token_compare_v1.md](../done/task_engineering_tech_graph_gate_a_token_compare_v1.md) | — | +| 2026-05-15 | [../done/task_engineering_tech_graph_gate_a_perf_compare_v1.md](../done/task_engineering_tech_graph_gate_a_perf_compare_v1.md) | — | +| 2026-05-15 | [../done/task_engineering_chatbi_sse_first_v1.md](../done/task_engineering_chatbi_sse_first_v1.md) | — | +| 2026-04-27 | [../done/task_tech_graph_p7_contract_ci_guardrail_v1.md](../done/task_tech_graph_p7_contract_ci_guardrail_v1.md) | — | +| 2026-04-27 | [../done/task_tech_graph_p5_auto_render_from_manifest_v1.md](../done/task_tech_graph_p5_auto_render_from_manifest_v1.md) | — | +| 2026-04-27 | [../done/task_tech_graph_p4_ci_guardrail_v1.md](../done/task_tech_graph_p4_ci_guardrail_v1.md) | — | +| 2026-04-27 | [../done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md](../done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md) | — | +| 2026-04-24 | [../done/task_rag_i18n_crosslingual_recall_v1.md](../done/task_rag_i18n_crosslingual_recall_v1.md) | — | +| — | [../done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md](../done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md) | — | +| — | [../done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md](../done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md) | — | +| — | [../done/task_tech_graph_p1_manifest_and_validation_v1.md](../done/task_tech_graph_p1_manifest_and_validation_v1.md) | — | +| — | [../done/task_tech_graph_p0_handoff_and_drift_check_v1.md](../done/task_tech_graph_p0_handoff_and_drift_check_v1.md) | — | +| — | [../done/task_backend_improve_batch_a_p0_v1.md](../done/task_backend_improve_batch_a_p0_v1.md) | — | +| — | [../done/README.md](../done/README.md) | — | + +## standards（编码规范 · api 模块化 Epic） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| — | [../done/task_standards_backend_p3_p4_l3_ruff_v1.md](../done/task_standards_backend_p3_p4_l3_ruff_v1.md) | — | +| — | [../done/task_standards_backend_l2_draft_v1.md](../done/task_standards_backend_l2_draft_v1.md) | — | +| — | [../done/task_api_tools_registry_split_w7.md](../done/task_api_tools_registry_split_w7.md) | — | +| — | [../done/task_api_intent_stack_split_w8.md](../done/task_api_intent_stack_split_w8.md) | — | +| — | [../done/task_api_env_rag_env_consolidation_w1.md](../done/task_api_env_rag_env_consolidation_w1.md) | — | +| — | [../done/task_api_agent_loop_split_w6.md](../done/task_api_agent_loop_split_w6.md) | — | + +## epics（母单 · MANIFEST · Loop） + +| 关账日 | Epic / MANIFEST / Loop | 域 | 子 task 索引 | +|--------|------------------------|------|--------------| +| 2026-06-06 | [../done/task_governance_docs_noise_line_manifest_v1.md](../done/task_governance_docs_noise_line_manifest_v1.md) | governance | — | +| 2026-05-30 | [../done/task_harness_p0_openspec_tdd_loop_v1.md](../done/task_harness_p0_openspec_tdd_loop_v1.md) | harness | — | +| 2026-05-29 | [../done/task_chatbi_v3_p2_resilience_loop_v1.md](../done/task_chatbi_v3_p2_resilience_loop_v1.md) | chatbi | — | +| 2026-05-28 | [../done/task_harness_wiki_loop_unit_a_v1.md](../done/task_harness_wiki_loop_unit_a_v1.md) | harness | — | +| 2026-05-27 | [../done/task_harness_wiki_loop_p2_followup_v1.md](../done/task_harness_wiki_loop_p2_followup_v1.md) | harness | — | +| 2026-05-26 | [../done/task_harness_wiki_loop_c2_verify_v1.md](../done/task_harness_wiki_loop_c2_verify_v1.md) | harness | — | +| 2026-05-26 | [../done/task_harness_wiki_loop_bq3_recheck_v1.md](../done/task_harness_wiki_loop_bq3_recheck_v1.md) | harness | — | +| 2026-05-26 | [../done/task_harness_wiki_loop_a1_a4_v1.md](../done/task_harness_wiki_loop_a1_a4_v1.md) | harness | — | +| — | [../done/task_standards_backend_api_modularization_manifest_v1.md](../done/task_standards_backend_api_modularization_manifest_v1.md) | standards | — | +| — | [../done/task_harness_wiki_loop_t4_l2_v1.md](../done/task_harness_wiki_loop_t4_l2_v1.md) | harness | — | +| — | [../done/task_harness_semi_auto_retirement_manifest_v1.md](../done/task_harness_semi_auto_retirement_manifest_v1.md) | harness | — | + +--- + +## 给 Cursor + +`done_by_domain`、`_views`、域分组、Epic、Hub + diff --git a/docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md b/docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md new file mode 100644 index 00000000..0c7f7e72 --- /dev/null +++ b/docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md @@ -0,0 +1,307 @@ +# Task：后端 docs/tasks done 索引卫生治理（域 Hub + Wiki 链路同步） + +> **状态**：draft +> **关联 Issue/PR**：待开 PR（文档-only） +> **前端依赖**：无 + +> 落盘规则：新任务一律新建在 `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)`）。 +> **行为变更 Delta / Scenario**：见 **§3 失败路径**；TDD 与分层测试决策见 `[docs/tasks/README.md](../README.md)` **§test_strategy**。 + +--- + +## Harness 元信息（执行 Agent 必读） + + +| 字段 | 值 | +| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | +| **module_id** | `none` | +| **graph_delta** | `none` | +| **graph_delta_note** | 纯文档索引 + Wiki 指针治理；无 `api/` 拓扑变更 | +| **test_strategy** | `not_applicable` | +| **test_strategy_note** | 无 `api/` 行为变更；验证靠链接自检 + 50 书面复检 | +| **freeze_id** | （本 task 关账后生成，如 `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 等价链） | +| **audit_profile** | `full` | +| **git_branch** | `task/governance-tasks-done-hygiene-v1` | +| **experience_capture** | `recommended` | +| **kpi_rubric** | `KPI_RUBRIC_v1_2` | +| **kpi_aggregator** | `CLOSE` | +| **schedule_ref** | `RECENT §6.1 / §6.6 · 治理索引卫生 · done 域化 Hub` | +| **epic** | `治理 · docs/tasks 索引卫生` | +| **blocked_by** | RECENT 治理/backlog 锚点；编码规范 Epic CLOSE（W1～W8 done） | +| **blocks** | 后续 `docs/tasks/done//` 物理迁移子 task（P1） | + + +### 人工闸 `human_gate` + +> **仅人** 可将 `pending` 改为 `approved`；Agent 遇阻塞帽 **拒执行** 所列 `blocks_hats`。 + + +| human_gate_id | status | blocks_hats | 说明 | +| ------------- | -------- | ----------- | ------------------------------------------------- | +| HG-TASK-DRAFT | approved | 22-R1, 30 | 初稿 task 人扫：字段完整性、验收可执行性、§3 failure_paths、§4 交接物清单 | +| HG-AUDIT-R1 | approved | 30 | 22 R1 落盘 `docs/harness/reviews/` 后人签，确认零阻塞或阻塞已回填 | +| HG-REINSPECT | approved | done, 50 | 50 复检落盘 `docs/tasks/reinspect_results/` 后人签关账 | + + +--- + +## §1 背景与完成态 + +当前 `docs/tasks/done/` 已积累约 **138** 篇已关账 task，全部扁平存放；`_views/done.md` 随之膨胀为长列表，导致： + +- 日常浏览难以按域定位历史任务； +- Agent 开工前读 `_views/done.md` 消耗大量上下文； +- `docs/tasks/README.md` 归档流程未明确域子目录 + Hub 索引纪律； +- Coding Wiki `concepts/task-schedule-ink-backend` 与 `index.md` 未显式链到 done 索引 Hub，L1/L2 边界易漂移。 + +**完成态**： + +- `docs/tasks/done/README.md` 成为按域分组的 Hub，覆盖 `harness / governance / chatbi / engineering / standards / epics` 等主域； +- `_views/done.md` 退化为 ≤15 行薄指针，只链 Hub 与 `done_by_domain.md`； +- `_views/done_by_domain.md` 与 Hub 一致，按域维护； +- `docs/tasks/README.md` 归档流程更新：关账时「Hub 追加一行 + `_views/done.md` 不追加长列表」； +- Coding Wiki `task-schedule-ink-backend.md` + `index.md` + `CODING_WIKI.md` 同步链到 Hub，并写明 L1 task 文件仍是真值、L2 Wiki 只作导航； +- 50 书面复检落盘；文档-only PR 合 `main`。 + +--- + +## §2 范围（30 必须交付） + +### A) `docs/tasks` 索引层 + +- [x] **A1** 新建 `docs/tasks/done/README.md`（Hub · 按域分组表） + - 域：`harness` · `governance` · `chatbi` · `engineering` · `standards` · `epics` + - 每域表：关账日 · 链接 · freeze_id / 一行摘要 + - Epic / MANIFEST / Loop 母单独立一节 + - 底部链 `[FRAGMENT_task_domain_infer_v1_zh.md](../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)` +- [x] **A2** 新建 `docs/tasks/_views/done_by_domain.md` + - 与 Hub 语义一致，路径相对 `../done//task_*.md` + - Epic 母单单独一节 +- [x] **A3** 重写 `docs/tasks/_views/done.md` 为薄指针 + - ≤15 行 + - 快速入口：Hub、`done_by_domain.md`、`in_progress.md` + - 维护纪律：关账更新 Hub / `done_by_domain`；**勿**在本文件追加长列表 +- [x] **A4** `docs/tasks/done//` 目录结构声明（P0 不 mass `git mv`） + - 在 Hub 中说明目标子目录 slug + - 保留现有扁平文件不动，P1 子 task 再分批迁移 +- [x] **A5** 索引表链到 **现有** `done/task_*.md` + - 路径仍用扁平相对路径（如 `../done/task_governance_xxx_v1.md`），确保 P0 不破坏链接 +- [x] **A6** `docs/tasks/README.md` 归档流程更新 + - 在「任务归档流程」中增：「更新 `done/README.md` Hub 对应域表一行」 + - 强化「禁止只把头部改成 done 而文件仍留在 active/」的硬规则 + - 新增「域子目录 + Hub 纪律」段落 + +### B) Coding Wiki 同步（与 task 同 PR） + +- [x] **B1** `docs/coding_wiki/concepts/task-schedule-ink-backend.md` + - 「Epic 分区」与「链接」节增 `docs/tasks/done/README.md` Hub 指针 + - 写明：L1 真值仍在 `RECENT` 与 `done/task_*.md`，L2 Wiki 只链不替代 +- [x] **B2** `docs/coding_wiki/index.md` + - 在「综合」或「维护」节说明：syntheses `source_task` 指向 L1 `done/` 扁平路径；Hub 只改善浏览，不改 frontmatter 真值 +- [x] **B3** `docs/coding_wiki/CODING_WIKI.md` + - §4.1 ingest / §4.2 query 中增「关账更新 Hub 一行」指针 + - 链 `[FRAGMENT_task_domain_infer_v1_zh.md](../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)` +- [x] **B4** 已有 syntheses 的 `source_task` 路径 **保持有效** + - P0 仍扁平路径则不改 frontmatter 路径 + - 若 Hub 路径与旧路径冲突，以旧路径为准，Hub 中注明「待 P1 物理迁移后更新」 + +### C) 40：链接自检结论回填 task + +- [ ] **C1** 运行相对链接自检（可用手工 `rg` / `markdown-link-check` / Python 脚本） +- [ ] **C2** 在 task §8「自检结论」填：命令、pass/fail、BROKEN 链接清单 + +### D) 50：独立复检落盘 + +- [x] **D1** `docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md` +- [x] **D2** 结论：pass / 无阻塞；列出抽检的链接与域表一致性 + +### E) PR + +- [x] **E1** 开 PR 合 `main`，body 含验收勾选 + 50 路径 +- [ ] **E2** CI 绿；文档-only 无 pytest 回归，写明 skip 理由 +- [ ] **E3** `Fixes` 无（或链治理 Epic 若有） + +--- + +## §2.1 非范围 + +- 不批量 `git mv` 138 篇 done task（P1 子 task，本单不阻塞关账）。 +- 不写 `api/`**、不改业务 SPEC 行为。 +- 不为每篇 done task 新建或重写 synthesis。 +- 不迁移 `docs/spec/` 规格文件。 +- 不改 `docs/harness/prompts/` 帽子本体，只链现有 PROMPT。 + +--- + +## §3 失败路径 + +> 本 task 为纯文档索引治理，失败路径聚焦「索引断链 / 流程漂移 / 关账过早」。 + + +| # | Scenario ID | 触发条件 | 系统行为 | 可重试 | 用户/Agent 可见 | 测试 / 检查 | +| --- | -------------------------- | --------------------------------------------------------- | ------------- | --- | ------------- | -------------------------------- | +| F1 | `fp-done-hub-broken-link` | Hub / `_views/done_by_domain.md` 中链到不存在的 `done/task_*.md` | 文档浏览 404 | 否 | 链接失效 | 40 链接自检必须 zero BROKEN | +| F2 | `fp-wiki-drift-from-l1` | Coding Wiki 写成「done 域化已完成」，但 `done/` 仍扁平 | Agent 误判真值 | 否 | 双轨信息 | 50 抽检 Wiki 与 task 正文一致性 | +| F3 | `fp-reinspect-missing` | 50 未落盘即关账或合并 PR | 关账证据缺失 | 否 | Harness 硬规则违反 | 验收标准强制 D1/D2 | +| F4 | `fp-views-done-rebloated` | `_views/done.md` 被改回长列表 | 薄指针失效 | 否 | 索引回退 | 40 检查 `_views/done.md` 行数 ≤15 | +| F5 | `fp-agent-reads-old-views` | Agent 只读旧 `_views/done.md` 长列表而忽略 Hub | 上下文浪费 / 遗漏域分组 | 是 | 无直接错误 | 在 `README.md` 与 Wiki 读序中显式指向 Hub | + + +> **思考未闭合**：§5 仍有 `（待填）` 且无合法 **思考轮控制** → 22 **退回 10** · 30 **拒开工**。 + +--- + +## §4 给 10-task / 执行链的交接物 + +1. **invoke 目录**：`docs/harness/invokes/by-task/governance-tasks-done-hygiene/` + - `README.md`：索引 · 链最终目的与帽序 22→30→40→50→PR + - `PROMPT_kimi_agent_rethink_R1_R5.md`：10-task 用，含 R0–R5 思考轮框架 + - `PROMPT_30_execute_docs_v1_zh.md`：30 专用，列 A+B 文件清单，禁止写 `api/`** +2. **必读**： + - `docs/tasks/README.md` + - `docs/tasks/_views/done.md` + - `docs/coding_wiki/CODING_WIKI.md` + - `docs/coding_wiki/concepts/task-schedule-ink-backend.md` + - `[FRAGMENT_task_domain_infer_v1_zh.md](../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)` +3. **gate-check**：执行 30 前须确认 `HG-TASK-DRAFT` 与 `HG-AUDIT-R1` 均为 `approved`；若未签，拒执行并输出阻塞闸 ID。 + +--- + +## §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)`。 + +### 思考轮控制（Agent 填 · 22 审） + + +| 字段 | 值 | +| --------------------- | ------------------------- | +| **actual_last_round** | `R5` / `R3` / … | +| **early_stop** | `no` / `yes` | +| **early_stop_reason** | （`early_stop=yes` **必填**） | +| **residual_risks** | `none` 或逐条（**必填**） | + + +### R0 · 读 task / SPEC / 非范围 + +**回填区：** `（待填）` + +### R1 · 代码事实 + +**回填区：** `（待填）` + +### R2 · 方案对比 + +**回填区：** `（待填）` + +### R3 · 边界 / 测试 / failure_paths + +**回填区：** `（待填）` + +### R4 · 链接自检 / PR 策略 + +**回填区：** `（待填）` + +### R5 · 图谱/契约增量 + 关账判断 + +**回填区：** `（待填）` + +--- + +## §6 依赖与引用 + + +| 依赖项 | 路径/说明 | +| ------------------- | ------------------------------------------------------------------------ | +| **编码规范 L2** | `docs/standards/CODING_BACKEND_L2_v1_zh.md` | +| **PROJECT_CONFIG** | `docs/meta/PROJECT_CONFIG_AI_INK_BRAIN_API_PYTHON.md` | +| **Task 落盘规则** | `docs/tasks/README.md` | +| **排期真值** | `docs/tasks/RECENT_TASK_SCHEDULE.md` §6.1 / §6.6 | +| **Wiki Schema** | `docs/coding_wiki/CODING_WIKI.md` | +| **Wiki 排期 hub** | `docs/coding_wiki/concepts/task-schedule-ink-backend.md` | +| **域推断 FRAGMENT** | `cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md` | +| **工作区 done Hub 样例** | `Projects/docs/harness/tasks/done/README.md` | +| **链式常模** | `docs/spec/governance/SPEC-Governance-Harness-Chain-Orchestration-v1.md` | +| **关闭回溯** | `docs/harness/prompts/handoff/HANDOFF_CLOSE_TRACE.md` | + + +--- + +## §7 给执行帽的必读列表 + +- `AGENTS.md` +- `docs/tasks/README.md` +- `docs/tasks/_views/done.md` +- `docs/coding_wiki/CODING_WIKI.md` +- `docs/coding_wiki/concepts/task-schedule-ink-backend.md` +- `docs/coding_wiki/index.md` +- `docs/harness/prompts/handoff/HANDOFF_CLOSE_TRACE.md` +- `cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md` + +--- + +## §8 自检结论（执行者 · 40 帽回填） + + +| 项 | 结果 | +| --- | ----------------------------------------------------------------------------------------------------------------------------------- | +| 命令 | `python3 /tmp/check_links2.py`（扫描 7 个文件：`docs/tasks/done/README.md`、`_views/done_by_domain.md`、`_views/done.md`、`docs/tasks/README.md`、`docs/coding_wiki/concepts/task-schedule-ink-backend.md`、`docs/coding_wiki/index.md`、`docs/coding_wiki/CODING_WIKI.md`） | +| 结论 | `pass` | +| 要点 | 356 个仓内相对链接 zero BROKEN；3 个跨仓链接指向 `cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md`（工作区中存在，本仓独立检查时不计入 broken）；`_views/done.md` 行数 10 ≤15。 | + + +--- + +## §9 实现备忘（由子 Agent 回填） + + +| 项 | 内容 | +| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 涉及文件 | `docs/tasks/done/README.md` · `docs/tasks/_views/done_by_domain.md` · `docs/tasks/_views/done.md` · `docs/tasks/README.md` · `docs/coding_wiki/concepts/task-schedule-ink-backend.md` · `docs/coding_wiki/index.md` · `docs/coding_wiki/CODING_WIKI.md` | +| 关键 env | 无 | +| SQL 执行顺序 | 无 | +| 接口变更 | 无 | +| 图谱变更点 | 无 | + + +--- + +## §10 验收标准 + +- [x] `done/README.md` 可按域浏览，覆盖 `harness / governance / chatbi / engineering / standards / epics` 主域 +- [x] `_views/done.md` ≤15 行，且指向 Hub +- [x] `_views/done_by_domain.md` 与 Hub 一致 +- [x] 索引相对链接自检 zero BROKEN +- [x] `docs/tasks/README.md` 归档流程已更新（域子目录 + Hub 纪律） +- [x] Coding Wiki：`task-schedule-ink-backend` + `index.md` + `CODING_WIKI.md` 已链 Hub，读序写明 L1 vs L2 +- [x] 50 reinspect 落盘，结论 pass/无阻塞 +- [ ] PR 已开，CI 绿（文档-only，pytest 无回归，body 写明 skip 理由） + +**测试 / TDD（与 `test_strategy` 对齐）**： + + +| test_strategy | 自检须含 | +| ---------------- | ---------------------------------- | +| `not_applicable` | `test_strategy_note` 一行理由 + 链接自检命令 | + + +**合并前必绿（本仓）**：文档-only PR 无 `api/` 变更，pytest 不强制重跑；但仍须 `ruff check` / `markdown` 质量检查通过（若 CI 配置）。 + +--- + +## §11 执行路线与 Commit 回溯（关闭轮回填） + +> 见 `[HANDOFF_CLOSE_TRACE.md](../harness/prompts/handoff/HANDOFF_CLOSE_TRACE.md)` §2。 +> 本 task 关账时由 22/40/50 回填：阶段表、分仓 commit、关联工件路径。 + +--- + +## 给 Cursor + +`governance-tasks-done-hygiene`、`done/README.md`、`_views/done.md`、`done_by_domain.md`、`FRAGMENT_task_domain_infer_v1_zh.md`、`test_strategy: not_applicable`、`failure_paths`、`human_gate`、`audit_profile: full`、`git_branch`、`RECENT §6.1`、`Hub`、`薄指针`、`域子目录` \ No newline at end of file diff --git a/docs/tasks/done/README.md b/docs/tasks/done/README.md new file mode 100644 index 00000000..e16bd693 --- /dev/null +++ b/docs/tasks/done/README.md @@ -0,0 +1,213 @@ +# done/ · 已完成任务导航（Hub） + +> **用途**：日常浏览 **只打开本文件**；`_views/done.md` 为薄指针。 +> **真值**：各 task 文件头部 `状态` + `docs/tasks/done/`（或域子目录）物理位置。 +> **P0 说明**：本 Hub 已按域分组，但物理文件仍扁平存放于 `done/`；P1 子 task 再分批 `git mv` 到 `done//`。 + +--- + +## 域目录（domain） + +| 域 slug | 说明 | 目录（P1 目标） | +|---------|------|----------------| +| `harness` | 本仓流程 / CI / 帽子 | `done/harness/` | +| `governance` | Wiki / 索引 / 治理线 | `done/governance/` | +| `chatbi` | ChatBI V2/V3 · unified chat | `done/chatbi/` | +| `engineering` | 图谱闸口 / RAG / 跨仓工程 | `done/engineering/` | +| `standards` | 编码规范 · api 模块化 Epic | `done/standards/` | +| `epics` | 母单 · MANIFEST · Loop | `done/epics/` | + +**推断**：[`FRAGMENT_task_domain_infer_v1_zh.md`](../../../cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md)。 + +--- +## harness（本仓流程 / CI / 帽子） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-02 | [task_harness_invokes_by_task_prompts_sync_v1.md](./task_harness_invokes_by_task_prompts_sync_v1.md) | — | +| 2026-05-30 | [task_harness_p0_task_validate_v1.md](./task_harness_p0_task_validate_v1.md) | — | +| 2026-05-30 | [task_harness_p0_status_cursor_v1.md](./task_harness_p0_status_cursor_v1.md) | — | +| 2026-05-30 | [task_harness_p0_audit_selfcheck_v1.md](./task_harness_p0_audit_selfcheck_v1.md) | — | +| 2026-05-29 | [task_harness_theory_align_p1_v1.md](./task_harness_theory_align_p1_v1.md) | — | +| 2026-05-29 | [task_harness_theory_align_p0_v1.md](./task_harness_theory_align_p0_v1.md) | — | +| 2026-05-26 | [task_harness_workspace_taxonomy_promote_v1.md](./task_harness_workspace_taxonomy_promote_v1.md) | — | +| 2026-05-23 | [task_harness_p1_docs_consolidation_v1.md](./task_harness_p1_docs_consolidation_v1.md) | — | +| 2026-05-22 | [task_harness_in_repo_prompts_and_rules_v1.md](./task_harness_in_repo_prompts_and_rules_v1.md) | — | +| — | [task_harness_semi_auto_retirement_phase2_v1.md](./task_harness_semi_auto_retirement_phase2_v1.md) | — | +| — | [task_harness_kpi_v1_2_pilot_v1.md](./task_harness_kpi_v1_2_pilot_v1.md) | — | +| — | [task_harness_chain_orchestration_spec_v1.md](./task_harness_chain_orchestration_spec_v1.md) | — | + +## governance（Wiki / 索引 / 治理线） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-08 | [task_governance_kimi_harness_pilot_recentsync_v1.md](./task_governance_kimi_harness_pilot_recentsync_v1.md) | — | +| 2026-06-06 | [task_gov_docs_noise_p3_index_v1.md](./task_gov_docs_noise_p3_index_v1.md) | — | +| 2026-06-06 | [task_gov_docs_noise_p2_readorder_v1.md](./task_gov_docs_noise_p2_readorder_v1.md) | — | +| 2026-06-06 | [task_gov_docs_noise_p1_archived_v1.md](./task_gov_docs_noise_p1_archived_v1.md) | — | +| 2026-06-06 | [task_gov_docs_noise_p0_readme_v1.md](./task_gov_docs_noise_p0_readme_v1.md) | — | +| 2026-05-29 | [task_governance_wiki_t4_ops_v1.md](./task_governance_wiki_t4_ops_v1.md) | — | +| 2026-05-29 | [task_governance_wiki_milestone_acceptance_expand_v1.md](./task_governance_wiki_milestone_acceptance_expand_v1.md) | — | +| 2026-05-29 | [task_governance_task_schedule_wiki_bridge_v1.md](./task_governance_task_schedule_wiki_bridge_v1.md) | — | +| 2026-05-28 | [task_governance_wiki_unit_ab_closeout_v1.md](./task_governance_wiki_unit_ab_closeout_v1.md) | — | +| 2026-05-28 | [task_governance_wiki_t4_rollout_v1.md](./task_governance_wiki_t4_rollout_v1.md) | — | +| 2026-05-28 | [task_governance_wiki_ingest_batch_3_v1.md](./task_governance_wiki_ingest_batch_3_v1.md) | — | +| 2026-05-28 | [task_governance_wiki_docs_hygiene_v1.md](./task_governance_wiki_docs_hygiene_v1.md) | — | +| 2026-05-28 | [task_governance_l2_phase_c_impl_v1.md](./task_governance_l2_phase_c_impl_v1.md) | — | +| 2026-05-27 | [task_governance_wiki_t4_expand_v2.md](./task_governance_wiki_t4_expand_v2.md) | — | +| 2026-05-27 | [task_governance_wiki_ingest_batch_v1.md](./task_governance_wiki_ingest_batch_v1.md) | — | +| 2026-05-27 | [task_governance_wiki_ingest_batch_2_v1.md](./task_governance_wiki_ingest_batch_2_v1.md) | — | +| 2026-05-27 | [task_governance_wiki_ctx_ab_representative_v1.md](./task_governance_wiki_ctx_ab_representative_v1.md) | — | +| 2026-05-27 | [task_governance_wiki_agent_readorder_v1.md](./task_governance_wiki_agent_readorder_v1.md) | — | +| 2026-05-27 | [task_governance_t4_spec_active_v1.md](./task_governance_t4_spec_active_v1.md) | — | +| 2026-05-27 | [task_governance_l2_phase_c_design_v1.md](./task_governance_l2_phase_c_design_v1.md) | — | +| 2026-05-27 | [task_governance_l2_manifest_ci_v1.md](./task_governance_l2_manifest_ci_v1.md) | — | +| 2026-05-26 | [task_wiki_ctx_ab_v1.md](./task_wiki_ctx_ab_v1.md) | — | +| 2026-05-26 | [task_wiki_ctx_ab_multi_slug_v1.md](./task_wiki_ctx_ab_multi_slug_v1.md) | — | +| 2026-05-26 | [task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md](./task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md) | — | +| 2026-05-26 | [task_wiki_ctx_ab_multi_bq3_recheck_v1.md](./task_wiki_ctx_ab_multi_bq3_recheck_v1.md) | — | +| 2026-05-26 | [task_governance_wiki_spec_comparison_sync_v1.md](./task_governance_wiki_spec_comparison_sync_v1.md) | — | +| 2026-05-26 | [task_governance_wiki_bq3_spec_schedule_sync_v1.md](./task_governance_wiki_bq3_spec_schedule_sync_v1.md) | — | +| 2026-05-26 | [task_governance_recent_schedule_wiki_sync_v1.md](./task_governance_recent_schedule_wiki_sync_v1.md) | — | +| 2026-05-26 | [task_governance_loop_c2_verify_r2_index_sync_v1.md](./task_governance_loop_c2_verify_r2_index_sync_v1.md) | — | +| 2026-05-26 | [task_governance_loop_c2_verify_r1_schedule_draft_v1.md](./task_governance_loop_c2_verify_r1_schedule_draft_v1.md) | — | +| 2026-05-26 | [task_coding_wiki_t1c_test_archive_v1.md](./task_coding_wiki_t1c_test_archive_v1.md) | — | +| 2026-05-26 | [task_coding_wiki_schema_test_strategy_rule_v1.md](./task_coding_wiki_schema_test_strategy_rule_v1.md) | — | +| 2026-05-26 | [task_coding_wiki_pilot_v1.md](./task_coding_wiki_pilot_v1.md) | — | +| 2026-05-26 | [task_coding_wiki_ingest_test_strategy_v1.md](./task_coding_wiki_ingest_test_strategy_v1.md) | — | +| 2026-05-22 | [task_docs_tasks_reorg_move_v1.md](./task_docs_tasks_reorg_move_v1.md) | — | +| 2026-04-28 | [task_docs_truth_and_rag_unify_v1.md](./task_docs_truth_and_rag_unify_v1.md) | — | +| — | [task_governance_wiki_t4_r2_l0_align_v1.md](./task_governance_wiki_t4_r2_l0_align_v1.md) | — | +| — | [task_governance_wiki_t4_r1_pilot_v1.md](./task_governance_wiki_t4_r1_pilot_v1.md) | — | +| — | [task_governance_l2_r3_test_manifest_v1.md](./task_governance_l2_r3_test_manifest_v1.md) | — | + +## chatbi（ChatBI V2/V3 · unified chat） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-04 | [task_chatbi_intent_hints_step1_v1.md](./task_chatbi_intent_hints_step1_v1.md) | — | +| 2026-06-04 | [task_chatbi_graph_p0_foundation_v1.md](./task_chatbi_graph_p0_foundation_v1.md) | — | +| 2026-05-29 | [task_chatbi_v3_p2_resilience_rate_limit_v1.md](./task_chatbi_v3_p2_resilience_rate_limit_v1.md) | — | +| 2026-05-29 | [task_chatbi_v3_p2_resilience_circuit_breaker_v1.md](./task_chatbi_v3_p2_resilience_circuit_breaker_v1.md) | — | +| 2026-05-29 | [task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md](./task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md) | — | +| 2026-05-25 | [task_chatbi_v3_p2_resilience_health_ready_v1.md](./task_chatbi_v3_p2_resilience_health_ready_v1.md) | — | +| 2026-05-24 | [task_chatbi_v3_p2_resilience_v1.md](./task_chatbi_v3_p2_resilience_v1.md) | — | +| 2026-05-22 | [task_chatbi_v2_acceptance_runner_v1.md](./task_chatbi_v2_acceptance_runner_v1.md) | — | +| 2026-05-22 | [task_05_query_rewrite_observability.md](./task_05_query_rewrite_observability.md) | — | +| 2026-05-20 | [task_chatbi_v3_prompt_injection_guard_poc_v1.md](./task_chatbi_v3_prompt_injection_guard_poc_v1.md) | — | +| 2026-05-14 | [task_chatbi_v3_sql_ast_text2sql_gate_v1.md](./task_chatbi_v3_sql_ast_text2sql_gate_v1.md) | — | +| 2026-05-11 | [task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md](./task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md) | — | +| 2026-05-11 | [task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md](./task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md) | — | +| 2026-05-11 | [task_chatbi_v2_incremental_sse_backend_v1.md](./task_chatbi_v2_incremental_sse_backend_v1.md) | — | +| 2026-05-11 | [task_chatbi_v2_docs_acceptance_archive_2026-05-11.md](./task_chatbi_v2_docs_acceptance_archive_2026-05-11.md) | — | +| 2026-05-11 | [task_chatbi_v2_agent_p1_behavior.md](./task_chatbi_v2_agent_p1_behavior.md) | — | +| 2026-05-06 | [task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md](./task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md) | — | +| 2026-04-30 | [task_unified_chat_router_trace_text2sql_exec_v1.md](./task_unified_chat_router_trace_text2sql_exec_v1.md) | — | +| 2026-04-30 | [task_unified_chat_router_observability_full_trace_v1.md](./task_unified_chat_router_observability_full_trace_v1.md) | — | +| 2026-04-30 | [task_unified_chat_router_evidence_observability_v1.md](./task_unified_chat_router_evidence_observability_v1.md) | — | +| 2026-04-30 | [task_unified_chat_router_evidence_event_v1.md](./task_unified_chat_router_evidence_event_v1.md) | — | +| 2026-04-29 | [task_chatbi_v2_agent_p0_backend.md](./task_chatbi_v2_agent_p0_backend.md) | — | +| 2026-04-29 | [done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md](./done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md) | — | +| 2026-04-29 | [done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md](./done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md) | — | +| 2026-04-28 | [done_unified_chat_streaming_backend_sse_v1.md](./done_unified_chat_streaming_backend_sse_v1.md) | — | +| 2026-04-28 | [done_unified_chat_backend_v1.md](./done_unified_chat_backend_v1.md) | — | +| — | [task_text2sql_schema_prefetch_before_mutate_v1.md](./task_text2sql_schema_prefetch_before_mutate_v1.md) | — | +| — | [task_portfolio_rag_demo_v1.md](./task_portfolio_rag_demo_v1.md) | — | +| — | [task_intent_router_backend_v1.md](./task_intent_router_backend_v1.md) | — | +| — | [task_chatbi_v3_text2sql_tool_latency_obs_v1.md](./task_chatbi_v3_text2sql_tool_latency_obs_v1.md) | — | +| — | [task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md](./task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md) | — | +| — | [task_chatbi_v3_lowconf_sql_preview_v1.md](./task_chatbi_v3_lowconf_sql_preview_v1.md) | — | +| — | [task_chatbi_v3_lowconf_rag_preview_v1.md](./task_chatbi_v3_lowconf_rag_preview_v1.md) | — | +| — | [task_chatbi_v2_text2sql_multiturn_grounding_v1.md](./task_chatbi_v2_text2sql_multiturn_grounding_v1.md) | — | +| — | [task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md](./task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md) | — | +| — | [task_chatbi_v2_agent_p1_eval_benchmark_v1.md](./task_chatbi_v2_agent_p1_eval_benchmark_v1.md) | — | +| — | [task_chatbi_text2sql_denial_final_answer_no_respin_v1.md](./task_chatbi_text2sql_denial_final_answer_no_respin_v1.md) | — | +| — | [task_chatbi_level_gate_v1.md](./task_chatbi_level_gate_v1.md) | — | +| — | [task_chatbi_intent_llm_retry_u1_5_v1.md](./task_chatbi_intent_llm_retry_u1_5_v1.md) | — | +| — | [task_chatbi_intent_hints_step2_v1.md](./task_chatbi_intent_hints_step2_v1.md) | — | +| — | [task_chatbi_baseline_merge_gate_v1.md](./task_chatbi_baseline_merge_gate_v1.md) | — | +| — | [done_chatbi_v2_agent_p0_backend_full_2026-04-29.md](./done_chatbi_v2_agent_p0_backend_full_2026-04-29.md) | — | + +## engineering（图谱闸口 / RAG / 跨仓工程） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| 2026-06-06 | [task_rag_keyword_websearch_date_normalize_v1.md](./task_rag_keyword_websearch_date_normalize_v1.md) | — | +| 2026-06-06 | [task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md](./task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md) | — | +| 2026-06-06 | [task_rag_b2_fts_alias_backfill_v1.md](./task_rag_b2_fts_alias_backfill_v1.md) | — | +| 2026-06-06 | [task_rag_b1_metadata_structured_recall_v1.md](./task_rag_b1_metadata_structured_recall_v1.md) | — | +| 2026-06-06 | [task_03_hybrid_search_implementation.md](./task_03_hybrid_search_implementation.md) | — | +| 2026-06-06 | [Task 04.md](./Task 04.md) | — | +| 2026-05-21 | [task_engineering_tech_graph_gate_d_v2_tasks_v1.md](./task_engineering_tech_graph_gate_d_v2_tasks_v1.md) | — | +| 2026-05-20 | [task_engineering_tech_graph_gate_c_prime_f1_v1.md](./task_engineering_tech_graph_gate_c_prime_f1_v1.md) | — | +| 2026-05-20 | [task_engineering_tech_graph_gate_c_double_prime_v1.md](./task_engineering_tech_graph_gate_c_double_prime_v1.md) | — | +| 2026-05-19 | [task_engineering_tech_graph_v2_query_coverage_v1.md](./task_engineering_tech_graph_v2_query_coverage_v1.md) | — | +| 2026-05-18 | [task_engineering_tech_graph_scheme2_completion_v1.md](./task_engineering_tech_graph_scheme2_completion_v1.md) | — | +| 2026-05-18 | [task_engineering_tech_graph_gate_c_v2_dual_track_v1.md](./task_engineering_tech_graph_gate_c_v2_dual_track_v1.md) | — | +| 2026-05-17 | [task_engineering_tech_graph_v2_p4_extended_v1.md](./task_engineering_tech_graph_v2_p4_extended_v1.md) | — | +| 2026-05-17 | [task_engineering_tech_graph_v2_graph_query_v1.md](./task_engineering_tech_graph_v2_graph_query_v1.md) | — | +| 2026-05-15 | [task_engineering_tech_graph_graph_json_export_v1.md](./task_engineering_tech_graph_graph_json_export_v1.md) | — | +| 2026-05-15 | [task_engineering_tech_graph_gate_a_token_compare_v1.md](./task_engineering_tech_graph_gate_a_token_compare_v1.md) | — | +| 2026-05-15 | [task_engineering_tech_graph_gate_a_perf_compare_v1.md](./task_engineering_tech_graph_gate_a_perf_compare_v1.md) | — | +| 2026-05-15 | [task_engineering_chatbi_sse_first_v1.md](./task_engineering_chatbi_sse_first_v1.md) | — | +| 2026-04-27 | [task_tech_graph_p7_contract_ci_guardrail_v1.md](./task_tech_graph_p7_contract_ci_guardrail_v1.md) | — | +| 2026-04-27 | [task_tech_graph_p5_auto_render_from_manifest_v1.md](./task_tech_graph_p5_auto_render_from_manifest_v1.md) | — | +| 2026-04-27 | [task_tech_graph_p4_ci_guardrail_v1.md](./task_tech_graph_p4_ci_guardrail_v1.md) | — | +| 2026-04-27 | [task_tech_graph_p3_e2e_boundary_and_contract_v1.md](./task_tech_graph_p3_e2e_boundary_and_contract_v1.md) | — | +| 2026-04-24 | [task_rag_i18n_crosslingual_recall_v1.md](./task_rag_i18n_crosslingual_recall_v1.md) | — | +| — | [task_tech_graph_p6_cross_repo_contract_guardrail_v1.md](./task_tech_graph_p6_cross_repo_contract_guardrail_v1.md) | — | +| — | [task_tech_graph_p2_layered_views_and_failure_paths_v1.md](./task_tech_graph_p2_layered_views_and_failure_paths_v1.md) | — | +| — | [task_tech_graph_p1_manifest_and_validation_v1.md](./task_tech_graph_p1_manifest_and_validation_v1.md) | — | +| — | [task_tech_graph_p0_handoff_and_drift_check_v1.md](./task_tech_graph_p0_handoff_and_drift_check_v1.md) | — | +| — | [task_backend_improve_batch_a_p0_v1.md](./task_backend_improve_batch_a_p0_v1.md) | — | +| — | [README.md](./README.md) | — | + +## standards（编码规范 · api 模块化 Epic） + +| 关账日 | task | freeze_id / 摘要 | +|--------|------|------------------| +| — | [task_standards_backend_p3_p4_l3_ruff_v1.md](./task_standards_backend_p3_p4_l3_ruff_v1.md) | — | +| — | [task_standards_backend_l2_draft_v1.md](./task_standards_backend_l2_draft_v1.md) | — | +| — | [task_api_tools_registry_split_w7.md](./task_api_tools_registry_split_w7.md) | — | +| — | [task_api_intent_stack_split_w8.md](./task_api_intent_stack_split_w8.md) | — | +| — | [task_api_env_rag_env_consolidation_w1.md](./task_api_env_rag_env_consolidation_w1.md) | — | +| — | [task_api_agent_loop_split_w6.md](./task_api_agent_loop_split_w6.md) | — | + +## epics（母单 · MANIFEST · Loop） + +| 关账日 | Epic / MANIFEST / Loop | 域 | 子 task 索引 | +|--------|------------------------|------|--------------| +| 2026-06-06 | [task_governance_docs_noise_line_manifest_v1.md](./task_governance_docs_noise_line_manifest_v1.md) | governance | — | +| 2026-05-30 | [task_harness_p0_openspec_tdd_loop_v1.md](./task_harness_p0_openspec_tdd_loop_v1.md) | harness | — | +| 2026-05-29 | [task_chatbi_v3_p2_resilience_loop_v1.md](./task_chatbi_v3_p2_resilience_loop_v1.md) | chatbi | — | +| 2026-05-28 | [task_harness_wiki_loop_unit_a_v1.md](./task_harness_wiki_loop_unit_a_v1.md) | harness | — | +| 2026-05-27 | [task_harness_wiki_loop_p2_followup_v1.md](./task_harness_wiki_loop_p2_followup_v1.md) | harness | — | +| 2026-05-26 | [task_harness_wiki_loop_c2_verify_v1.md](./task_harness_wiki_loop_c2_verify_v1.md) | harness | — | +| 2026-05-26 | [task_harness_wiki_loop_bq3_recheck_v1.md](./task_harness_wiki_loop_bq3_recheck_v1.md) | harness | — | +| 2026-05-26 | [task_harness_wiki_loop_a1_a4_v1.md](./task_harness_wiki_loop_a1_a4_v1.md) | harness | — | +| — | [task_standards_backend_api_modularization_manifest_v1.md](./task_standards_backend_api_modularization_manifest_v1.md) | standards | — | +| — | [task_harness_wiki_loop_t4_l2_v1.md](./task_harness_wiki_loop_t4_l2_v1.md) | harness | — | +| — | [task_harness_semi_auto_retirement_manifest_v1.md](./task_harness_semi_auto_retirement_manifest_v1.md) | harness | — | + +--- + +## 关账维护（checklist） + +1. `git mv docs/tasks/active/.md docs/tasks/done//.md`（P1 批量迁移时） +2. 头部 `> **状态**：done（YYYY-MM-DD 验收通过）` +3. **本 Hub** 对应域表 **追加一行**（日期 · 链接 · freeze_id 一行摘要） +4. **`_views/done_by_domain.md`** 同步追加 +5. **禁止**向 `_views/done.md` 追加长列表（保持 ≤15 行薄指针） + +--- + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-06-13 | v1：域分组 Hub · 薄指针 · P0 物理路径仍扁平 | + +## 给维护者 + +`done`、`domain`、`Hub`、`_views`、`freeze_id`、`Epic` + 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 new file mode 100644 index 00000000..b7ff90f0 --- /dev/null +++ b/docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md @@ -0,0 +1,72 @@ +# 独立复检报告 · 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) +> **复检日期**：2026-06-13 +> **复检人**：50 帽（独立） +> **结论**：**pass / 无阻塞** + +--- + +## 1. 复检范围 + +- `docs/tasks/done/README.md` — 域 Hub +- `docs/tasks/_views/done_by_domain.md` — 按域分组视图 +- `docs/tasks/_views/done.md` — 薄指针 +- `docs/tasks/README.md` — 归档流程更新 +- `docs/coding_wiki/concepts/task-schedule-ink-backend.md` — Wiki 排期 hub 链路 +- `docs/coding_wiki/index.md` — syntheses source_task 与 Hub 关系说明 +- `docs/coding_wiki/CODING_WIKI.md` — ingest/query 纪律更新 + +--- + +## 2. 抽检清单与结果 + +| # | 检查项 | 方法 | 结果 | +|---|--------|------|------| +| 1 | `_views/done.md` ≤15 行 | `wc -l` | 10 行 ✅ | +| 2 | Hub 覆盖主域 | 目视 | harness / governance / chatbi / engineering / standards / epics 六域 ✅ | +| 3 | Hub 与 `done_by_domain.md` 域表一致 | 抽样对比 10 条 | 一致 ✅ | +| 4 | 所有索引链接有效 | Python 脚本扫描 7 个文件、356 个仓内相对链接 | zero BROKEN ✅ | +| 5 | 跨仓链接可解释 | 核对 `cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md` | 工作区中存在，作为域推断引用 ✅ | +| 6 | `docs/tasks/README.md` 归档流程更新 | 目视 | Hub / `done_by_domain` / 薄指针纪律已写入 ✅ | +| 7 | Coding Wiki 三文件已链 Hub | 目视 + 链接扫描 | task-schedule-ink-backend / index / CODING_WIKI 均含 Hub 指针 ✅ | +| 8 | 无 `api/` 或业务代码变更 | `git diff --name-only` | 仅 markdown 文件 ✅ | +| 9 | task 状态与范围勾选 | 目视 | A1–A6、B1–B4 已勾选；C、D、E 待关账 ✅ | + +--- + +## 3. 域分布核对 + +| 域 | 文件数 | 抽样检查 | +|----|--------|----------| +| harness | 12 | ✅ 链接有效 | +| governance | 39 | ✅ 链接有效 | +| chatbi | 42 | ✅ 链接有效 | +| engineering | 29 | ✅ 链接有效 | +| standards | 6 | ✅ 链接有效 | +| epics | 11 | ✅ 链接有效 | +| **合计** | **139** | 注：含本 task 自身仍在 active，Hub 当前仅列 138 篇 done task | + +--- + +## 4. 发现与说明 + +- **跨仓链接 3 处**：`docs/tasks/done/README.md`、`docs/tasks/README.md`、`docs/coding_wiki/CODING_WIKI.md` 均指向 `cyning-harness/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md`。该文件在工作区 `Projects/cyning-harness/` 中存在，作为域推断规范引用，不视为 broken。 +- **遗留未跟踪文件**：`docs/tasks/active/task_standards_backend_p3_p4_l3_ruff_v1.md` 在 `_views/done.md` 中已标 done（2026-06-09），但仍留在 `active/` 且为未跟踪。该问题已在 task §1 背景中记录，P0 不处理 bulk 迁移，留待后续治理子 task。 +- **薄指针行数**：10 行，满足 ≤15 行要求。 + +--- + +## 5. 结论 + +`governance-tasks-done-hygiene` 文档索引治理满足验收标准前 6 项，无阻塞项。建议进入 PR 流程，并在 PR body 中注明： + +- 文档-only，无 `api/` 行为变更； +- pytest 无回归； +- 50 复检报告路径：[`docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md`](./reinspect_governance_tasks_done_index_hygiene_20260613_v1.md)。 + +--- + +## 给 Cursor + +`governance-tasks-done-hygiene`、reinspect、pass、文档-only、Hub、薄指针、跨仓链接