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
2 changes: 2 additions & 0 deletions docs/coding_wiki/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,3 +71,5 @@

- 时间线:[`log.md`](log.md)
- 新增 ingest:先改 `log.md`,再增 syntheses 行于上表
- 关账任务归档时:同步更新 [`docs/tasks/done/README.md`](../tasks/done/README.md) Hub 对应域表一行 + [`docs/tasks/_views/done_by_domain.md`](../tasks/_views/done_by_domain.md);**保持** [`docs/tasks/_views/done.md`](../tasks/_views/done.md) 薄指针,禁止追加长列表
- 上表 `source_task` 仍指向 `docs/tasks/done/` 扁平路径(L1 真值);浏览历史任务优先用 Hub / `done_by_domain.md`
Original file line number Diff line number Diff line change
@@ -0,0 +1,203 @@
# PROMPT · 30 关账后卫生修复 + 总结 + SKILL 研判

> **类型**:文档-only 跟进(** governance-tasks-done-hygiene 关账后**)
> **前置**:PR #160 已合或分支已含 Hub 交付 · **禁止改 `api/**`**
> **invoke 母目录**:`docs/harness/invokes/by-task/governance-tasks-done-hygiene/`

---

## 背景(审查缺口 · 须修复)

P0 索引治理 **已达标**,但留有小缺口,易误导后续 Agent:


| # | 缺口 | 期望 |
| --- | -------------------------------------------------------------------------- | ----------------------------------------------- |
| G1 | `task_governance_tasks_done_index_hygiene_v1.md` §3「思考未闭合→30 拒开工」与已关账矛盾 | 删或改「已关账 · §5 豁免」 |
| G2 | §5 R0–R5 仍「(待填)」 | 增「关账豁免」注或极简一行回填 |
| G3 | §2 C1/C2 未勾 · §8 已有自检 | 与 §8 对齐勾选 |
| G4 | `reinspect_governance_tasks_done_index_hygiene_20260613_v1.md` 链 `active/` | 改链 `done/task_governance_...` |
| G5 | `coding_wiki/index.md` §维护 未写 Hub / `source_task` 扁平路径 | 补 2~3 bullet |
| G6 | invoke `README.md` 仍链 `active/task_...` | 改 `done/` |
| G7 | (可选)`done/<domain>/` 空目录未建 | `mkdir` 六域 + `epics`(对齐 cyning-harness install) |


**不做**:P1 批量 `git mv` 138 篇 · 不改 syntheses `source_task` 路径。

---

## 可复制块(整段复制 · Open `ai-ink-brain-api-python/`)

