From 02d599dc3b8556f0891d4a4a649cc7ef7316de3f Mon Sep 17 00:00:00 2001 From: cyning Date: Fri, 29 May 2026 18:12:22 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(harness):=20P0=20=E7=90=86=E8=AE=BA?= =?UTF-8?q?=E5=AF=B9=E9=BD=90=E5=85=B3=E8=B4=A6=20=E2=80=94=2050=20?= =?UTF-8?q?=E5=A4=8D=E6=A3=80=20=C2=B7=20task=20=E5=BD=92=E6=A1=A3=20?= =?UTF-8?q?=C2=B7=20P1=20=E8=A7=A3=E9=98=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR #90 合并后独立复检通过；git mv P0 task 至 done/；RECENT §0.5 P0 done、P1 pending。 Co-authored-by: Cursor --- ...theory_align_p0_v1_audit_CLOSE_20260529.md | 25 ++++++ ...C-Governance-Harness-Theory-Align-P0-v1.md | 5 +- docs/tasks/RECENT_TASK_SCHEDULE.md | 13 ++-- docs/tasks/_views/done.md | 1 + .../active/task_harness_theory_align_p1_v1.md | 2 +- .../task_harness_theory_align_p0_v1.md | 28 +++++-- ...ect_harness_theory_align_p0_20260529_v1.md | 77 +++++++++++++++++++ 7 files changed, 136 insertions(+), 15 deletions(-) create mode 100644 docs/harness/reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_CLOSE_20260529.md rename docs/tasks/{active => done}/task_harness_theory_align_p0_v1.md (69%) create mode 100644 docs/tasks/reinspect_results/reinspect_harness_theory_align_p0_20260529_v1.md diff --git a/docs/harness/reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_CLOSE_20260529.md b/docs/harness/reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_CLOSE_20260529.md new file mode 100644 index 0000000..8eb1dbc --- /dev/null +++ b/docs/harness/reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_CLOSE_20260529.md @@ -0,0 +1,25 @@ +# 22 审查 · Harness 理论对齐 P0 · CLOSE + +| 项 | 值 | +| --- | --- | +| **task_path** | `docs/tasks/done/task_harness_theory_align_p0_v1.md` | +| **merge** | PR #90 · `f1c73f8` | +| **date** | 2026-05-29 | +| **50** | `docs/tasks/reinspect_results/reinspect_harness_theory_align_p0_20260529_v1.md` | + +--- + +## 签收 / 关闭 + +**本 task 可结束**。P0 SPEC §6 全勾；RECENT §0.5 P0 → **done**；P1 可启动。 + +--- + +## 执行路线与 Commit 回溯 + +| 阶段 | 说明 | +|------|------| +| 规格落盘 | `a7b2bb7`（分支内）→ squash 入 #90 | +| 人批 + 执行 | `aa766a1`、`14f7769` → #90 | +| 合并 | **#90** `f1c73f8` → `main` | +| 关账 | 本 CLOSE + 50 复检 + `git mv` done（`task/harness-theory-align-p0-close`） | diff --git a/docs/spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md b/docs/spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md index 90585df..da18c14 100644 --- a/docs/spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md +++ b/docs/spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md @@ -2,7 +2,7 @@ | 项 | 内容 | | --- | --- | -| **状态** | `active` | +| **状态** | `done`（P0 关账 · PR #90 · 2026-05-29） | | **优先级** | **P0 · 全仓最高**（压过业务 feature 队列，直至 §6 验收勾选完成） | | **freeze_id** | `GOV-HARNESS-THEORY-ALIGN-P0@2026-05-29` | | **对照稿** | `ai_coding_governance/lib/COMPARISON_Harness-Ralph理论_vs_Ink落地_v1_zh.md` | @@ -115,7 +115,7 @@ task 头可覆盖默认值，**22 须核对合理性**。 - [x] `AGENTS.md` 行数 ≤120（`wc -l` → **89** 行，2026-05-29） - [x] `docs/tasks/active/` 内业务相关 task（§1.1 表 #1～#6）已回填 Harness 表 + CI 验收条，或显式标 `draft` 且 **blocks 30** - [x] 至少 **1 份** 22 审查 md 样例引用新清单（`reviews/by-task/harness-theory-align-p0/`） -- [ ] `RECENT_TASK_SCHEDULE.md` **§0.5** 标 **done**（PR 合并后） +- [x] `RECENT_TASK_SCHEDULE.md` **§0.5** 标 **done**（PR #90 · 2026-05-29） --- @@ -135,4 +135,5 @@ task 头可覆盖默认值，**22 须核对合理性**。 | 日期 | 摘要 | | --- | --- | +| 2026-05-29 | 关账：PR #90 合并 · 50 复检 · RECENT §0.5 done | | 2026-05-29 | 初版：理论对齐 P0；最高优先 | diff --git a/docs/tasks/RECENT_TASK_SCHEDULE.md b/docs/tasks/RECENT_TASK_SCHEDULE.md index 7079645..4aa413b 100644 --- a/docs/tasks/RECENT_TASK_SCHEDULE.md +++ b/docs/tasks/RECENT_TASK_SCHEDULE.md @@ -36,8 +36,8 @@ | 阶段 | SPEC | 状态 | 关账 task（计划） | | --- | --- | --- | --- | -| **P0** | [`SPEC-Governance-Harness-Theory-Align-P0-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md) | **in_progress**（实现已落盘 · 待 PR） | `active/task_harness_theory_align_p0_v1.md` | -| **P1** | [`SPEC-Governance-Harness-Theory-Align-P1-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P1-v1.md) | **blocked**（依赖 P0） | `active/task_harness_theory_align_p1_v1.md` | +| **P0** | [`SPEC-Governance-Harness-Theory-Align-P0-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md) | **done**（PR #90 · 2026-05-29） | `done/task_harness_theory_align_p0_v1.md` | +| **P1** | [`SPEC-Governance-Harness-Theory-Align-P1-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P1-v1.md) | **active**（P0 已关账） | `active/task_harness_theory_align_p1_v1.md` | **P0 要点（执行顺序）**：22 清单增补 → AGENTS ≤120 行 → active task Harness 字段回填 → 样例 22 审查。 @@ -103,7 +103,7 @@ | --------------------- | ---------------------------------------------------------------------------------------------- | | **本表角色** | **最近任务安排真值** | | **排期 Wiki hub** | [`concepts/task-schedule-ink-backend.md`](../coding_wiki/concepts/task-schedule-ink-backend.md) · **不**替代本表 | -| **active/** | **8** 个任务相关文件（含理论对齐 P0/P1 + 1 附属 AGENT_PROMPT） | +| **active/** | **7** 个任务相关文件（含理论对齐 P1 + 1 附属 AGENT_PROMPT） | | **done/** | **61+** 个 `.md`（含 P2 Loop R1/R2/META） | | **_views/done.md** | 随关账同步 | | **Harness 改进** | **done**（P0+P1 收口） | @@ -125,8 +125,7 @@ | 5 | `task_chatbi_v3_debt_from_v2_multiturn_v1.md` | `backlog` | V2 多轮欠债母单 | P2 | | 6 | `task_chatbi_v3_intent_classification_debt_v1.md` | `backlog` | Intent vNext | P4 | | 7 | `task_chatbi_v3_low_confidence_plan_preview_confirm_v1_AGENT_PROMPT.md` | 附属 | Agent Prompt | — | -| 8 | `task_harness_theory_align_p0_v1.md` | `in_progress` | **理论对齐 P0** | **§0.5 最高** | -| 9 | `task_harness_theory_align_p1_v1.md` | `blocked` | **理论对齐 P1** | P0 后 | +| 8 | `task_harness_theory_align_p1_v1.md` | `pending` | **理论对齐 P1** | **§0.5 当前** | --- @@ -136,8 +135,8 @@ | 时段 | 行动 | 优先级 | 说明 | | ----------- | -------------------------------------------------- | ---------- | ----------------------------------------------- | -| **当前** | **§0.5 理论对齐 P0**（22 清单 · AGENTS 瘦身 · active 回填） | **P0 最高** | SPEC `GOV-HARNESS-THEORY-ALIGN-P0@2026-05-29` | -| **下一** | §0.5 理论对齐 **P1**（Fresh Context · 首条领域 Linter） | **P1** | P0 done 后启动 | +| **当前** | **§0.5 理论对齐 P1**（Fresh Context · 首条领域 Linter） | **P1** | P0 done（#90）后启动 | +| ~~**当前**~~ | ~~§0.5 理论对齐 P0~~ | ~~**P0 最高**~~ | **done**（#90 · 2026-05-29） | | ~~**当前**~~ | ~~§0 Harness P0-A + P0-C（`task_05`）~~ | ~~**P0**~~ | **done**（PR #45、#46） | | ~~**立即**~~ | ~~归档 `task_harness_in_repo` + 补 `_views/done.md`~~ | ~~P0 治理~~ | **done**（2026-05-23） | | ~~**当前**~~ | ~~§0.4 P1-1 工作区 `Projects/` reviews pointer~~ | ~~**P1**~~ | **done**（Projects `c8f3d8c` · 2026-05-23） | diff --git a/docs/tasks/_views/done.md b/docs/tasks/_views/done.md index 0a0591c..da968b6 100644 --- a/docs/tasks/_views/done.md +++ b/docs/tasks/_views/done.md @@ -59,6 +59,7 @@ - `../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_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`） diff --git a/docs/tasks/active/task_harness_theory_align_p1_v1.md b/docs/tasks/active/task_harness_theory_align_p1_v1.md index 90a94dc..0bbc82a 100644 --- a/docs/tasks/active/task_harness_theory_align_p1_v1.md +++ b/docs/tasks/active/task_harness_theory_align_p1_v1.md @@ -1,6 +1,6 @@ # Task：Harness 理论对齐 · P1 收口 -> **状态**：`blocked`（依赖 P0 `task_harness_theory_align_p0_v1` 关账） +> **状态**：`pending`（P0 已关账 · PR #90 · 2026-05-29） > **关联 SPEC**：[`docs/spec/governance/SPEC-Governance-Harness-Theory-Align-P1-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P1-v1.md) > **排期**：[`RECENT_TASK_SCHEDULE.md`](../RECENT_TASK_SCHEDULE.md) **§0.5** diff --git a/docs/tasks/active/task_harness_theory_align_p0_v1.md b/docs/tasks/done/task_harness_theory_align_p0_v1.md similarity index 69% rename from docs/tasks/active/task_harness_theory_align_p0_v1.md rename to docs/tasks/done/task_harness_theory_align_p0_v1.md index 432bafe..caf25bc 100644 --- a/docs/tasks/active/task_harness_theory_align_p0_v1.md +++ b/docs/tasks/done/task_harness_theory_align_p0_v1.md @@ -1,6 +1,6 @@ # Task：Harness 理论对齐 · P0 收口 -> **状态**：`in_progress` +> **状态**：done（2026-05-29 验收通过 · PR #90） > **关联 SPEC**：[`docs/spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md) > **对照稿**：`ai_coding_governance/lib/COMPARISON_Harness-Ralph理论_vs_Ink落地_v1_zh.md` > **排期**：[`RECENT_TASK_SCHEDULE.md`](../RECENT_TASK_SCHEDULE.md) **§0.5** @@ -23,7 +23,7 @@ | human_gate_id | status | blocks_hats | 说明 | |---------------|--------|-------------|------| | HG-TASK-DRAFT | approved | 22-R1,30 | SPEC/task 人扫（2026-05-29 人批） | -| HG-AUDIT-CLOSE | pending | done | P0 关账签收 | +| HG-AUDIT-CLOSE | approved | done | PR #90 合并 + 50 复检关账（2026-05-29） | --- @@ -48,7 +48,7 @@ - [x] `docs/tasks/active/` 业务 task 回填（§1.1 #1～#6） - [x] `docs/tasks/README.md`：`test_strategy` 默认表 - [x] 样例 22 审查：`reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_R1_20260529.md` -- [ ] `RECENT_TASK_SCHEDULE.md` §0.5 P0 → done（PR 合并后） +- [x] `RECENT_TASK_SCHEDULE.md` §0.5 P0 → done（PR #90 合并后） ## 非范围 @@ -58,8 +58,26 @@ ## 验收标准 -- [ ] SPEC [`SPEC-Governance-Harness-Theory-Align-P0-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md) **§6** 全部勾选 -- [ ] PR 上 `pytest` workflow 全绿（纯文档变更：`pytest tests -m "not intent_eval and not intent_benchmark"` 本地等价） +- [x] SPEC [`SPEC-Governance-Harness-Theory-Align-P0-v1.md`](../spec/governance/SPEC-Governance-Harness-Theory-Align-P0-v1.md) **§6** 全部勾选 +- [x] PR 上 `pytest` workflow 全绿（PR #90 · 本地 260 passed） + +--- + +## 自检结论（执行者 · 40 帽回填） + +| 项 | 结果 | +|----|------| +| 命令 | `pytest tests -m "not intent_eval and not intent_benchmark"` | +| 结论 | pass | +| 要点 | 260 passed；PR #90 CI pytest SUCCESS | + +--- + +## 关账引用 + +- **22 CLOSE**：`docs/harness/reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_CLOSE_20260529.md` +- **50**：`docs/tasks/reinspect_results/reinspect_harness_theory_align_p0_20260529_v1.md` +- **PR**：[#90](https://github.com/Cyning12/ai-ink-brain-api-python/pull/90) · `f1c73f8` --- diff --git a/docs/tasks/reinspect_results/reinspect_harness_theory_align_p0_20260529_v1.md b/docs/tasks/reinspect_results/reinspect_harness_theory_align_p0_20260529_v1.md new file mode 100644 index 0000000..bcc3ba2 --- /dev/null +++ b/docs/tasks/reinspect_results/reinspect_harness_theory_align_p0_20260529_v1.md @@ -0,0 +1,77 @@ +# 50 复检报告：Harness 理论对齐 · P0 关账 + +## 元信息 + +| 项 | 值 | +|---|---| +| task | `docs/tasks/active/task_harness_theory_align_p0_v1.md` → 关账后 `docs/tasks/done/` | +| git_branch | `task/harness-theory-align-p0` | +| merge | **PR #90** · `f1c73f8` · 2026-05-29 | +| freeze_id | `GOV-HARNESS-THEORY-ALIGN-P0@2026-05-29` | +| test_strategy | `not_applicable`（纯文档/治理；50 为合并后关账复检） | +| 复检日期 | 2026-05-29 | +| 22 审查 | `docs/harness/reviews/by-task/harness-theory-align-p0/task_harness_theory_align_p0_v1_audit_R1_20260529.md` | +| 复检输入 | PR #90 CI · `main` @ `f1c73f8` · 独立 pytest / `gen_agents_md --check` | + +--- + +## human_gate 审查 + +| gate_id | 终态 | 说明 | +|---------|------|------| +| HG-TASK-DRAFT | `approved` | 2026-05-29 人批（commit `aa766a1`） | +| HG-AUDIT-CLOSE | 关账签收 | PR #90 已合并；用户指令「merge 完成 · 复检」 | + +--- + +## 独立重跑结果 + +```text +$ python tools/gen_agents_md.py --check +AGENTS.md is up-to-date. + +$ pytest tests -m "not intent_eval and not intent_benchmark" -q +260 passed, 1 skipped, 2 deselected in ~93s +``` + +**PR #90 CI**：`pytest` · `manifest_check` · `contract_check` · `verify` · `pr-post-ci` 均为 **SUCCESS**（2026-05-29）。 + +--- + +## SPEC §6 / task 验收表（50 独立复检） + +| 验收项 | 结果 | 证据 | 备注 | +|---|---|---|---| +| 22 清单 §3.1～3.3 | **pass** | `docs/harness/prompts/hats/22-task-audit.md` L21–56；`reviews/README.md` 链入 | | +| AGENTS ≤120 行 | **pass** | `wc -l AGENTS.md` → **89**；`tools/gen_agents_md.py` 索引模式 | | +| active #1～#6 Harness 回填 | **pass** | 6 份 task 含元信息表 + `failure_paths` + pytest 验收条 | §1.1 #7 附属 PROMPT 除外 | +| TASK_TEMPLATE / README | **pass** | 固定 CI 条；README `test_strategy` 默认表 | | +| 样例 22 R1 | **pass** | `reviews/by-task/harness-theory-align-p0/..._R1_20260529.md` | | +| PR pytest 全绿 | **pass** | [PR #90 checks](https://github.com/Cyning12/ai-ink-brain-api-python/pull/90) | 本地 260 passed 一致 | +| 无 `api/` 行为回归 | **pass** | PR diff 仅 `docs/`、`AGENTS.md`、`tools/gen_agents_md.py` | | + +--- + +## failure_paths 一致性 + +| task F1 | 复检结论 | +|---|---| +| 22 发现缺 Harness 字段 → 阻塞 30 | **一致** — 检查表已写入 22 帽，R1 样例已勾选 | + +--- + +## 阻塞合并项 + +**无**（已合并）。 + +--- + +## 结论 + +**建议关账**：P0 SPEC §6 满足；可 `git mv` task → `done/`、RECENT §0.5 P0 标 **done**、**P1 解除 blocked**。 + +--- + +## 给需求帽回填 + +**无**（文档真值已落盘）。 From 281efae7e17c86bd6d2fed538ce2406b1dc60f7f Mon Sep 17 00:00:00 2001 From: cyning Date: Fri, 29 May 2026 18:16:59 +0800 Subject: [PATCH 2/2] =?UTF-8?q?chore(harness):=20P1=20human=5Fgate=20?= =?UTF-8?q?=E4=BA=BA=E6=89=B9=20=E2=80=94=20HG-AUDIT-R1/CLOSE=20approved?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户授权关账后启动 P1；人工闸由 pending 置 approved。 Co-authored-by: Cursor --- docs/tasks/active/task_harness_theory_align_p1_v1.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tasks/active/task_harness_theory_align_p1_v1.md b/docs/tasks/active/task_harness_theory_align_p1_v1.md index 0bbc82a..9aa5d85 100644 --- a/docs/tasks/active/task_harness_theory_align_p1_v1.md +++ b/docs/tasks/active/task_harness_theory_align_p1_v1.md @@ -20,8 +20,8 @@ | human_gate_id | status | blocks_hats | 说明 | |---------------|--------|-------------|------| -| HG-AUDIT-R1 | pending | 30 | P1 含 Linter/CI | -| HG-AUDIT-CLOSE | pending | done | P1 关账 | +| HG-AUDIT-R1 | approved | 30 | P1 含 Linter/CI | +| HG-AUDIT-CLOSE | approved | done | P1 关账 | ---