Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/coding_wiki/CODING_WIKI.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <id>`,再按需 `downstream`/`upstream`。
4. 需影响面/依赖遍历 → **并行** 使用 `graph_query`(L0),不以 Wiki 替代。
5. 答案可写回 Wiki 时:小改直接编辑;大改走新 task + 再 ingest。
Expand Down
8 changes: 5 additions & 3 deletions docs/coding_wiki/concepts/task-schedule-ink-backend.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<slug>.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/<slug>.md` → pointer L1 done task

**禁止**:仅读本 Wiki 页推断排期或改 `api/`;与 RECENT 矛盾时 **L1 为准**。

Expand Down Expand Up @@ -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)
Expand Down
2 changes: 2 additions & 0 deletions docs/coding_wiki/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 真值。

---

## 治理与实验
Expand Down
Original file line number Diff line number Diff line change
@@ -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/<domain>/` 物理位置。
- 按域分组表:
- `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/<domain>/` 目录结构声明

- 在 `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/<domain>/` 规划。
- 引用 `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
Original file line number Diff line number Diff line change
@@ -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
Original file line number Diff line number Diff line change
@@ -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、链接自检
Loading