```text
你是后端 Harness 执行 Agent(文档-only · 禁止 api/**)。

【任务】
governance-tasks-done-hygiene · 关账后卫生修复 + 总结 + SKILL 研判

【必读】
@docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md
@docs/tasks/done/README.md
@docs/tasks/_views/done.md
@docs/tasks/README.md
@docs/coding_wiki/index.md
@docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md
@docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md
@docs/tasks/skills/SKILL-docs-governance.md
@docs/tasks/skills/SKILL-harness-task.md
@../../../cyning-harness/harness/templates/TASK_done_README.md

【执行清单】

1) 修复 G1–G6(见上文表)
- task §3:移除或替换「§5 待填→30 拒开工」为「本单 docs-only · §5 未走 10 长思考 · 已人签关账」
- task §2:C1/C2 勾选并与 §8 一致
- task §9 或 §11:追加一行「关账后卫生修复 YYYY-MM-DD」
- reinspect:Task 链指向 docs/tasks/done/...
- coding_wiki/index.md §维护:增
· 关账更新 docs/tasks/done/README.md Hub 一行 + done_by_domain
· syntheses source_task 仍指向 L1 扁平 done/*.md(P0);浏览用 Hub
- invoke README:task 真值路径改 done/

2) (可选 G7)创建空目录(若不存在):
docs/tasks/done/{harness,governance,chatbi,engineering,standards,epics}/

3) 链接复检(同关账时方法或简化 rg)
- 至少扫:task · reinspect · index.md · invoke README
- 结论写入 SUMMARY

4) 落盘总结(新建):
docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md

SUMMARY 须含:
· 修复项列表(G1–G7 逐项 pass/skip)
· P0 与 cyning-harness 模板符合度(Hub/薄_views/FRAGMENT/Wiki · 物理域化=P1)
· 与工作区 Harness 试点差异一句话
· SKILL 研判结论(下节模板)
· 是否建议开 follow-up PR(小 docs commit)

5) SKILL 研判(必须写入 SUMMARY §SKILL)

阅读并对比:
- docs/tasks/skills/SKILL-docs-governance.md §关账 hygiene H2(仍写「_views/done 增一行」)
- docs/tasks/skills/SKILL-harness-task.md §关账 checklist 第 3 项(同上)

判定规则:
· 若 H2/checklist 与「Hub + done_by_domain · _views/done 薄指针」冲突 → **须更新 SKILL**
· 若仅措辞过时、无行为冲突 → 更新并标修订记录
· harness-loop-batch / 其他 SKILL:仅在 SUMMARY 写明「无需改」或「原因」

若更新 SKILL:
- 改 H2 为:更新 done/README.md Hub 一行 + done_by_domain;**禁止**向 _views/done.md 追加长列表
- 改 harness-task checklist 第 3 项对齐
- skills/README.md 一览表无需改 ID,可在 SKILL 修订记录写来源 task
- **不**自动标 SKILL 为 active;保持 draft 或原 status,附「须人审」

【验收】
- [ ] G1–G6 已修 · 无矛盾句误导 Agent
- [ ] SUMMARY 已落盘
- [ ] SKILL 研判有明确结论(更新 / 不更新 + 理由)
- [ ] 若改了 SKILL:修订记录 + 来源 task 一行
- [ ] 零 api/** diff

【输出形状】
```text
阶段:关账后卫生 · pass
交付:{文件列表}
SKILL:{更新 SKILL-docs-governance + harness-task | 无需更新 · 理由}
建议:{是否单独 commit/PR}
```

本回复末尾附 SUMMARY 路径 + SKILL 结论摘要。你是后端 Harness 执行 Agent(文档-only · 禁止 api/**)。

【任务】
governance-tasks-done-hygiene · 关账后卫生修复 + 总结 + SKILL 研判

【必读】
@docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md
@docs/tasks/done/README.md
@docs/tasks/_views/done.md
@docs/tasks/README.md
@docs/coding_wiki/index.md
@docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_20260613_v1.md
@docs/harness/invokes/by-task/governance-tasks-done-hygiene/README.md
@docs/tasks/skills/SKILL-docs-governance.md
@docs/tasks/skills/SKILL-harness-task.md
@../../../cyning-harness/harness/templates/TASK_done_README.md

【执行清单】

1) 修复 G1–G6(见上文表)
- task §3:移除或替换「§5 待填→30 拒开工」为「本单 docs-only · §5 未走 10 长思考 · 已人签关账」
- task §2:C1/C2 勾选并与 §8 一致
- task §9 或 §11:追加一行「关账后卫生修复 YYYY-MM-DD」
- reinspect:Task 链指向 docs/tasks/done/...
- coding_wiki/index.md §维护:增
· 关账更新 docs/tasks/done/README.md Hub 一行 + done_by_domain
· syntheses source_task 仍指向 L1 扁平 done/*.md(P0);浏览用 Hub
- invoke README:task 真值路径改 done/

2) (可选 G7)创建空目录(若不存在):
docs/tasks/done/{harness,governance,chatbi,engineering,standards,epics}/

3) 链接复检(同关账时方法或简化 rg)
- 至少扫:task · reinspect · index.md · invoke README
- 结论写入 SUMMARY

4) 落盘总结(新建):
docs/harness/invokes/by-task/governance-tasks-done-hygiene/SUMMARY_post_close_hygiene_20260613.md

SUMMARY 须含:
· 修复项列表(G1–G7 逐项 pass/skip)
· P0 与 cyning-harness 模板符合度(Hub/薄_views/FRAGMENT/Wiki · 物理域化=P1)
· 与工作区 Harness 试点差异一句话
· SKILL 研判结论(下节模板)
· 是否建议开 follow-up PR(小 docs commit)

5) SKILL 研判(必须写入 SUMMARY §SKILL)

阅读并对比:
- docs/tasks/skills/SKILL-docs-governance.md §关账 hygiene H2(仍写「_views/done 增一行」)
- docs/tasks/skills/SKILL-harness-task.md §关账 checklist 第 3 项(同上)

判定规则:
· 若 H2/checklist 与「Hub + done_by_domain · _views/done 薄指针」冲突 → **须更新 SKILL**
· 若仅措辞过时、无行为冲突 → 更新并标修订记录
· harness-loop-batch / 其他 SKILL:仅在 SUMMARY 写明「无需改」或「原因」

若更新 SKILL:
- 改 H2 为:更新 done/README.md Hub 一行 + done_by_domain;**禁止**向 _views/done.md 追加长列表
- 改 harness-task checklist 第 3 项对齐
- skills/README.md 一览表无需改 ID,可在 SKILL 修订记录写来源 task
- **不**自动标 SKILL 为 active;保持 draft 或原 status,附「须人审」

【验收】
- [ ] G1–G6 已修 · 无矛盾句误导 Agent
- [ ] SUMMARY 已落盘
- [ ] SKILL 研判有明确结论(更新 / 不更新 + 理由)
- [ ] 若改了 SKILL:修订记录 + 来源 task 一行
- [ ] 零 api/** diff

【输出形状】
```text
阶段:关账后卫生 · pass
交付:{文件列表}
SKILL:{更新 SKILL-docs-governance + harness-task | 无需更新 · 理由}
建议:{是否单独 commit/PR}

本回复末尾附 SUMMARY 路径 + SKILL 结论摘要。

```

---

## 给维护者

`post-close`、`SKILL-docs-governance`、`Hub`、卫生修复、关账后

## 修订记录

| 日期 | 摘要 |
|------|------|
| 2026-06-13 | v1:关账后 G1–G7 修复 + SUMMARY + SKILL 研判 Prompt |
```

Original file line number Diff line number Diff line change
@@ -1,35 +1,39 @@
# Invoke · governance-tasks-done-hygiene

> **最终目的**:完成后端 `docs/tasks/` done 索引治理,同步 Coding Wiki 链路,50 复检落盘,开 PR 合 `main`(文档-only)。
> **Task 真值**:[`docs/tasks/active/task_governance_tasks_done_index_hygiene_v1.md`](../../active/task_governance_tasks_done_index_hygiene_v1.md)
> **Task 真值**:[`docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md`](../../../../tasks/done/task_governance_tasks_done_index_hygiene_v1.md) · PR #160 · `GOV-TASKS-DONE-HYGIENE@2026-06-13`
> **分支**:`task/governance-tasks-done-hygiene-v1`

---

## 帽序

```text
10-task(起草/ rethink) → 22 R1 审查 → 人签 HG-AUDIT-R1 → 30 执行 → 40 自检 → 50 复检 → 人签 HG-REINSPECT → PR → CLOSE
10-task → 22 R1 → 人签 → 30 → 40 → 50 → 人签 HG-REINSPECT → PR → CLOSE
```

- `10`:由 Kimi Agent / Cursor Task 链承担 R0–R5 思考轮,产出 [`PROMPT_kimi_agent_rethink_R1_R5.md`](./PROMPT_kimi_agent_rethink_R1_R5.md)。
- `22`:审查 task,落盘 `docs/harness/reviews/by-task/governance-tasks-done-hygiene/task_governance_tasks_done_index_hygiene_audit_R1_*.md`。
- `30`:按 [`PROMPT_30_execute_docs_v1_zh.md`](./PROMPT_30_execute_docs_v1_zh.md) 执行文档索引治理,**禁止写 `api/**`。
- `40`:链接自检 + 验收标准回填。
- `50`:独立复检,落盘 `docs/tasks/reinspect_results/reinspect_governance_tasks_done_index_hygiene_*_v1.md`。
- **PR**:文档-only,body 含验收勾选 + 50 路径。

---

## 文件清单
## Prompt 索引

| 文件 | 用途 |
|------|------|
| `PROMPT_kimi_agent_rethink_R1_R5.md` | 10-task / rethink 帽,R0–R5 框架 |
| `PROMPT_30_execute_docs_v1_zh.md` | 30 执行帽专用 Prompt |
| [`PROMPT_kimi_agent_rethink_R1_R5.md`](./PROMPT_kimi_agent_rethink_R1_R5.md) | 10-task · R0–R5 |
| [`PROMPT_30_execute_docs_v1_zh.md`](./PROMPT_30_execute_docs_v1_zh.md) | 30 主交付(Hub + Wiki) |
| [`PROMPT_30_post_close_hygiene_v1_zh.md`](./PROMPT_30_post_close_hygiene_v1_zh.md) | 关账后卫生修复 Prompt |
| [`SUMMARY_post_close_hygiene_20260613.md`](./SUMMARY_post_close_hygiene_20260613.md) | **关账后卫生修复总结(G1–G7 pass · SKILL 已更新)** |
| [`SUMMARY_post_close_hygiene_TEMPLATE.md`](./SUMMARY_post_close_hygiene_TEMPLATE.md) | SUMMARY 骨架模板 |

---

## 关账后

- **2026-06-13**:关账后卫生修复已完成,G1–G7 全部 pass,详见 [`SUMMARY_post_close_hygiene_20260613.md`](./SUMMARY_post_close_hygiene_20260613.md)。
- **SKILL 更新**:`SKILL-docs-governance.md` H2 与 `SKILL-harness-task.md` 关账 checklist 第 3 项已对齐 Hub 纪律;两 SKILL 仍保持 `draft` 状态,待人工审阅后标 `active`。
- **遗留**:P1 子 task 将分批 `git mv` 138 篇 done task 到 `done/<domain>/`。

---

## 给 Cursor

`governance-tasks-done-hygiene`、`_views/done.md`、`done/README.md`、`done_by_domain.md`、文档-only、链接自检
`governance-tasks-done-hygiene`、`post-close`、`SKILL-docs-governance`、`Hub`、卫生修复
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# SUMMARY · post-close hygiene · governance-tasks-done-hygiene

> **状态**:`done`(2026-06-13 关账后卫生修复完成)
> **母 task**:[`docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md`](../../../../tasks/done/task_governance_tasks_done_index_hygiene_v1.md)
> **关联 PR**:#160
> **freeze_id**:`GOV-TASKS-DONE-HYGIENE@2026-06-13`

---

## 1. 修复项(G1–G7)

| ID | 项 | 结果 | 备注 |
|----|-----|------|------|
| G1 | §3 与关账状态矛盾 | pass | 移除「思考未闭合 → 22 退回 10 · 30 拒开工」;补「本单于 2026-06-13 已关账,以下路径在验收时已完成验证」 |
| G2 | §5 思考轮 | pass | 控制表填 `actual_last_round: R0` / `early_stop: yes` / `residual_risks: none`;R0–R5 极简回填 |
| G3 | §2 C1/C2 | pass | 勾选 C1/C2,与 §8 自检结论一致 |
| G4 | reinspect → done 路径 | pass | `reinspect_..._v1.md` Task 链由 `../active/...` 改 `../done/...` |
| G5 | `coding_wiki/index.md` §维护 | pass | 增 Hub / `done_by_domain` 更新纪律 + `source_task` 仍指向 L1 扁平路径 |
| G6 | invoke README 路径 | pass | Task 真值链由 `../../../tasks/done/...` 修正为 `../../../../tasks/done/...`;同时发现 task 内 `../harness/`、`../spec/` 因 `git mv` 到 `done/` 后层级变化而 broken,已统一改为 `../../harness/`、`../../spec/` |
| G7 | 空域目录 mkdir | pass | 新建 `docs/tasks/done/{harness,governance,chatbi,engineering,standards,epics}/` + `.gitkeep` |

---

## 2. 链接复检

- **命令**:`python3 /tmp/check_links_full.py`
- **扫描文件**:11 个(原 7 个关账文件 + task + reinspect + invoke README + post-close Prompt)
- **结果**:`pass` / zero BROKEN
- **总链接**:384 个;跨仓链接 6 个(`cyning-harness/harness/templates/...`);其余仓内相对链接全部有效

---

## 3. 与 cyning-harness 模板符合度

| 项 | P0 符合 | 备注 |
|----|---------|------|
| `done/README.md` Hub | 符合 | 六域分组表 + Epic 母单节 |
| `_views/done.md` ≤15 行 | 符合 | 当前 10 行 |
| `done_by_domain.md` | 符合 | 与 Hub 语义一致 |
| FRAGMENT 链入 | 符合 | task / README / CODING_WIKI 三处 |
| Coding Wiki 三文件 | 符合 | 均链 Hub 并写明 L1 vs L2 |
| 物理 `done/<domain>/` | P1 未做 | 已建空目录作为迁移占位,bulk `git mv` 留待子 task |

---

## 4. 与工作区 Harness 试点差异

本仓 P0 采用「逻辑域化(Hub + `done_by_domain`)+ 物理仍扁平」方案,避免一次性 bulk `git mv` 138 篇 task 带来的链接风险;工作区 `Projects/docs/harness/tasks/done/README.md` 若已物理域化,本仓将在 P1 子 task 中跟进。

---

## 5. SKILL 研判

### 结论

- **是否更新**:是(已更新)
- **涉及 SKILL**:`SKILL-docs-governance` · `SKILL-harness-task`

### 理由

- `SKILL-docs-governance.md` §关账 hygiene **H2** 原写「`_views/done.md` 新增一行链 `../done/task_*.md`」,与 Hub 纪律「`_views/done.md` 薄指针、Hub / `done_by_domain` 更新」直接冲突。
- `SKILL-harness-task.md` §关账 checklist **第 3 项** 原写「`_views/done.md` 一行」,同样冲突。

### 已更新

| SKILL | 变更摘要 | 人审 |
|-------|----------|------|
| `SKILL-docs-governance.md` | H2 改为 Hub + `done_by_domain` 更新;VERIFY 改为查 Hub / `done_by_domain` + 薄指针行数 ≤15;修订记录 v1.1 | 须人审 |
| `SKILL-harness-task.md` | 关账 checklist 第 3 项改为「`_views/done.md` 保持薄指针;更新 Hub + `done_by_domain`」;修订记录 v1.3 | 须人审 |

**未改动**:`harness-loop-batch` / `harness-meta-reinspect` / `pr-post-ci` 等 SKILL 与本单 Hub 纪律无直接冲突。

---

## 6. 建议下一棒

- [x] 单独 docs commit:建议将本 SUMMARY + G1–G7 修复 + SKILL 更新作为一次 docs-only commit(无需新开 task)
- [ ] P1 子 task:`done` 物理域化 batch-1(分批 `git mv` 138 篇到 `done/<domain>/`)
- [ ] 人审 SKILL:`SKILL-docs-governance` 仍标 `draft`,需人审后标 `active`

---

## 7. 修订记录

| 日期 | 摘要 |
|------|------|
| 2026-06-13 | Agent 关账后卫生修复:G1–G7 pass、链接复检 zero broken、SKILL 已更新 |

---

## 给 Cursor

`governance-tasks-done-hygiene`、`post-close`、SUMMARY、SKILL-docs-governance、Hub、薄指针、G1–G7、zero broken
Loading