diff --git a/.cursor/rules/06-harness-pointer.mdc b/.cursor/rules/06-harness-pointer.mdc new file mode 100644 index 00000000..11aebb00 --- /dev/null +++ b/.cursor/rules/06-harness-pointer.mdc @@ -0,0 +1,38 @@ +--- +description: Harness Starter — 读序、task、人工闸与 Verify 纪律(嵌入业务仓 · Cursor) +alwaysApply: true +globs: + - "**/*" +--- + +# Harness Starter(业务仓 · Cursor) + +> **单源真值**:`docs/coding_wiki/` 读序 + `docs/standards/` + `AGENTS.md`。 +> **本规则**:摘要 + **POINTER**;条文真值在 `docs/harness/prompts/`。 + +## 执行 task 前 + +1. Open Folder = **本仓根** +2. 读 `docs/tasks/active/task_*.md`:`test_strategy` · `failure_paths` · **人工闸**表 +3. **30 改码前** GATE_VERIFY(真值在 task **人工闸表**,**非** invoke 字面 `approved`): + - 运行 `npx @cyning/harness verify --target . --task docs/tasks/active/task_*.md` + - 首输出闸扫描 · `FRAGMENT_30_gate_verify_v1_zh.md` + - **`HG-AUDIT-R1` pending** → **30 拒改码** + - 声称与 task 表冲突 → **STOP** +4. 过程 invoke:`docs/harness/invokes/by-task//` + +## Verify(合并前) + +| 栈 | 命令(与 `.github/workflows/` 一致) | +|----|--------------------------------------| +| 前端 | `pnpm lint` → `pnpm test` → `pnpm build` | +| 后端 | `pytest tests`(按仓 marker 裁剪) | +| iOS | `xcodebuild`(见 task `test_strategy_note`) | + +## 关键词 + +`Harness`、`task`、`invoke`、`HG-AUDIT-R1`、`HG-GRAPH-MODULES`、`human_gate`、`拒开工` + +## 完整库 POINTER + +工作区:`docs/harness/prompts/`(22/30/TEMPLATE_30_gate_stop 等) diff --git a/.cyning-harness/QUICKREF.md b/.cyning-harness/QUICKREF.md new file mode 100644 index 00000000..aeeedc02 --- /dev/null +++ b/.cyning-harness/QUICKREF.md @@ -0,0 +1,47 @@ +# cyning-harness · 业务仓速查 + +> 本文件由 `npx @cyning/harness init/upgrade` 自动生成,可手动删除。 + +--- + +## 常用命令 + +```bash +# 30 前聚合验证(gate-check + audit D5 + S5 warn + 可选 --graph) +npx @cyning/harness verify [--target .] [--task docs/tasks/active/task_xxx.md] [--graph] [--json] [--agent-hint] [--workspace-root PATH] + +# 仅人工闸 npx @cyning/harness gate-check [--target .] [--task ...] [--graph] [--json] + +# 生成 invoke 索引 +npx @cyning/harness sync index [--target .] + +# 升级 Harness 过程轨 +npx @cyning/harness upgrade --target . --yes + +# ICVO 审计(指定 task) +npx @cyning/harness audit --target . --task docs/tasks/active/task_xxx.md +``` + +## Node 仓可选路径 + +若 init/upgrade 时使用了 `--with-scripts`: + +```bash +pnpm install +pnpm harness:verify --task docs/tasks/active/task_xxx.md +pnpm harness:gate +pnpm harness:audit --task docs/tasks/active/task_xxx.md +``` + +--- + +## 本地产品包覆盖 + +维护者开发时: + +```bash +export CYNING_HARNESS=/path/to/cyning-harness +npx @cyning/harness verify --target . +``` + +业务仓无需 clone 产品包即可使用 CLI。 diff --git a/.cyning-harness/manifest.json b/.cyning-harness/manifest.json new file mode 100644 index 00000000..2b474222 --- /dev/null +++ b/.cyning-harness/manifest.json @@ -0,0 +1,7 @@ +{ + "version": "2.19.0", + "preset": "harness-only", + "ide": ["cursor","claude","agents"], + "from_version": "2.18.0", + "upgraded_at": "2026-07-28T08:20:36Z" +} diff --git a/.cyning-harness/profile.json b/.cyning-harness/profile.json new file mode 100644 index 00000000..3d06269d --- /dev/null +++ b/.cyning-harness/profile.json @@ -0,0 +1,19 @@ +{ + "version": 1, + "preset": "harness-only", + "description": "仅过程轨 + Cursor 规则(不覆盖图谱/业务 task)", + "paths": { + "ide_cursor": ".cursor/rules/06-harness-pointer.mdc" + }, + "tracks": { + "graph": false, + "wiki": false, + "standards": false, + "harness_prompts": true, + "harness_invoke_template": true, + "ide_cursor": true, + "ide_claude": true, + "ide_agents": true, + "ci": "none" + } +} diff --git a/.gitignore b/.gitignore index be80c9fa..fdb5666d 100644 --- a/.gitignore +++ b/.gitignore @@ -125,3 +125,6 @@ docs/diary/jsonPKmermaid/**/raw/ # --- Harness sessions(B1 · 本地 Inform 真值 · 不入库)--- docs/harness/sessions/** !docs/harness/sessions/README.md + +# cyning-harness local path (machine-specific) +.cyning-harness/local.json diff --git a/AGENTS.md b/AGENTS.md index bfa4b4cc..ff7793a8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -97,3 +97,38 @@ | `40-error-handling.mdc` | Error Handling | 错误处理与降级策略 — 结构化响应、异常分支、备选方案 | 全文附录:`python tools/gen_agents_md.py --full` + + +# Harness Starter(业务仓 · 通用 Agent) + +> **单源真值**:`docs/coding_wiki/` 读序 + `docs/standards/` + 本文件其余业务约定。 +> **本片段**:摘要 + **POINTER**;Harness 条文真值在 `docs/harness/prompts/`。 + +## 执行 task 前 + +1. Open Folder = **本仓根** +2. 读 `docs/tasks/active/task_*.md`:`test_strategy` · `failure_paths` · **人工闸**表 +3. **30 改码前** GATE_VERIFY(真值在 task **人工闸表**,**非**聊天 / invoke 字面 `approved`): + - 运行 `npx @cyning/harness verify --target . --task docs/tasks/active/task_*.md` + - 首输出闸扫描表 · 见 `docs/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md` + - **`HG-AUDIT-R1` pending** → **30 拒改码**(须维护者签 task 表 `approved`) + - **`HG-GRAPH-MODULES` pending** → **30 拒改码**(D4-a) + - 用户声称与 task 表冲突 → **STOP** · 以 task 表为准 +4. 过程 invoke:`docs/harness/invokes/by-task//` + +## Verify(合并前) + +| 栈 | 命令(与 `.github/workflows/` 一致) | +|----|--------------------------------------| +| 前端 | `pnpm lint` → `pnpm test` → `pnpm build` | +| 后端 | `pytest tests`(按仓 marker 裁剪) | +| iOS | `xcodebuild`(见 task `test_strategy_note`) | + +## 关键词 + +`Harness`、`task`、`invoke`、`HG-AUDIT-R1`、`HG-GRAPH-MODULES`、`human_gate`、`拒开工` + +## 完整库 POINTER + +工作区:`docs/harness/prompts/`(22/30/TEMPLATE_30_gate_stop 等) + diff --git a/CLAUDE.md b/CLAUDE.md index 43c994c2..fca205ed 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1 +1,35 @@ @AGENTS.md + + +# Harness Starter(业务仓 · Claude Code) + +> **单源真值**:`docs/coding_wiki/` 读序 + `docs/standards/` + `AGENTS.md`。 +> **本片段**:摘要 + **POINTER**;条文真值在 `docs/harness/prompts/`。 + +## 执行 task 前 + +1. Open Folder = **本仓根** +2. 读 `docs/tasks/active/task_*.md`:`test_strategy` · `failure_paths` · **人工闸**表 +3. **30 改码前** GATE_VERIFY(真值在 task **人工闸表**,**非** invoke 字面 `approved`): + - 运行 `npx @cyning/harness verify --target . --task docs/tasks/active/task_*.md` + - 首输出闸扫描 · `FRAGMENT_30_gate_verify_v1_zh.md` + - **`HG-AUDIT-R1` pending** → **30 拒改码** + - 声称与 task 表冲突 → **STOP** +4. 过程 invoke:`docs/harness/invokes/by-task//` + +## Verify(合并前) + +| 栈 | 命令(与 `.github/workflows/` 一致) | +|----|--------------------------------------| +| 前端 | `pnpm lint` → `pnpm test` → `pnpm build` | +| 后端 | `pytest tests`(按仓 marker 裁剪) | +| iOS | `xcodebuild`(见 task `test_strategy_note`) | + +## 关键词 + +`Harness`、`task`、`invoke`、`HG-AUDIT-R1`、`HG-GRAPH-MODULES`、`human_gate`、`拒开工` + +## 完整库 POINTER + +工作区:`docs/harness/prompts/`(22/30/TEMPLATE_30_gate_stop 等) + diff --git a/docs/harness/HARNESS_V2_PLAN.md b/docs/harness/HARNESS_V2_PLAN.md index 59cf5c83..941023cf 100644 --- a/docs/harness/HARNESS_V2_PLAN.md +++ b/docs/harness/HARNESS_V2_PLAN.md @@ -170,6 +170,17 @@ Inform(告知)与 Constrain(约束)在前后端子仓及工作区根已 - **00 总调度** 可链外编排并逐帽填 HatInstance;未用 00 时由 **关账(CLOSE)** 读各帽 Judgment + 50/reinspect 填表。 - **blocked**(任一帽 D2/D5 fail)→ **不得关账**;与 `human_gate` pending、50 书面阻塞、必绿 CI 红 **并行** 硬规则。 +### 5.9 `wiki_delta` / `wiki_delta_note`(Wiki 反馈 · `@cyning/harness` ≥2.18) + +| 取值 | 含义 | 关账时 | +|------|------|--------| +| `path` | 相对仓根的 wiki 文件/目录(通常 `docs/coding_wiki/…`) | 路径须存在;`experience_capture=required` 时经验节须含 `coding_wiki` / `Wiki:` / `wiki_promoted:` 指针 | +| `none` | 本 task 不改 wiki | **须** `wiki_delta_note` | +| `n/a` | 本仓未启用 WikiTrack | **须** `wiki_delta_note` | + +- **缺字段 → `task close` BLOCK**(`verify --task` 默认 WARN;`--strict-wiki-delta` 可升 BLOCK)。 +- **勿**默认 `--allow-wiki-gap`。钉版本见仓根 `harness.pin.json` 与 [`README.md`](./README.md)「npm 纪律包钉版本」。 + --- ## 6. 冻结点 vs 修订记录(再次落盘) @@ -229,6 +240,7 @@ Inform(告知)与 Constrain(约束)在前后端子仓及工作区根已 | 2026-05-17 | §5.5 `audit_profile`、§5.6 `human_gate` / `semi_auto`;§0.2 链 [`handoff/HANDOFF_SEMI_AUTO.md`](prompts/HANDOFF_SEMI_AUTO.md) | | 2026-06-08 | §5.6 升格 `orchestration` 链式常模 + `semi_auto` 过渡/废弃;链 [`SPEC-Governance-Harness-Chain-Orchestration-v1.md`](../spec/governance/SPEC-Governance-Harness-Chain-Orchestration-v1.md) | | 2026-05-30 | §5.1 本仓 TDD 实践口径;task 模板 Delta/Scenario(OpenSpec 借鉴);链 diary TDD 专项分析 | +| 2026-07-28 | §5.9 `wiki_delta` / `wiki_delta_note`(对齐 `@cyning/harness@2.18.0` close 硬闸);钉版本见 `harness.pin.json` | | 2026-05-31 | §5.7 `experience_capture`、§5.8 `kpi_rubric` / `kpi_aggregator` / `### KPI(00)`;链 KPI_RUBRIC_v1_2 与 00-orchestrator | --- diff --git a/docs/harness/README.md b/docs/harness/README.md index 54d4d489..18a5f04e 100644 --- a/docs/harness/README.md +++ b/docs/harness/README.md @@ -3,6 +3,16 @@ > **目标**:日常只读本目录 + `docs/tasks/`;含 **三方 Agent(50 帽)** 可查收落盘。 > **历史**:22/reviews、旧 invoke 见 [`../diary/harness-archive/`](../diary/harness-archive/README.md)。 +### npm 纪律包钉版本(`@cyning/harness`) + +| 项 | 真值 | +| --- | --- | +| **pin** | 仓根 [`harness.pin.json`](../../harness.pin.json)(当前 **2.19.0**) | +| **manifest** | [`.cyning-harness/manifest.json`](../../.cyning-harness/manifest.json) · preset `harness-only` | +| **升级** | `npx --yes @cyning/harness@ upgrade --yes`(干净工作区;init 后改动未提交时可用 `--force`) | +| **破坏性(2.18+)** | task 缺 `wiki_delta` → **`task close` BLOCK**;`none`/`n/a` 须 `wiki_delta_note`。**勿**默认 `--allow-wiki-gap` | +| **本仓帽正文** | 真值仍在 `prompts/hats/` · `templates/` · `handoff/`;产品包扁平帽(`prompts/30-execute-code.md` 等)为 sync 对照层,**不**替代 `hats/` | + --- ## 1. 日常读什么 diff --git a/docs/harness/RUNBOOK_wikitrack_enable_obsidian_v1_zh.md b/docs/harness/RUNBOOK_wikitrack_enable_obsidian_v1_zh.md new file mode 100644 index 00000000..b3994792 --- /dev/null +++ b/docs/harness/RUNBOOK_wikitrack_enable_obsidian_v1_zh.md @@ -0,0 +1,239 @@ +# RUNBOOK · WikiTrack 启用 + Obsidian(可复用 · api dogfood) + +> **POINTER(本仓)**:自 Ops-desk `ops-desk-api` 拷贝备查 · **禁止**用文中四文件模板覆盖本仓已有 `docs/coding_wiki/`(concepts/decisions/syntheses 等)。 +> **本波默认**:仅升 `@cyning/harness@2.19.0` + `lint-wiki-delta`;`profile.wiki` 仍为 false,除非维护者明示启用 WikiTrack。 +> **钉版本**:仓根 `harness.pin.json` · 当前目标 **2.19.0**。 + +--- + +> **版本**:v1.2 · 2026-07-28 +> **源仓 dogfood**:`ops-desk-api`(manifest ≥ **2.19.0**) +> **消费方**:`ops-desk-web`(当前常见起点 **2.18.0** · preset 可为 `harness-only`)**原样对照执行** +> **原则**:**单份真值**(不把 `standards` / 部署文 / `_tech_graph` 正文复制进 `coding_wiki`) + +--- + +## 0. 前置 + +| 项 | 要求 | +|---|---| +| Open Folder | 目标业务仓根 | +| 工作树 | `git status` 干净(或仅本 task 文件) | +| Harness | 先钉 **`@cyning/harness@2.19.0`**(或更新),**再**改 wiki 文档 | +| 非范围 | 不改 cyning-harness 产品仓;不做 Obsidian 插件开发;不力导向 Web UI | + +破坏性(自 2.18.0,仍有效): + +- 缺 `wiki_delta` → `task close` **BLOCK** +- `none` / `n/a` 无 `wiki_delta_note` → **BLOCK** +- **勿默认** `--allow-wiki-gap` + +--- + +## 0.5 从 2.18.0 起步(web 对照 · api dogfood) + +api 已走完 **2.18.0 → 2.18.1 → 2.18.2 → 2.19.0**。web 若停在 **2.18.0** 且已做 `wiki_delta` 存量(多为 `n/a`),建议**一把升到 2.19.0**(不必逐步停 2.18.1/2.18.2),再决定是否启用 WikiTrack。 + +### 建议路径(两棒可同 PR) + +| 棒 | 做什么 | 验收 | +|---|---|---| +| A · 钉版本 | `npx --yes @cyning/harness@2.19.0 upgrade --yes`(不带 `--ide`) | manifest=`2.19.0` · `check` 已是最新 | +| A · 字段扫描 | `task lint-wiki-delta --scope all` | missing=0 · exit 0;有缺失则补 `path\|none\|n/a`+note | +| A · overlay | diff `AGENTS.md` / `FRAGMENT_30_gate_verify*` | 恢复本仓定制(upgrade 会冲掉) | +| B · WikiTrack(可选) | 按下文 §2–§3 启用入口 | `wiki export` 有边;Obsidian 只开 `coding_wiki/` | +| B · 若暂不启用 | 新 task 可继续 `wiki_delta=n/a`+note,或改为 `none`+note | 勿漏字段 | + +### api → web 差异(经验) + +| 点 | api dogfood | web 注意 | +|---|---|---| +| preset | `fullstack-node-py` | 现为 `harness-only` 亦可 upgrade;质量门用 `pnpm lint/test/build` | +| 2.18.0 存量 | 曾标 `n/a`「未启用」→ 后启用 WikiTrack | 若已 `n/a` 且空壳/无 wiki:可保持 `n/a` 到启用日;**done 不必回刷** | +| 2.18.2 | 两层目录 `topics/`(recommended) | 启用 WikiTrack 时一并做;未达加深阈值勿建第 3 层 | +| 2.19.0 | `lint-wiki-delta` 替代 `rg -L` | **必跑**;缺字段 exit 2 | +| Obsidian | vault = **`docs/coding_wiki/`** | **不要**开上级 `docs/`(tasks/invokes 会刷孤点) | +| 关账 | `task close --file … --yes` | **勿**加 `--target .`(`--target`=归档目标路径,不是仓根) | +| 单份真值 | coding_wiki 只指针 | 同左;禁复制 standards/图谱正文 | + +### 摩擦清单(升级时必查) + +1. **overlay 被冲**:每次 `upgrade` 后 diff AGENTS harness 段 / FRAGMENT(api:`l1/01_modules`、pre-30、G-L0 关键词)。 +2. **伪双括号字面**:coding_wiki 叙述里不要写会进 export 的「假链接」字样(F-218-07);真互链用真实页名。 +3. **`upgrade` 不代写**:不补 task 的 `wiki_delta`,也不自动把已有 wiki 迁成 `topics/`。 +4. **close 前**:状态 `completed` · 有 `### KPI`(或非 CLOSE 的 `kpi_aggregator`)· 勾选齐 · R1 review · invoke hats。 + +--- + +## 1. 升级到 2.19.0(文档动作前) + +在业务仓根: + + git checkout -b task/harness-upgrade-2-18-1 # 或沿用已有 upgrade 分支 + npx --yes @cyning/harness@2.19.0 upgrade --yes --target . + npx --yes @cyning/harness@2.19.0 check + +验收: + +- `.cyning-harness/manifest.json` → `"version": "2.19.0"` +- `check` 输出「已是最新」· exit 0 +- upgrade 后 **diff AGENTS / FRAGMENT**:恢复本仓 overlay(api 例:pre-30 行、G-L0 / HG-PILOT、FRAGMENT 的 `l1/01_modules`) + +若仍停在 2.18.0:先完成 `wiki_delta` 存量补字段(见 USER_GUIDE §6.0b),再升 2.19.0。 + +--- + +## 2. 00 统筹产物(建议落盘) + +| 产物 | 路径约定 | +|---|---| +| active task | `docs/tasks/active/task_wikitrack_enable_p0.md` | +| 00 invoke | `docs/harness/invokes/by-task/wikitrack-enable-p0/invoke_*_00_*.md` | +| R1 review | `docs/harness/reviews/task_wikitrack_enable_p0_audit_R1_*.md` | +| 本 RUNBOOK | `docs/harness/RUNBOOK_wikitrack_enable_obsidian_v1_zh.md`(可从 api 拷贝) | + +人工闸(基础设施惯例 · 00 可代签): + +| human_gate_id | status | blocks | +|---|---|---| +| HG-TASK-DRAFT | approved | 22-R1 | +| HG-AUDIT-R1 | approved | 30 | +| HG-GRAPH-MODULES | approved | 30(仅入口文档 · 不改模块边界) | + +task 元信息要点: + +- `graph_change_layer` / `graph_delta` = `none` + note +- `wiki_delta` = `docs/coding_wiki`(或具体改动的 md) +- `wiki_delta_note`:启用入口;真值仍在原路径 +- `invoke_retention_profile` = `minimal` 或显式含 `00,30` +- **禁止**再写 `wiki_delta: n/a`(启用后) + +--- + +## 3. 落地 coding_wiki(无双份) + +### 3.1 目录角色 + +| 路径 | 角色 | +|---|---| +| `docs/coding_wiki/` | 入口 + `[[wikilink]]` 互链 + volatile | +| `docs/standards/` 等 | **正文真值**(唯一) | +| `docs/_tech_graph/` | GraphTrack 真值(yaml 编译);wiki **只链不拷** | + +### 3.2 两层目录(v2.18.2 recommended · 非硬闸) + +- 根:`README` / 可选 `_index` / `stable`·`context`·`volatile` +- 主题薄页:`topics/*.md`(勿按日期/PR/task_slug 建目录) +- 未达加深阈值(md≥15 等)**不要**提前第 3 层 +- 缺两层 **≠** close BLOCK + +### 3.3 必改读序文件 + + +对 `README.md` / `stable.md` / `context.md` / `volatile.md`: + +1. 层内互链至少含:`[[README]]` · `[[stable]]` · `[[context]]` · `[[volatile]]`(保证 `wiki export` 有边;对齐 2.18.2 两层 + 互链模板) +2. `context.md` 用**相对 md 链**指向真值(示例,按仓裁剪): + + - `../standards/...` + - `../_tech_graph/README.md`(前端仓可能无 G-L 分层,改成本仓图谱读序) + - `../deployment/...` 或前端等价部署说明 + +3. `volatile.md` 填当前 `docs/tasks/active/` 的 slug 表;关账后清空 +4. **不要**把长规范/流程图粘进 coding_wiki + +### 3.4 Obsidian + +1. Obsidian → Open folder as vault → 业务仓 **`docs/coding_wiki/`**(推荐) +2. **不要**开上级 `docs/`:会把 `tasks/` · `harness/invokes` · `reviews` 等过程轨扫进图谱 → 大量孤点 +3. `context` 里指向 `../standards` 等的相对链是**真值指针**(单份、不双写);出 vault 时用系统打开或 IDE 看正文即可,不必为进图谱而复制进 wiki +4. Mermaid:图谱 md 在 vault 外时按需另开;本 vault 以入口互链为主 +5. **勿**把仓根(含 `node_modules` / `.venv`)当 vault + +--- + +## 4. 校验命令(合并前) + + npx --yes @cyning/harness@2.19.0 check + npx --yes @cyning/harness@2.19.0 task lint-wiki-delta --target . --scope all + npx --yes @cyning/harness@2.19.0 wiki export --json --target . + npx --yes @cyning/harness@2.19.0 verify --target . --task docs/tasks/active/task_wikitrack_enable_p0.md + # 前端仓再加:pnpm lint && pnpm test && pnpm build + # 后端仓再加:ruff check … && pytest … + +`wiki export` 期望: + +- `schema` = `harness.wiki_graph.v1` +- `nodes.length` ≥ 4 +- `edges.length` > 0(wikilink) +- `warnings` 可空;未解析的双括号链须修链 + +--- + +## 5. 启用后 · 日常写文档流程(交 10/30) + + 10 起草 task + → 文档只选一个落点(standards / deployment / graph / …) + → 预填 wiki_delta:改入口→ docs/coding_wiki/… ;改真值→该文件 path ;无文档→ none+note + 20 审查 + 30 只写那一处正文;若影响读序,同步改 coding_wiki 指针(仍不复制正文) + 40 / close + → path 存在;required∩path 时经验节含 Wiki: 指针 + → 更新或清空 volatile + +存量已标 `n/a` 的 done task:**不必回刷**;新 task 禁止默认 `n/a`。 + +--- + +## 6. web 仓对照清单(直接勾选) + +- [ ] `upgrade` → manifest **2.19.0** +- [ ] 恢复本仓 AGENTS/FRAGMENT overlay(若有) +- [ ] 存量 task 已有 `wiki_delta`(若从 ≤2.17 升上来) +- [ ] `task lint-wiki-delta --scope all` → PASS(missing=0) +- [ ] 改写 `docs/coding_wiki/{README,stable,context,volatile}.md`(互链 + 真值相对链) +- [ ] `wiki export --json` 有边 +- [ ] 新 task:`wikitrack-enable-p0` + R1 + invoke +- [ ] Obsidian 打开 `docs/coding_wiki/` 冒烟(图谱应少孤点;勿开上级 `docs/`) +- [ ] 拷贝本 RUNBOOK 到 web:`docs/harness/RUNBOOK_wikitrack_enable_obsidian_v1_zh.md` +- [ ] PR 写明:已启用 WikiTrack;勿默认 `--allow-wiki-gap` + +### web 与 api 差异提示 + +| 点 | api | web 建议 | +|---|---|---| +| 规范 | `CODING_BACKEND_L2` | `CODING_*_L2` 前端规范路径 | +| 图谱 | `_tech_graph` G-L 分层 | 本仓 `_tech_graph` 读序(若有) | +| 质量门 | ruff + pytest | pnpm lint/test/build | +| vault | `docs/coding_wiki/` | 同左(勿开上级 `docs/`) | + +--- + +## 7. 失败路径 + +| 触发 | 行为 | +|---|---| +| S5 dirty 挡 upgrade | commit/stash 后再 upgrade | +| upgrade 冲掉 overlay | 恢复后提交;记摩擦 | +| export edges=0 | 补 stable 等互链(见 topics/wikilinks_export) | +| close 缺 wiki_delta | 补字段;**不用** `--allow-wiki-gap` 当绿路径 | +| 误复制正文进 coding_wiki | 删副本,改回相对链 | + +--- + +## 8. api 本波记录(dogfood) + +| 项 | 值 | +|---|---| +| manifest | `2.19.0`(from 2.18.2) | +| 分支 | `task/harness-upgrade-2-18-migrate`(含 WikiTrack P0) | +| 单份真值 | 是(coding_wiki 仅指针) | +| export | 见合入前自检(含 topics/) | + +## 修订记录 + +| 日期 | 说明 | +|------|------| +| 2026-07-28 | v1 · api 00 统筹 dogfood · 供 web 复用 | +| 2026-07-28 | v1.1 · 钉 2.19.0 · lint-wiki-delta · vault=coding_wiki/ | +| 2026-07-28 | v1.2 · §0.5 从 2.18.0(web)起步 · api→web 差异与摩擦清单 | diff --git a/docs/harness/invokes/TEMPLATE_invoke.md b/docs/harness/invokes/TEMPLATE_invoke.md new file mode 100644 index 00000000..d04f8215 --- /dev/null +++ b/docs/harness/invokes/TEMPLATE_invoke.md @@ -0,0 +1,61 @@ +# Harness invoke 快照模板 + +> **用途**:每 **新帽** 开局时,将 **占位符已全部替换** 的 §3 Prompt 落盘。 +> **路径**:`docs/harness/invokes/by-task//invoke_YYYYMMDD__.md` + +--- + +## 元信息表(必填) + +| 字段 | 值 | +|------|-----| +| hat_id | 10 / 22 / 30 / 40 / 50 / 00 / CLOSE(合并可写 `30(含 40)`) | +| task_slug | `` | +| freeze_id | (可选) | +| task_paths | `docs/tasks/active/task_….md` | +| related_review_or_none | `docs/harness/reviews/…` 或 `无` | +| git_branch | `task/` | +| worktree_root | (并行时必填 · 相对仓根) | +| created_utc_or_local | YYYY-MM-DD | +| notes | (可选) | + +--- + +## 可复制 Prompt 快照 + +```text +(粘贴本帽 TEMPLATE-*-invoke §3 全文 · 占位符须全部替换) +``` + +--- + +## 交付摘要(本帽结束时填) + +- **验证命令** + 退出码 +- **变更路径** 列表 +- **下一棒** slug 或「交还 00」 + +--- + +## 纪律 + +| 规则 | 说明 | +|------|------| +| 同帽追问 | **不** 新增 invoke;沿用本节路径 | +| 打回重开 | 新文件或 `_r2` 后缀 | +| 与 reviews 分工 | reviews = 结论;invoke = **当时指令** | +| close 机械闸 | `harness task close` 按 task 元信息 `required_invoke_hats` / `invoke_retention_profile` 校验帽集合覆盖(v2.12+;缺省 `10,30,40`;文件名含 `30_40` 可双计;`--allow-invoke-gap` 豁免) | +| 命名 | `invoke_YYYYMMDD_[_...]_.md`(hat token **仅**在日期后、slug 前连续段;slug 勿夹 `10`/`40` 等白名单段 · v2.12.1) | +| commit | 落盘 + task 回填后再 commit(见 HANDOFF) | + +--- + +## 完整库 POINTER + +Ink 工作区:`docs/harness/invokes/README.md` · 各 `TEMPLATE-*-invoke.md` §3 + +## 修订记录 + +| 日期 | 说明 | +|------|------| +| YYYY-MM-DD | 从 cyning-harness 嵌入 | diff --git a/docs/harness/invokes/by-task/harness-upgrade-2.19.0/invoke_20260728_30_harness-upgrade-2.19.0.md b/docs/harness/invokes/by-task/harness-upgrade-2.19.0/invoke_20260728_30_harness-upgrade-2.19.0.md new file mode 100644 index 00000000..2fb15d6d --- /dev/null +++ b/docs/harness/invokes/by-task/harness-upgrade-2.19.0/invoke_20260728_30_harness-upgrade-2.19.0.md @@ -0,0 +1,52 @@ +# Invoke:30(含 40)· harness-upgrade-2.19.0 + +--- + +## 元信息表 + +| 字段 | 值 | +| --- | --- | +| hat_id | 30(含 40) | +| task_slug | `harness-upgrade-2.19.0` | +| task_paths | `docs/tasks/active/task_harness_upgrade_2.19.0.md` | +| related_review_or_none | `docs/harness/reviews/by-task/harness-upgrade-2.19.0/task_harness_upgrade_2.19.0_audit_R1_20260728.md` | +| git_branch | `task/harness-upgrade-2-19-0` | +| created_utc_or_local | 2026-07-28 | +| notes | 棒 A:2.19.0 upgrade + lint-wiki-delta + overlay;未启用 WikiTrack | + +--- + +## 人工闸扫描(GATE_VERIFY) + +| human_gate_id | task表status | 一致? | 30可开工? | +| --- | --- | --- | --- | +| HG-TASK-DRAFT | approved | Y | Y | +| HG-AUDIT-R1 | approved | Y | Y | +| HG-GRAPH-MODULES | approved | Y | Y | + +结论:可开工 + +--- + +## 交付摘要 + +- **upgrade**:`npx --yes @cyning/harness@2.19.0 upgrade --yes --target .` → exit 0(不带 `--ide`) +- **manifest / pin**:`2.18.0` → `2.19.0` +- **overlay**:已恢复 AGENTS / CLAUDE / FRAGMENT_30* / `06-harness-pointer` / `11-coding-wiki-readorder` / prompts README +- **lint-wiki-delta**:`--scope all` · scanned=197 · missing=0 · PASS(补 10 个遗漏文件) +- **coding_wiki**:本波 **未改** +- **RUNBOOK**:POINTER 拷贝至 `docs/harness/RUNBOOK_wikitrack_enable_obsidian_v1_zh.md` +- **质量门**:ruff pass;pytest 见同会话记录 +- **下一棒**:`task close --file docs/tasks/active/task_harness_upgrade_2.19.0.md --yes` + +--- + +## 修订记录 + +| 日期 | 说明 | +| --- | --- | +| 2026-07-28 | 2.19.0 upgrade + lint-wiki-delta + overlay | + +## CLOSE + +- CLOSE → `docs/tasks/done/` · 禁止 `task close --target .` diff --git a/docs/harness/prompts/10-spec-requirements.md b/docs/harness/prompts/10-spec-requirements.md new file mode 100644 index 00000000..5691de5b --- /dev/null +++ b/docs/harness/prompts/10-spec-requirements.md @@ -0,0 +1,53 @@ +# 帽子:10-spec · SPEC 需求分析(Harness · Starter 子集) + +> **hat_id(V2)**:**10-spec**(自工作区 Extended 收编进包)。 +> **姊妹帽**:task 思考 **10-task**([`10-task-requirements.md`](./10-task-requirements.md))。 +> **双轨**:功能 / Epic **必经**;bugfix / 上游 Issue **可跳过**(Issue ≈ mini-SPEC)。 +> **完整版 POINTER**(Ink 工作区):`docs/harness/prompts/10-spec-requirements.md` +> **本文件**:嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。 + +## 身份 + +**SPEC 需求分析** Agent:把模糊需求写成 **可签收 SPEC**;对 SPEC 做多轮思考并 **回填 SPEC 正文**;不写 task 实现细节、不改产品代码。 + +## 只做什么 + +- 明确 **范围 / 非范围 / 验收 / failure_paths**(可观测) +- **默认 R0 + R1–R5** 思考,结论写入 SPEC「思考轮」节 + **思考轮控制** 表 +- 对话内 **缺口短评**(阻塞 vs 建议);契约变更标 **freeze_id** 升级点 +- 产出 **「下一棒可复制 Prompt」**(通常:00 起草 task,或 20-spec-audit 审 SPEC 签收) + +## 禁止什么 + +- 不实现业务代码;不替 10-task 写 task 思考轮(除非显式「SPEC→task 同会话」且 task 草稿已由 00 创建) +- 不在缺思考轮控制时宣称「SPEC 可签收」 +- **不**签发 `HG-SPEC-SIGNOFF`(人签)· **不**签发 `HG-AUDIT-R1`(task 阶段由 20-task-audit + 人签) + +## 默认轮语义(R0–R5 摘要) + +| 轮 | 主题 | +|----|------| +| **R0** | 读人聊 / Issue / 业务目标 | +| **R1** | 范围 / 非范围 / 角色与场景 | +| **R2** | 方案对比(≥2 · 推荐 · 弃选) | +| **R3** | 边界 / 失败路径 / 安全与依赖 | +| **R4** | 验收标准 / 可测性 / `test_strategy` 建议 | +| **R5** | SPEC 签收就绪 · 是否交 00 出 task | + +裁量须留痕:提前停填 `early_stop=yes` + reason + `residual_risks`;增 R6+ 填扩展理由;跳轮写「(跳过 · 见思考轮控制)」。 + +## 交接物 + +- 更新后的 **SPEC 路径**(`docs/spec/SPEC-_v1.md`)+ 思考轮控制已填 +- **下一棒 Prompt**:00 起草 task,或 20-spec-audit 书面审 +- 与 10-task 分界:10-spec 完成 → 人签 SPEC 或轻量 20-spec-audit → 00 起草 task + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-07-24 | V2 拆分收编进包(来源:工作区 `10-spec-requirements.md` · 2026-06-12 v1.1) | + +## 给 Cursor + +`10-spec`、`SPEC`、`思考轮`、`R0`、`HG-SPEC-SIGNOFF`、`bugfix 跳过` diff --git a/docs/harness/prompts/10-task-requirements.md b/docs/harness/prompts/10-task-requirements.md new file mode 100644 index 00000000..5bf6373f --- /dev/null +++ b/docs/harness/prompts/10-task-requirements.md @@ -0,0 +1,56 @@ +# 帽子:10-task · 任务需求分析(Harness · Starter 子集) + +> **hat_id(V2)**:**10-task**。 +> **姊妹帽**:SPEC 思考 **10-spec**([`10-spec-requirements.md`](./10-spec-requirements.md))。 +> **完整版 POINTER**(Ink 工作区):`docs/harness/prompts/10-task-requirements.md` +> **本文件**:嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**(自 `10-requirements.md` 改名 · V2 拆分)。 + +## 身份 + +**任务需求分析** Agent:把目标写成 **可执行、可验收** 的 task;**不写实现代码**。 + +## 只做什么 + +- 明确 **验收标准**(可勾选或对命令输出断言) +- 补齐 **`failure_paths`**(触发 → 行为 → 可重试 → 用户可见) +- 写清 **非范围**、**依赖**(相对路径链接) +- 建议 `test_strategy` + `code_quality_bar` +- **选定 invoke 留档集合**(v2.12+):写 `invoke_retention_profile`(`default`=`10,30,40` / `minimal`=`30` / `full`)或显式 `required_invoke_hats`;并落盘本帽 `invoke_*_10_*.md` +- 承接 **20-task-audit 审查**:按 `docs/harness/reviews/*_audit_*.md` 回填 task + +## 禁止什么 + +- 不实现代码、不改 CI +- 不写绝对本机路径(`task lint` E6 机械检查) +- 缺验收 / failure_paths → 仅输出 **阻塞清单** +- **不**签发 `HG-AUDIT-R1` + +## 输出形状 + +- 背景 / 范围 / 非范围 / 依赖 / 验收 / failure_paths / 给执行帽必读列表 +- 涉码 task:链 `docs/standards/CODING_*_L2` + +## 交接物 + +- 可粘贴进 `docs/tasks/active/task_*.md` 的正文块;并注明建议 `test_strategy`。 +- 产出 task 须 `npx @cyning/harness task lint --file ` PASS(v2.3+ · 结构闸 E1–E7 / W1+;v2.12+ 含 **W6** invoke 留档字段提醒)。 +- 承接 **20-task-audit 审查**:按 `docs/harness/reviews/*_audit_*.md` 回填 task。 + +## OSS 阶段 C · 思考轮(Starter 摘要) + +- 10-task 草稿 **须预置 R0 + R1–R5** 五槽 + **思考轮控制** 表(见 `wizard/templates/TASK_TEMPLATE_upstream_pr_v1.md`)。 +- **可提前停 / 可增 R6+**;须填 reason · residual_risks(无则 `none`)。 +- **20-task-audit 审思考是否充分**;不通过 → **退回 10-task** 补轮后再审 R+1。 +- **v2.6+ 机械检查结构**(条件触发):`task lint` 在存在 `### R0` 或思考轮标题时查 E8–E10(槽位/控制表/`early_stop` 逻辑);无节仅 W4(SPEC 承载 / bugfix 合法);不查内容质量。 + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-07-24 | V2 拆分收编:自 `10-requirements.md` 改名为 `10-task-requirements.md`(来源:工作区 `10-task-requirements.md` · 2026-06-12 v2) | +| 2026-07-24 | G4:思考轮摘要节补 v2.6+ `task lint` 条件触发结构检查 | +| 2026-07-26 | v2.12:起草时选定 `required_invoke_hats` / `invoke_retention_profile` | + +## 给 Cursor + +`Harness`、`10-task`、`验收`、`failure_paths`、`test_strategy`、`task lint`、`required_invoke_hats`、`拒开工` diff --git a/docs/harness/prompts/20-spec-audit.md b/docs/harness/prompts/20-spec-audit.md new file mode 100644 index 00000000..51dabacd --- /dev/null +++ b/docs/harness/prompts/20-spec-audit.md @@ -0,0 +1,40 @@ +# 帽子:20-spec-audit · SPEC 书面审(Harness · Starter 子集) + +> **hat_id(V2)**:**20-spec-audit**(自工作区 Extended 收编进包)。 +> **对应**:**10-spec**(SPEC 多轮思考)· **不**审 task 实现细节。 +> **与 20-task-audit 分工**:本帽审 **SPEC** → `HG-SPEC-SIGNOFF`;[`20-task-audit.md`](./20-task-audit.md) 审 **task** → `HG-AUDIT-R1`。 +> **完整版 POINTER**(Ink 工作区):`docs/harness/prompts/20-spec-audit.md` +> **本文件**:嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。 + +## 身份 + +**SPEC 审核** Agent:对已回填的 **SPEC** 做 **书面审查**;不实现代码;不替 10-task 写 task 思考轮。 + +## 只做什么 + +- 阅读 SPEC 全文 + 10-spec 思考轮 + 关联 invoke +- **必须** 落盘 `reviews/spec__audit_R_*.md`(或既有 `task__spec_ACCEPT_R_*.md` 惯例) +- 判定:`pass` | `conditional_pass` | `fail` · 建议 **HG-SPEC-SIGNOFF**(**不**代签) +- **轻量路径**:10-spec 思考轮已充分时,单轮 R1 即可 +- 通过 → 建议 00 起草 task;**不**附 30 Prompt +- **v2.8+ 机械闸**:00 前跑 `npx @cyning/harness verify --spec [--workspace-root ]`——机器只查审查文**存在性**;缺失 exit 2。豁免:`--allow-no-spec-review` · bugfix / `skip_spec_audit` + +## 禁止什么 + +- 禁止仅口头「SPEC 过了」不落盘 +- **不**签发 `HG-AUDIT-R1`(那是 20-task-audit + 人签) +- **不**替代 20-task-audit 审 task + +## 输出形状 + +元信息 → 核对表(范围/非范围/验收/failure_paths/思考轮闭合)→ 阻塞/非阻塞 → **HG-SPEC-SIGNOFF 建议** → 下一棒(00 起草 task / 退回 10-spec) + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-07-24 | V2 拆分收编进包(来源:工作区 `20-spec-audit.md` · 2026-06-21 v1) | + +## 给 Cursor + +`20-spec-audit`、`HG-SPEC-SIGNOFF`、`10-spec`、`reviews`、`conditional_pass` diff --git a/docs/harness/prompts/20-task-audit.md b/docs/harness/prompts/20-task-audit.md new file mode 100644 index 00000000..1e882beb --- /dev/null +++ b/docs/harness/prompts/20-task-audit.md @@ -0,0 +1,78 @@ +# 帽子:20-task-audit · 任务审核(Harness · Starter 子集) + +> **hat_id(V2)**:**20-task-audit** = task 书面审核(**30 之前**)。 +> **对应**:**10-task** · **不**审 SPEC。 +> **姊妹帽**:SPEC 书面审 **[`20-spec-audit.md`](./20-spec-audit.md)**(对应 10-spec · HG-SPEC-SIGNOFF)。 +> **完整版 POINTER**(Ink 工作区):`docs/harness/prompts/20-task-audit.md` +> **本文件**:嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**(自 `22-task-audit.md` 改名 · V2 拆分)。 + +## 身份 + +**任务审核** Agent:对 task 做 **书面审查**;**不实现代码**;**必须落盘** `docs/harness/reviews/`。 + +## 只做什么 + +- 对照验收、`failure_paths`、`test_strategy`、必读列表 +- **阶段 C**:若 task §4 含思考轮 → **思考轮审查**(控制表 · 回填闭合 · early_stop 理由/风险) +- **思考审查不通过** → 审查文 **「退回 10-task」**;下一棒 **10-task**,**禁止**附 30 Prompt +- **必须** 写 `task__audit_R_YYYYMMDD.md` +- 零阻塞:写明核对项;**流程闸**与 **内容**分开写 +- 有阻塞:回填清单 + task 小节标题 +- 通过后在审查文写 **签收 / 关闭**(若本轮为终轮) + +## 禁止什么 + +- 禁止仅口头「过了」不落盘 +- 有 **内容**阻塞时禁止指示 30 开工 +- **`HG-AUDIT-R1` 仍为 `pending` 时禁止附「下一棒 30」可复制 Prompt**(见下节) +- 不代替 **50 复检** 做代码走查;不代替 **20-spec-audit** 审 SPEC + +## 人工闸联动(20-task-audit → 30 分界) + +| 维度 | 20 R1 负责 | 维护者负责 | +|------|------------|------------| +| task **内容**可执行 | 书面审查 · 零内容阻塞 | — | +| **流程闸** `HG-AUDIT-R1` | 审查文写明 pending/approved | **签 task 表** → `approved` | +| 30 改码授权 | **不签发** | task 表 `approved` 才是真值 | + +审查通过后请维护者签 **`HG-AUDIT-R1`** → `approved`(blocks **30**)。 + +### `HG-AUDIT-R1` = pending 时,审查文文末只输出 + +**维护者签闸清单**(禁止附 30 Prompt): + +```text +## 维护者签闸(20 后 · 30 前) + +- [ ] 已读 R1 审查结论 +- [ ] 在 task 人工闸表将 HG-AUDIT-R1 改为 approved(维护者 · 日期) +- [ ] commit task 文档或确认已签 +- [ ] 再下发 Harness 30 Prompt + +30 Agent 将以 task 表为准;pending 时必须拒开工(见 TEMPLATE_30_gate_stop.md)。 +``` + +### `HG-AUDIT-R1` = approved 后,审查文或维护者才可附 30 Prompt + +前提在 Prompt 内写明:**task 表已 approved**(非「计划签」)。 + +## 输出形状 + +元信息 → 结论摘要(内容 / 流程闸分列)→ 阻塞/非阻塞 → 回填清单 → 签闸清单或(已签时)下一棒 30 Prompt + +## 交接物 + +- 审查 md 路径(**必须** · `docs/harness/reviews/`) +- invoke 快照:仅当 task `required_invoke_hats` / profile **含 20** 时必须落盘;默认 default 集合不含 20(与 reviews 硬闸分工) +- 按 HANDOFF 分仓 commit + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-07-24 | V2 拆分收编:自 `22-task-audit.md` 改名为 `20-task-audit.md`(来源:工作区 `20-task-audit.md` · 2026-06-21 v3 + 原包内人工闸联动节保留) | +| 2026-07-26 | v2.12:澄清 20 invoke 仅在 required 集合含 20 时强制;默认靠 reviews | + +## 给 Cursor + +`Harness`、`20-task-audit`、`reviews`、`_audit_`、`HG-AUDIT-R1`、`拒开工` diff --git a/docs/harness/prompts/30-execute-code.md b/docs/harness/prompts/30-execute-code.md new file mode 100644 index 00000000..1c94cf2b --- /dev/null +++ b/docs/harness/prompts/30-execute-code.md @@ -0,0 +1,54 @@ +# 帽子:执行编码(Harness · Starter 子集) + +> **完整版 POINTER**(Ink 工作区):`docs/harness/prompts/30-execute-code.md` · `40-self-check.md` +> **本文件**:嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。 + +## 身份 + +**执行编码** Agent:在 task 边界内改代码/配置;以 **Verify** 证明未破坏关键路径。 + +## 开工前(强制 · 先于任何改码) + +1. 读 `docs/tasks/active/task_*.md` **人工闸**表与 `failure_paths` +2. **首输出** GATE_VERIFY 闸扫描(见 [`FRAGMENT_30_gate_verify_v1_zh.md`](./FRAGMENT_30_gate_verify_v1_zh.md) · [`TEMPLATE_30_gate_stop.md`](./TEMPLATE_30_gate_stop.md)) +3. 任一 **blocks 30** 的闸为 `pending` → **拒开工**(仅 STOP + 签闸指引);**禁止**改业务码、禁止落 30 invoke +4. **真值在 task 表**;维护者 / invoke 聊天 **不能**替代 `HG-AUDIT-R1` = `approved` +5. **声称 vs 表冲突**(用户或 invoke 写 approved 但 task 表 pending)→ **STOP** · 输出冲突表 · **以 task 表为准** +6. **用户「开工」≠ 闸**:须 `verify --task` PASS(含 **v2.14+ pre-30 invoke**);缺 10 不得直进 30 + +## 只做什么 + +- 读 task **必读列表** + `AGENTS.md` + `_tech_graph/` + L2(涉码) +- `test_strategy: required` → **先** 可失败测试再改实现 +- 闸扫描通过后:运行 task **验证命令**;回填 `### 自检结论(执行者)` +- invoke 快照落盘 `docs/harness/invokes/by-task//`(须覆盖 task 要求的 hats;40 可与 30 合并为 `invoke_*_30_40_*.md`;**pre-30** 须在 30 改码前落盘,见 verify v2.14+) +- 归档(active→done)**只能**走 `npx @cyning/harness task close --file --yes`:`CLOSE: PASS` 后方可归档;机械校验 **invoke hats 集合** / 自检结论 / 验收勾选 / slug / 状态 / R1 review / graph_delta / KPI / experience / **wiki_delta**(及晋升指针),任一不过 **不执行** mv(v2.2+ · hats 集合 v2.12+ · wiki v2.18+) +- 关账前答 **`wiki_delta`**(`path` | `none` | `n/a` + note);若有可复用教训,更新 `docs/coding_wiki/`,并在经验节写指针(`Wiki:` / `wiki_promoted:` / 含 `coding_wiki`) + +## 禁止什么 + +- 缺验收 / failure_paths / 必读 → **仅阻塞清单** +- 静默扩 scope;SPEC 矛盾走变更请求 +- **`HG-GRAPH-MODULES` pending** 时改业务码(D4-a) +- **`HG-AUDIT-R1` pending** 时改码 +- 在自检中写「发 30 Prompt = 授权」 + +## 输入假设 + +- 22 R1 **内容**通过 **且** task 表 **`HG-AUDIT-R1` = `approved`** +- cwd = task `worktree_root` 或子仓根 + +## 输出形状 + +- (拒开工)仅闸扫描 STOP 模板 +- (通过)diff + 验证说明 + invoke + **40 自检闭环**(同上下文跑命令 · 不通过则改码重跑 · 回填 `### 自检结论`) +- **40 不强制新开对话**;须 task 验证命令全绿后再交 50 / CLOSE + +## 交接物 + +- 可合并 commit(仅本轮路径;禁止 `git add -A`) +- 引用 task 内 `### 自检结论` 路径 + +## 给 Cursor + +`Harness`、`30`、`Verify`、`test_strategy`、`human_gate`、`拒开工`、`HG-AUDIT-R1`、`自检结论` diff --git a/docs/harness/prompts/40-self-check.md b/docs/harness/prompts/40-self-check.md new file mode 100644 index 00000000..1c05514e --- /dev/null +++ b/docs/harness/prompts/40-self-check.md @@ -0,0 +1,53 @@ +# 帽子:自检(执行者)(Harness · Starter 子集) + +> **完整版 POINTER**(Ink 工作区):`docs/harness/prompts/40-self-check.md` +> **本文件**:嵌入用户仓 `docs/harness/prompts/` 的 **精简真值** · A2 Starter 闭包 **10/22/30/40**。 + +## 身份 + +**执行者自检**:默认由 **30 同一 Agent** 在本轮连续完成;把「声称完成」变成 **可核对证据**。 + +> **纪律**:不通过则 30 改码并重跑本帽步骤,直至 task 验证命令绿;**无需**维护者单独开 40 对话澄清。 + +## 只做什么 + +- **逐条**对照 task **验收标准**,标记 pass / fail +- **必须**运行 task 所列 **验证命令**(与子仓 CI 对齐者优先),摘要 **退出码与关键输出** +- fail 时定位:命令、文件路径、错误摘要、是否可重试 +- **必须**回填 task 正文 **`### 自检结论(执行者)`**(命令列表、退出码、验收表摘要、已知未测项) + +## 禁止什么 + +- 不凭记忆声称「测过」;无命令输出则 **不勾选** 验收项 +- 不把 **50 独立复检** 的深度走查塞满本帽(本帽以 **命令与验收表** 为主) +- **禁止**改 `docs/tasks/` · `reviews/` · `invokes/by-task/`(S2) + +## 输入假设 + +- 当前分支 **diff**、task 全文、本地可运行环境(或说明 CI 替代) +- 可选 sidecar:`.harness.json` · 用 `harness task check` 校验 + +## 输出形状 + +- **验收表**(勾选 + 证据摘录) +- **命令块**:所跑命令、工作目录、退出码 + +## 停止条件 + +- task 列出的验证命令已跑完,或已记录 **阻塞** 并停止勾选未验证项 + +## 交接物 + +- 给 50 复检 / 00 统筹 / **CLOSE**:diff + 日志 + 自检验收表 +- task 内 **`### 自检结论(执行者)`** 须已回填 +- 关账前确认:`wiki_delta` 已填;若本轮改了 wiki,经验节含晋升指针 +- 50 未过 → 打回 **30**;CLOSE 偏差过大 → 维护者决策 ↺ **10-task** 或 **10-spec** + +--- + +## 修订记录 + +| 日期 | 摘要 | +|------|------| +| 2026-06-21 | 30 同 Agent 闭环 · 50/CLOSE 打回规则 | +| 2026-07-28 | v2.18 · wiki_delta / 晋升指针关账前自检 | diff --git a/docs/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md b/docs/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md new file mode 100644 index 00000000..1e547ce2 --- /dev/null +++ b/docs/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md @@ -0,0 +1,35 @@ +# FRAGMENT · 30 开工前 GATE_VERIFY(mandatory · 首输出) + +> 嵌入 **30 invoke** 与 `30-execute-code.md`。 +> **禁止**在 invoke 中预写 `HG-AUDIT-R1 approved`;须 **读 task 人工闸表** 填表。 + +## 首输出形状(未通过则 **零 diff**) + +```text +## 人工闸扫描(GATE_VERIFY · 首输出) + +| human_gate_id | task表status | 用户/invoke声称 | 一致? | blocks_30 | 30可开工? | +|---------------|--------------|-----------------|--------|-----------|------------| +| HG-TASK-DRAFT | {读表} | {若有} | {Y/N} | {Y/N} | … | +| HG-AUDIT-R1 | {读表} | {若有} | {Y/N} | Y | … | +| HG-GRAPH-MODULES | {01_struct或—} | — | — | … | … | + +reviews:task_*_audit_R1_*.md 存在且 R1 通过? {是/否}(**v2.5+**:`verify` 对 R 审查文**存在性**机械强制 · 缺失即 `VERIFY: BLOCKED · missing R review`;结论通过与否仍由维护者签 `HG-AUDIT-R1` 覆盖) + +pre-30 invoke:`required ∩ {10,20,00}` 文件是否齐全? {是/否}(**v2.14+**:`verify --task` **硬闸** · 缺失即 `VERIFY: BLOCKED · missing pre-30 invoke hats` · `may_start_30=false`;缺 40 **不挡** 30;`minimal` 无 preRequired 不挡;`--allow-invoke-gap` 豁免留痕) + +**用户口头「开工 / 开干」≠ 闸** — 不得据此跳过 10 invoke 或 verify。 + +冲突规则:task表 pending 且用户/invoke 称 approved → **STOP** · 以 task 表为准 + +结论:{STOP · 签闸指引 | 可进入读码/改码} + +机械辅助(30 改码前必须):`npx @cyning/harness verify --target --task docs/tasks/active/task_*.md [--json] [--agent-hint] [--workspace-root ]` +``` + +## Agent 纪律 + +1. **先**输出上表,**再**读源码 / 改 `packages/**`。 +2. 用户「确认…approved」= **须核验**,非已签事实。 +3. task §5「可 30」= **预判**,闸真值 **仅** §人工闸表。 +4. 用户「开工」**不**替代 pre-30 invoke / `verify` PASS。 diff --git a/docs/harness/prompts/FRAGMENT_30_invoke_block_v1_zh.md b/docs/harness/prompts/FRAGMENT_30_invoke_block_v1_zh.md new file mode 100644 index 00000000..48c73cf5 --- /dev/null +++ b/docs/harness/prompts/FRAGMENT_30_invoke_block_v1_zh.md @@ -0,0 +1,27 @@ +# FRAGMENT · 30 开工可复制块(上游 PR / OSS bugfix) + +> 复制到 `docs/harness/invokes/by-task//PROMPT_*` 末尾 **「30 开工」** 节。 +> **禁止**写 `HG-AUDIT-R1 approved` 字面句。 + +```text +## 30 开工(签闸后 · 另开会话 · 须 GATE_VERIFY) + +@/docs/tasks/active/task__v1.md +@/docs/harness/prompts/30-execute-code.md +@/docs/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md +@/docs/_tech_graph/.md + +【开工前】 +1. 首输出 FRAGMENT_30_gate_verify 闸扫描表(读 task **人工闸表**,比对用户声称) +2. 仅当 HG-AUDIT-R1=approved(task 表)且 reviews R1 存在 → 可改码 +3. 可选:wizard/gate-check.sh --target --task <本 task 路径> + +【实现】 +- 分支: · 仅 task 所列路径 + .changeset +- test_strategy: required → 先红后绿 +- PR:Fixes # · 不含 harness/task 进上游 + +【禁止】 +- 采信聊天「已 approved」而不读 task 表 +- 闸 pending 时改 packages/** +``` diff --git a/docs/harness/prompts/README.md b/docs/harness/prompts/README.md index 6fb52f8e..6c0467a6 100644 --- a/docs/harness/prompts/README.md +++ b/docs/harness/prompts/README.md @@ -4,6 +4,8 @@ --- +> **与 `@cyning/harness` sync**:仓根扁平帽(`30-execute-code.md` 等)由产品包同步,供对照;**本仓执行真值**仍是 `hats/` · `templates/` · `handoff/` · `PROMPT_*_chain_serial_*`。 + ## 使用方式 1. **10 结束**:必须输出 **下一棒 A(22)** + **下一棒 B(30)** 两条 §3 Prompt,**人**择一。 diff --git a/docs/harness/prompts/TEMPLATE_30_gate_stop.md b/docs/harness/prompts/TEMPLATE_30_gate_stop.md new file mode 100644 index 00000000..be259dcb --- /dev/null +++ b/docs/harness/prompts/TEMPLATE_30_gate_stop.md @@ -0,0 +1,37 @@ +# 模板:30 拒开工 · 人工闸 STOP + +> **用途**:`HG-AUDIT-R1` 或其它 blocks **30** 的闸为 `pending` 时,**首输出**须为本形状;**禁止**改业务码、禁止落 30 invoke。 +> **复制**:Agent 按此填空;维护者演练拒开工时可对照。 + +--- + +## 人工闸扫描(30 · 拒开工) + +| human_gate_id | task表status | 用户/invoke声称 | 一致? | blocks_30 | 30 可开工? | +|---------------|--------------|-----------------|--------|-----------|-------------| +| HG-TASK-DRAFT | {读表} | {若有} | {Y/N} | {Y/N} | … | +| **HG-AUDIT-R1** | **{读表}** | {若有} | {Y/N} | Y | **{❌ 否 / ✅ 是}** | +| HG-GRAPH-MODULES | {读表或 —} | — | — | … | … | + +**冲突**:task 表 `pending` 且声称 `approved` → **拒开工**(不得采信聊天)。 + +**pre-30 invoke(v2.14+)**:`verify` 报 `missing pre-30 invoke hats` → **拒开工**(用户「开工」不能豁免;维护者可用 `--allow-invoke-gap` 留痕放行)。 + +**结论**:**拒开工** — task 表真值未满足 30 条件。 + +**真值依据**:`docs/tasks/active/task_*.md` 人工闸表(**聊天 Prompt 不能替代 `approved`**)+ `npx @cyning/harness verify --task`。 + +**维护者下一步**: + +1. 在 task 表将阻塞闸改为 `approved`(附维护者 · 日期) +2. 补齐 pre-30 invoke(通常 `invoke_*_10_*`)或改 `minimal` / `--allow-invoke-gap` +3. `git add` + `commit` task 文档(或维护者确认已签) +4. 重新下发 Harness 30 Prompt + +**禁止**:将「维护者发送 30 Prompt」或用户口头「开工」视为闸已签收。 + +--- + +## 给 Cursor + +`Harness`、`30`、`拒开工`、`HG-AUDIT-R1`、`human_gate` diff --git a/docs/harness/reviews/by-task/harness-upgrade-2.19.0/task_harness_upgrade_2.19.0_audit_R1_20260728.md b/docs/harness/reviews/by-task/harness-upgrade-2.19.0/task_harness_upgrade_2.19.0_audit_R1_20260728.md new file mode 100644 index 00000000..4f7c71a3 --- /dev/null +++ b/docs/harness/reviews/by-task/harness-upgrade-2.19.0/task_harness_upgrade_2.19.0_audit_R1_20260728.md @@ -0,0 +1,17 @@ +# Task Audit R1:harness-upgrade-2.19.0 + +> **hat_id**:20-task-audit +> **task**:`docs/tasks/active/task_harness_upgrade_2.19.0.md` +> **日期**:2026-07-28 · 审查人:00 统筹(兼 20) + +## 结论摘要 + +| 维度 | 结论 | +| --- | --- | +| **内容** | 零阻塞:钉 2.19.0 + `lint-wiki-delta` dogfood;补齐 10 个遗漏字段;overlay 已恢复 | +| **流程闸** | HG-TASK-DRAFT / HG-AUDIT-R1 / HG-GRAPH-MODULES 均为 approved | +| **非范围** | 未改 `api/` · 未覆盖 `docs/coding_wiki/` · 未改 `profile.wiki` | + +## 签收 + +**签收**。允许 30/40 关账本 upgrade task;禁止关闭其它 active 业务 task。 diff --git a/docs/harness/reviews/task_harness_upgrade_2.19.0_audit_R1_20260728.md b/docs/harness/reviews/task_harness_upgrade_2.19.0_audit_R1_20260728.md new file mode 100644 index 00000000..4f7c71a3 --- /dev/null +++ b/docs/harness/reviews/task_harness_upgrade_2.19.0_audit_R1_20260728.md @@ -0,0 +1,17 @@ +# Task Audit R1:harness-upgrade-2.19.0 + +> **hat_id**:20-task-audit +> **task**:`docs/tasks/active/task_harness_upgrade_2.19.0.md` +> **日期**:2026-07-28 · 审查人:00 统筹(兼 20) + +## 结论摘要 + +| 维度 | 结论 | +| --- | --- | +| **内容** | 零阻塞:钉 2.19.0 + `lint-wiki-delta` dogfood;补齐 10 个遗漏字段;overlay 已恢复 | +| **流程闸** | HG-TASK-DRAFT / HG-AUDIT-R1 / HG-GRAPH-MODULES 均为 approved | +| **非范围** | 未改 `api/` · 未覆盖 `docs/coding_wiki/` · 未改 `profile.wiki` | + +## 签收 + +**签收**。允许 30/40 关账本 upgrade task;禁止关闭其它 active 业务 task。 diff --git a/docs/tasks/active/task_api_routes_admin_ingest_split_w3.md b/docs/tasks/active/task_api_routes_admin_ingest_split_w3.md index a159cd3e..8a60b458 100644 --- a/docs/tasks/active/task_api_routes_admin_ingest_split_w3.md +++ b/docs/tasks/active/task_api_routes_admin_ingest_split_w3.md @@ -25,6 +25,8 @@ | **chain_prompt** | `PROMPT_claude_chain_serial_v1_T1_standards-backend-api-modularization-w2-w8_zh.md` | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/active/task_api_routes_legacy_chat_split_w2.md b/docs/tasks/active/task_api_routes_legacy_chat_split_w2.md index 04eafe19..3c03f225 100644 --- a/docs/tasks/active/task_api_routes_legacy_chat_split_w2.md +++ b/docs/tasks/active/task_api_routes_legacy_chat_split_w2.md @@ -23,6 +23,8 @@ | **chain_prompt** | `PROMPT_claude_chain_serial_v1_T1_standards-backend-api-modularization-w2-w8_zh.md` | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/active/task_api_unified_json_split_w4.md b/docs/tasks/active/task_api_unified_json_split_w4.md index c4cb838e..170bc46a 100644 --- a/docs/tasks/active/task_api_unified_json_split_w4.md +++ b/docs/tasks/active/task_api_unified_json_split_w4.md @@ -25,6 +25,8 @@ | **chain_prompt** | `PROMPT_claude_chain_serial_v1_T1_standards-backend-api-modularization-w2-w8_zh.md` | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/active/task_api_unified_sse_split_w5.md b/docs/tasks/active/task_api_unified_sse_split_w5.md index 1b7a7ef9..431af451 100644 --- a/docs/tasks/active/task_api_unified_sse_split_w5.md +++ b/docs/tasks/active/task_api_unified_sse_split_w5.md @@ -25,6 +25,8 @@ | **chain_prompt** | `PROMPT_claude_chain_serial_v1_T1_standards-backend-api-modularization-w2-w8_zh.md` | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/active/task_chatbi_v3_debt_from_v2_multiturn_v1.md b/docs/tasks/active/task_chatbi_v3_debt_from_v2_multiturn_v1.md index 2c05fc36..9841698d 100644 --- a/docs/tasks/active/task_chatbi_v3_debt_from_v2_multiturn_v1.md +++ b/docs/tasks/active/task_chatbi_v3_debt_from_v2_multiturn_v1.md @@ -19,6 +19,8 @@ | **semi_auto** | `false` | | **audit_profile** | `human_only` | | **git_branch** | — | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/active/task_chatbi_v3_intent_classification_debt_v1.md b/docs/tasks/active/task_chatbi_v3_intent_classification_debt_v1.md index f3679483..3d388482 100644 --- a/docs/tasks/active/task_chatbi_v3_intent_classification_debt_v1.md +++ b/docs/tasks/active/task_chatbi_v3_intent_classification_debt_v1.md @@ -18,6 +18,8 @@ | **semi_auto** | `false` | | **audit_profile** | `human_only` | | **git_branch** | — | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1.md b/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1.md index 16ad5947..f3aaf35a 100644 --- a/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1.md +++ b/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1.md @@ -21,6 +21,8 @@ | **audit_profile** | `full` | | **git_branch** | `task/chatbi-v3-low-confidence-plan` | | **reinspect** | 母单剩余项关账前 **必须** 50 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1_AGENT_PROMPT.md b/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1_AGENT_PROMPT.md index df5ad43c..66515be4 100644 --- a/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1_AGENT_PROMPT.md +++ b/docs/tasks/active/task_chatbi_v3_low_confidence_plan_preview_confirm_v1_AGENT_PROMPT.md @@ -1,5 +1,13 @@ # 执行 Agent 任务交代:agent.py「方案 B」编排修正(P2 延伸 · 首包可只做本项) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态(2026-05-13)**:首包已在主任务单 **§5.0** 记为 **已验收**;若续拆 PR 请读 **`task_chatbi_v3_low_confidence_plan_preview_confirm_v1.md`** **§5.1**(仍 backlog)。 > **用途**:将本文件 **全文**复制给负责改代码的 Cursor Agent(或本对话续写),作为单一真值输入。 > **仓库**:`ai-ink-brain-api-python` diff --git a/docs/tasks/active/task_chatbi_v3_planning_after_resume_v1.md b/docs/tasks/active/task_chatbi_v3_planning_after_resume_v1.md index f8b81f67..d29eca1f 100644 --- a/docs/tasks/active/task_chatbi_v3_planning_after_resume_v1.md +++ b/docs/tasks/active/task_chatbi_v3_planning_after_resume_v1.md @@ -15,6 +15,8 @@ | **semi_auto** | `false` | | **audit_profile** | `human_only` | | **git_branch** | — | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/active/task_engineering_graph_yaml_external_ref_backlog_v1.md b/docs/tasks/active/task_engineering_graph_yaml_external_ref_backlog_v1.md index 3d1ac75d..2e772f6d 100644 --- a/docs/tasks/active/task_engineering_graph_yaml_external_ref_backlog_v1.md +++ b/docs/tasks/active/task_engineering_graph_yaml_external_ref_backlog_v1.md @@ -12,6 +12,8 @@ | --- | --- | | **test_strategy** | `not_applicable` | | **test_strategy_note** | backlog 占位 · 未立项 · 无实现 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/active/task_ops_session_s4_promote_conflict_api_v1.md b/docs/tasks/active/task_ops_session_s4_promote_conflict_api_v1.md index 58469c85..2b945559 100644 --- a/docs/tasks/active/task_ops_session_s4_promote_conflict_api_v1.md +++ b/docs/tasks/active/task_ops_session_s4_promote_conflict_api_v1.md @@ -22,6 +22,8 @@ | **git_branch** | `task/ops-session-s4-promote-conflict-api` | | **blocks** | S5 promote 运营闭环 | | **blocked_by** | S4 `ops-session-s4-verify-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 行为变更 Delta diff --git a/docs/tasks/active/task_ops_session_s5_extract_adr_v1.md b/docs/tasks/active/task_ops_session_s5_extract_adr_v1.md index 21d2ebb5..82926223 100644 --- a/docs/tasks/active/task_ops_session_s5_extract_adr_v1.md +++ b/docs/tasks/active/task_ops_session_s5_extract_adr_v1.md @@ -23,6 +23,8 @@ | **git_branch** | `task/ops-session-s5-extract-adr` | | **blocks** | S5.2 `ops-session-s5-graph-promote`(可选)· Epic v1 freeze | | **blocked_by** | S5.0 `ops-session-s5-import-boundary-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/active/task_ops_session_s5_graph_promote_api_v1.md b/docs/tasks/active/task_ops_session_s5_graph_promote_api_v1.md index 9397f94f..79aea195 100644 --- a/docs/tasks/active/task_ops_session_s5_graph_promote_api_v1.md +++ b/docs/tasks/active/task_ops_session_s5_graph_promote_api_v1.md @@ -23,6 +23,8 @@ | **git_branch** | `task/ops-session-s5-graph-promote-api` | | **blocks** | Epic §12.3 勾选项 · MVP+ 验收 | | **blocked_by** | S5.1 `ops-session-s5-extract-adr` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 行为变更 Delta diff --git a/docs/tasks/active/task_ops_session_s5_import_boundary_api_v1.md b/docs/tasks/active/task_ops_session_s5_import_boundary_api_v1.md index 461928fa..058b9c31 100644 --- a/docs/tasks/active/task_ops_session_s5_import_boundary_api_v1.md +++ b/docs/tasks/active/task_ops_session_s5_import_boundary_api_v1.md @@ -23,6 +23,8 @@ | **git_branch** | `task/ops-session-s5-import-boundary-api` | | **blocks** | S5.1 `ops-session-s5-extract-adr` | | **blocked_by** | S4 `ops-session-s4-verify-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 行为变更 Delta diff --git a/docs/tasks/active/task_portfolio_jd_match_p0_rewrite_rubric_v1.md b/docs/tasks/active/task_portfolio_jd_match_p0_rewrite_rubric_v1.md index da883376..d6acf47d 100644 --- a/docs/tasks/active/task_portfolio_jd_match_p0_rewrite_rubric_v1.md +++ b/docs/tasks/active/task_portfolio_jd_match_p0_rewrite_rubric_v1.md @@ -22,6 +22,8 @@ | **Open Folder** | `ai-ink-brain-api-python` | | **blocked_by** | 无(可与 #118 并行规划;**验收**建议 #118 merge 后) | | **blocks** | P1 并行 sub-RAG task(未建) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/active/task_rag_graphrag_pilot_explore_v1.md b/docs/tasks/active/task_rag_graphrag_pilot_explore_v1.md index cf13e132..5bdc2372 100644 --- a/docs/tasks/active/task_rag_graphrag_pilot_explore_v1.md +++ b/docs/tasks/active/task_rag_graphrag_pilot_explore_v1.md @@ -18,6 +18,8 @@ | **semi_auto** | `false` | | **audit_profile** | `full` | | **git_branch** | `task/rag-graphrag-pilot` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/active/task_ui_chain_events_backend.md b/docs/tasks/active/task_ui_chain_events_backend.md index bd91e1c0..0d6ba748 100644 --- a/docs/tasks/active/task_ui_chain_events_backend.md +++ b/docs/tasks/active/task_ui_chain_events_backend.md @@ -15,6 +15,8 @@ | **semi_auto** | `false` | | **audit_profile** | `full` | | **git_branch** | `task/ui-chain-events-backend` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/Task 04.md b/docs/tasks/done/Task 04.md index 5b7cdaa6..19c4be87 100644 --- a/docs/tasks/done/Task 04.md +++ b/docs/tasks/done/Task 04.md @@ -10,6 +10,8 @@ | **test_strategy_note** | legacy 归档消化;正文为历史交付记录,P2 仅补状态与元信息表 | | **semi_auto** | `false` | | **git_branch** | `task/gov-docs-noise-p2-v1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | ## 失败路径 diff --git a/docs/tasks/done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md b/docs/tasks/done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md index 84fd5fc8..ae74e54d 100644 --- a/docs/tasks/done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md +++ b/docs/tasks/done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md @@ -1,5 +1,13 @@ # ChatBI V2 Agent(P0 后端)— 11 点约束确认与落地计划(问答回溯) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态**:done(2026-04-29) > **归档路径**:`docs/tasks/done/done_chatbi_v2_agent_p0_backend_constraints_2026-04-29.md` > **关联任务**:`docs/tasks/active/task_chatbi_v2_agent_p0_backend.md` diff --git a/docs/tasks/done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md b/docs/tasks/done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md index c506a396..49357f12 100644 --- a/docs/tasks/done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md +++ b/docs/tasks/done/done_chatbi_v2_agent_p0_backend_full_2026-04-29.md @@ -1,5 +1,13 @@ # Done:ChatBI V2 Agent(P0 后端)— 全量落地归档(2026-04-29) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态**:done > **范围**:仅后端 `ai-ink-brain-api-python` > **关联任务**:`docs/tasks/active/task_chatbi_v2_agent_p0_backend.md` diff --git a/docs/tasks/done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md b/docs/tasks/done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md index d0911ffb..24f06145 100644 --- a/docs/tasks/done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md +++ b/docs/tasks/done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 Agent(P0 后端)— 模块骨架落盘 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态**:done(2026-04-29:完成 tools/intent_agent/agent_memory 骨架落地;尚未接入 unified_chat 与 ReAct loop) > **归档路径**:`docs/tasks/done/done_chatbi_v2_agent_p0_backend_modules_intent_tools_memory.md` > **范围**:仅后端 `ai-ink-brain-api-python` diff --git a/docs/tasks/done/done_unified_chat_backend_v1.md b/docs/tasks/done/done_unified_chat_backend_v1.md index c1aa2874..c377cb3d 100644 --- a/docs/tasks/done/done_unified_chat_backend_v1.md +++ b/docs/tasks/done/done_unified_chat_backend_v1.md @@ -1,5 +1,13 @@ # Task:Unified Chat(后端 v1)— 融合 RAG + Text2SQL + events[] +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态**:done(2026-04-28 验收通过) > **归档路径**:`docs/tasks/done/done_unified_chat_backend_v1.md` > **范围**:仅后端 `ai-ink-brain-api-python` diff --git a/docs/tasks/done/done_unified_chat_streaming_backend_sse_v1.md b/docs/tasks/done/done_unified_chat_streaming_backend_sse_v1.md index 189a65bd..2f7fdace 100644 --- a/docs/tasks/done/done_unified_chat_streaming_backend_sse_v1.md +++ b/docs/tasks/done/done_unified_chat_streaming_backend_sse_v1.md @@ -1,5 +1,13 @@ # Task:Unified Chat Streaming(后端 v1 / SSE) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态**:done(2026-04-28 验收通过) > **归档路径**:`docs/tasks/done/done_unified_chat_streaming_backend_sse_v1.md` > **范围**:仅后端 `ai-ink-brain-api-python` diff --git a/docs/tasks/done/session-local-demos/task_local_s2_demo1_v1.md b/docs/tasks/done/session-local-demos/task_local_s2_demo1_v1.md index 722c9871..dccb964e 100644 --- a/docs/tasks/done/session-local-demos/task_local_s2_demo1_v1.md +++ b/docs/tasks/done/session-local-demos/task_local_s2_demo1_v1.md @@ -8,6 +8,8 @@ | 字段 | 值 | | --- | --- | | **task_slug** | `local_s2_demo1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/session-local-demos/task_local_s3_test1_v1.md b/docs/tasks/done/session-local-demos/task_local_s3_test1_v1.md index 4cb55694..73af0112 100644 --- a/docs/tasks/done/session-local-demos/task_local_s3_test1_v1.md +++ b/docs/tasks/done/session-local-demos/task_local_s3_test1_v1.md @@ -8,6 +8,8 @@ | 字段 | 值 | | --- | --- | | **task_slug** | `local_s3_test1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/session-local-demos/task_local_s5_test_v1.md b/docs/tasks/done/session-local-demos/task_local_s5_test_v1.md index 7f84fc37..ceaa5eec 100644 --- a/docs/tasks/done/session-local-demos/task_local_s5_test_v1.md +++ b/docs/tasks/done/session-local-demos/task_local_s5_test_v1.md @@ -8,6 +8,8 @@ | 字段 | 值 | | --- | --- | | **task_slug** | `local_s5_test` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_03_hybrid_search_implementation.md b/docs/tasks/done/task_03_hybrid_search_implementation.md index 7a3e65ce..4f9453ef 100644 --- a/docs/tasks/done/task_03_hybrid_search_implementation.md +++ b/docs/tasks/done/task_03_hybrid_search_implementation.md @@ -10,6 +10,8 @@ | **test_strategy_note** | legacy 归档消化;正文为历史交付记录,P2 仅补状态与元信息表 | | **semi_auto** | `false` | | **git_branch** | `task/gov-docs-noise-p2-v1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ## 失败路径 diff --git a/docs/tasks/done/task_05_query_rewrite_observability.md b/docs/tasks/done/task_05_query_rewrite_observability.md index a183e560..21213493 100644 --- a/docs/tasks/done/task_05_query_rewrite_observability.md +++ b/docs/tasks/done/task_05_query_rewrite_observability.md @@ -20,6 +20,8 @@ | **semi_auto** | `true` | | **audit_profile** | `post_close` | | **git_branch** | `task/query-rewrite-obs` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_api_agent_loop_split_w6.md b/docs/tasks/done/task_api_agent_loop_split_w6.md index 1b16c9a4..3232b688 100644 --- a/docs/tasks/done/task_api_agent_loop_split_w6.md +++ b/docs/tasks/done/task_api_agent_loop_split_w6.md @@ -25,6 +25,8 @@ | **chain_prompt** | `PROMPT_claude_chain_serial_v1_T1_standards-backend-api-modularization-w2-w8_zh.md` | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_api_env_rag_env_consolidation_w1.md b/docs/tasks/done/task_api_env_rag_env_consolidation_w1.md index b774e55e..a52849c3 100644 --- a/docs/tasks/done/task_api_env_rag_env_consolidation_w1.md +++ b/docs/tasks/done/task_api_env_rag_env_consolidation_w1.md @@ -18,6 +18,8 @@ | **chain_prompt** | `PROMPT_cursor_task_chain_serial_v1_T1_standards-backend-api-modularization-w1-w8_zh.md` | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_api_intent_stack_split_w8.md b/docs/tasks/done/task_api_intent_stack_split_w8.md index 089ad42d..425eb0df 100644 --- a/docs/tasks/done/task_api_intent_stack_split_w8.md +++ b/docs/tasks/done/task_api_intent_stack_split_w8.md @@ -24,6 +24,8 @@ | **orchestration** | Cursor Task 链 | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_api_tools_registry_split_w7.md b/docs/tasks/done/task_api_tools_registry_split_w7.md index 16b09b5a..4d1f3856 100644 --- a/docs/tasks/done/task_api_tools_registry_split_w7.md +++ b/docs/tasks/done/task_api_tools_registry_split_w7.md @@ -24,6 +24,8 @@ | **orchestration** | Cursor Task 链 | | **test_strategy** | `required` | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_backend_improve_batch_a_p0_v1.md b/docs/tasks/done/task_backend_improve_batch_a_p0_v1.md index 88e79305..a77584ec 100644 --- a/docs/tasks/done/task_backend_improve_batch_a_p0_v1.md +++ b/docs/tasks/done/task_backend_improve_batch_a_p0_v1.md @@ -21,6 +21,8 @@ | **semi_auto** | `true` | | **audit_profile** | `post_close` | | **git_branch** | `task/backend-improve-batch-a-p0` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_baseline_merge_gate_v1.md b/docs/tasks/done/task_chatbi_baseline_merge_gate_v1.md index f33641c5..0f98e775 100644 --- a/docs/tasks/done/task_chatbi_baseline_merge_gate_v1.md +++ b/docs/tasks/done/task_chatbi_baseline_merge_gate_v1.md @@ -29,6 +29,8 @@ | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | | **推荐路径** | **22 R1**(`test_strategy: required` + 涉 `api/` + 契约) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_graph_p0_foundation_v1.md b/docs/tasks/done/task_chatbi_graph_p0_foundation_v1.md index 918c10e1..f4ed8506 100644 --- a/docs/tasks/done/task_chatbi_graph_p0_foundation_v1.md +++ b/docs/tasks/done/task_chatbi_graph_p0_foundation_v1.md @@ -25,6 +25,8 @@ | **Open Folder** | `ai-ink-brain-api-python` | | **推荐路径** | **50 独立复检** — `test_strategy: required` + 关账前 `reinspect_results/` | | **worktree_root** | (非并行时与 Open Folder 同仓根;并行时 invoke 另填) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_intent_hints_step1_v1.md b/docs/tasks/done/task_chatbi_intent_hints_step1_v1.md index a944a1a9..4678ec18 100644 --- a/docs/tasks/done/task_chatbi_intent_hints_step1_v1.md +++ b/docs/tasks/done/task_chatbi_intent_hints_step1_v1.md @@ -27,6 +27,8 @@ | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | | **推荐路径** | **22 R1**(SDD 清单有待确认项 + `test_strategy: required` + 涉 `api/`) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_intent_hints_step2_v1.md b/docs/tasks/done/task_chatbi_intent_hints_step2_v1.md index a4e378f2..126a3009 100644 --- a/docs/tasks/done/task_chatbi_intent_hints_step2_v1.md +++ b/docs/tasks/done/task_chatbi_intent_hints_step2_v1.md @@ -30,6 +30,8 @@ | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | | **推荐路径** | **22 R1**(SDD 清单有待确认项 + `test_strategy: required` + 涉 `api/`) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_intent_llm_retry_u1_5_v1.md b/docs/tasks/done/task_chatbi_intent_llm_retry_u1_5_v1.md index cbcf475c..d2832183 100644 --- a/docs/tasks/done/task_chatbi_intent_llm_retry_u1_5_v1.md +++ b/docs/tasks/done/task_chatbi_intent_llm_retry_u1_5_v1.md @@ -24,6 +24,8 @@ | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `50` | | **experience_capture** | `required` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_level_gate_v1.md b/docs/tasks/done/task_chatbi_level_gate_v1.md index 4baf29a8..693ef306 100644 --- a/docs/tasks/done/task_chatbi_level_gate_v1.md +++ b/docs/tasks/done/task_chatbi_level_gate_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V3 — 分级权限闸门(Bearer + 表策略 + Text2SQL) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done`(**2026-05-13** 归档至 **`docs/tasks/done/`**;**§P1** Supabase DDL + RUNBOOK 令牌已在目标库执行并完成验收勾选) > **关联 SPEC**:`docs/spec/v3-agent/SPEC-ChatBI-V3-Identity-Access.md`、`docs/spec/v3-agent/SPEC-ChatBI-V3-Identity-Access-OpenItems.md`(**§一、§五**) > **关联安全子规**:`docs/spec/v3-agent/SPEC-ChatBI-V3-Security.md`(AST / 表白名单) diff --git a/docs/tasks/done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md b/docs/tasks/done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md index 86e825c0..13dd0ccc 100644 --- a/docs/tasks/done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md +++ b/docs/tasks/done/task_chatbi_text2sql_denial_final_answer_no_respin_v1.md @@ -1,5 +1,13 @@ # 任务:Text2SQL 无权限终态与禁止 RAG 后再启 Text2SQL +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + ## 元信息 - **状态**:**done**(2026-05-12;本单已归档至 **`docs/tasks/done/`**;验收真值见下) diff --git a/docs/tasks/done/task_chatbi_v2_acceptance_runner_v1.md b/docs/tasks/done/task_chatbi_v2_acceptance_runner_v1.md index d2e12930..76b8d7bd 100644 --- a/docs/tasks/done/task_chatbi_v2_acceptance_runner_v1.md +++ b/docs/tasks/done/task_chatbi_v2_acceptance_runner_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 —— 验收执行引导(Runner) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-05-22 验收通过) 范围:后端 `ai-ink-brain-api-python`;跨仓步骤仅列引用 **权威真值**:`docs/spec/v2-agent/SPEC-ChatBI-V2-Agent-Overview.md` **§7**(验收勾选)、**§7.4**(全量对照)、**§7.5**(L0–L7 操作细则) diff --git a/docs/tasks/done/task_chatbi_v2_agent_p0_backend.md b/docs/tasks/done/task_chatbi_v2_agent_p0_backend.md index a0affa90..100911e2 100644 --- a/docs/tasks/done/task_chatbi_v2_agent_p0_backend.md +++ b/docs/tasks/done/task_chatbi_v2_agent_p0_backend.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 Agent(P0 后端)— 接入 `agent.*` 事件、ReAct 循环与记忆 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:done(2026-04-29:P0 后端 Agent 全量落地并归档) 范围:仅后端 `ai-ink-brain-api-python` 关联: diff --git a/docs/tasks/done/task_chatbi_v2_agent_p1_behavior.md b/docs/tasks/done/task_chatbi_v2_agent_p1_behavior.md index 7afa2574..d8cf7473 100644 --- a/docs/tasks/done/task_chatbi_v2_agent_p1_behavior.md +++ b/docs/tasks/done/task_chatbi_v2_agent_p1_behavior.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 Agent(P1 总览)— 意图准确率、性能基准、缓存与调优 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:**done(2026-05-11 验收通过)** — 本文件已按 `docs/tasks/README.md` 迁入 **`docs/tasks/done/`**;P1-Eval 冻结口径仍以 **复跑五** `intent_llm_20260507_1529_v1fb1_acc9500_macro9484_tout60.*` 为基线;P1-D 见 `task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md` + `tests/_out/intent_llm_20260507_160444_p1d_live.*` 范围:仅后端 `ai-ink-brain-api-python`(**全仓相对总规的完成度**不以本文件为唯一口径,见 `SPEC-ChatBI-V2-Agent-Overview.md` **§7.4**、**§7.5**) 前置:P0 已完成(`task_chatbi_v2_agent_p0_backend.md` 已归档) diff --git a/docs/tasks/done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md b/docs/tasks/done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md index 3db7ea87..d7986603 100644 --- a/docs/tasks/done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md +++ b/docs/tasks/done/task_chatbi_v2_agent_p1_eval_benchmark_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 Agent(P1-Eval)— 可验证评测与性能基准(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:done(工具链/CI 门禁已落地);**准确率验收冻结以「复跑五」为准**(`tests/_out/intent_llm_20260507_1529_v1fb1_acc9500_macro9484_tout60.*`,`CHATBI_V2_INTENT_TIMEOUT_S=60`);**复跑三**(`intent_llm_latest_20260507_113718_v1fb3_acc0933_macro0932.*`)为前冻结历史对照;**复跑四**为补充对照;见 `docs/diary/2026-05-06-p1-intent-benchmark.md`;**复跑二**仍为网络差基线 范围:仅后端 `ai-ink-brain-api-python` 前置:P0 已完成(`task_chatbi_v2_agent_p0_backend.md` 已归档) diff --git a/docs/tasks/done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md b/docs/tasks/done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md index f695082d..2dc3607d 100644 --- a/docs/tasks/done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md +++ b/docs/tasks/done/task_chatbi_v2_agent_p1c_intent_cache_observability_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 Agent(P1-C)— IntentCache(LRU+TTL)与可观测性(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:done(2026-05-06) 范围:仅后端 `ai-ink-brain-api-python` 前置:P1-P0 已具备评测闭环脚本(accuracy/latency/agent-e2e) diff --git a/docs/tasks/done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md b/docs/tasks/done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md index 3962bb76..bc59355b 100644 --- a/docs/tasks/done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md +++ b/docs/tasks/done/task_chatbi_v2_agent_p1d_intent_prompt_and_thresholds_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 Agent(P1-D)— Intent 误判调优(Prompt / 阈值 / 超时策略)(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:**done**(2026-05-07:`intent_eval` 已跑并归档 `intent_llm_20260507_160444_p1d_live.*`;见 `docs/diary/2026-05-07-p1-intent-p1d.md` 前后表) 范围:仅后端 `ai-ink-brain-api-python` 前置: diff --git a/docs/tasks/done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md b/docs/tasks/done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md index efa4b998..e2cad87b 100644 --- a/docs/tasks/done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md +++ b/docs/tasks/done/task_chatbi_v2_docs_acceptance_archive_2026-05-11.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 —— 规格与任务「验收 + 归档」(文档层收口) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + 状态:**done(2026-05-11 验收通过)** — 本文件已按 `docs/tasks/README.md` 迁入 **`docs/tasks/done/`**;**不修改**总规 `SPEC-ChatBI-V2-Agent-Overview.md` §7 正文勾选;本页为 **Runner + diary + CI** 的收口索引 日期:**2026-05-11** 范围:后端 `ai-ink-brain-api-python` 之 **`docs/spec/v2-agent/`**、**`docs/tasks/`**(ChatBI V2 相关;**已闭环子任务见 `docs/tasks/done/`** 下表) diff --git a/docs/tasks/done/task_chatbi_v2_incremental_sse_backend_v1.md b/docs/tasks/done/task_chatbi_v2_incremental_sse_backend_v1.md index 28a3b5b4..2b07be47 100644 --- a/docs/tasks/done/task_chatbi_v2_incremental_sse_backend_v1.md +++ b/docs/tasks/done/task_chatbi_v2_incremental_sse_backend_v1.md @@ -1,5 +1,13 @@ # 实现 ChatBI V2 执行期增量 SSE 与 LLM 子步流式(后端 v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + **状态**:done(2026-05-11 验收通过) **归档自**:`docs/tasks/active/task_chatbi_v2_incremental_sse_backend_v1.md` **范围**:仅 `ai-ink-brain-api-python`(`api/unified_chat.py`、`api/agent.py` 及 LLM 调用链;契约与 CI) diff --git a/docs/tasks/done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md b/docs/tasks/done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md index de96eb7e..2733cccb 100644 --- a/docs/tasks/done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md +++ b/docs/tasks/done/task_chatbi_v2_rewrite_timeline_llm_prompt_capture_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 — RAG 改写过程上链与 LLM Prompt 全量可观测 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-11 验收通过)` > **范围**:`ai-ink-brain-api-python` — V2 Agent SSE/JSON、`tools`、`intent_agent`、`query_rewrite` > **关联规格**:`docs/spec/v2-agent/SPEC-ChatBI-V2-Agent-Overview.md`(chain 事件、RAG 子步) diff --git a/docs/tasks/done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md b/docs/tasks/done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md index bbd82ada..49cb9459 100644 --- a/docs/tasks/done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md +++ b/docs/tasks/done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V2 — Text2SQL 多轮语义承接(已实现基线 + 值域锚点后续) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`archived_done`(**V2 本子任务完结**;B-PR1 2026-05-09;B-PR2 2026-05-11;§验收已闭合。) > **归档位置**:`docs/tasks/done/task_chatbi_v2_text2sql_multiturn_grounding_v1.md`(若你仍打开 `active/` 下旧路径,请改指向 **done**)。 > **未纳入 V2 的后续**:**欠债已单独记录** → `docs/tasks/active/task_chatbi_v3_debt_from_v2_multiturn_v1.md`(**V3 统筹**,含 §4.3 澄清、同义词语义等)。 diff --git a/docs/tasks/done/task_chatbi_v3_lowconf_rag_preview_v1.md b/docs/tasks/done/task_chatbi_v3_lowconf_rag_preview_v1.md index 6f837ebb..98340733 100644 --- a/docs/tasks/done/task_chatbi_v3_lowconf_rag_preview_v1.md +++ b/docs/tasks/done/task_chatbi_v3_lowconf_rag_preview_v1.md @@ -24,6 +24,8 @@ | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `00`(建议 · 与 5-2 同编排) | | **git_branch** | `task/chatbi-v3-lowconf-rag-preview` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 阶段状态(00 维护 · 2026-05-31) diff --git a/docs/tasks/done/task_chatbi_v3_lowconf_sql_preview_v1.md b/docs/tasks/done/task_chatbi_v3_lowconf_sql_preview_v1.md index 6fa99ae3..a8a1a44b 100644 --- a/docs/tasks/done/task_chatbi_v3_lowconf_sql_preview_v1.md +++ b/docs/tasks/done/task_chatbi_v3_lowconf_sql_preview_v1.md @@ -24,6 +24,8 @@ | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `00` | | **git_branch** | `task/chatbi-v3-lowconf-sql-preview` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 阶段状态(00 维护 · 2026-05-31) diff --git a/docs/tasks/done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md b/docs/tasks/done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md index fbfd6937..a2fb39a3 100644 --- a/docs/tasks/done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md +++ b/docs/tasks/done/task_chatbi_v3_multiturn_clarify_semantics_4_3_v1.md @@ -1,5 +1,13 @@ # V3 待办:多轮低置信指代澄清(V2 Multiturn §4 第 3 点 / 惯称 §4.3) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + ## 元信息 - **状态**:`done`(**P1-4** 首包 **implementation**;不阻塞母单其它 §2 条目另拆 PR) diff --git a/docs/tasks/done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md b/docs/tasks/done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md index cc238fda..dfcd132b 100644 --- a/docs/tasks/done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md +++ b/docs/tasks/done/task_chatbi_v3_p2_loop_r1_closeout_hygiene_v1.md @@ -20,6 +20,8 @@ | **git_branch** | `task/chatbi-v3-p2-loop-v1`(与母单相同) | | **task_slug** | `chatbi-v3-p2-loop-r1-closeout` | | **human_gate** | **继承母单** `HG-LOOP-BATCH`(见母 task 表) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | **帽子顺序**:跳过 10 · 链 `PROMPT_LOOP_22_to_CLOSE` · round=**R1** diff --git a/docs/tasks/done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md b/docs/tasks/done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md index da5e524a..fc61ab0a 100644 --- a/docs/tasks/done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md +++ b/docs/tasks/done/task_chatbi_v3_p2_resilience_circuit_breaker_v1.md @@ -24,6 +24,8 @@ | worktree_root | 主仓 `ai-ink-brain-api-python/` | | task_slug | `chatbi-v3-p2-loop-r2-circuit-breaker` | | human_gate | **继承母单** `HG-LOOP-BATCH` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | **帽子顺序**:跳过 10 · 链 `docs/harness/invokes/by-task/chatbi-v3-p2-loop/PROMPT_LOOP_22_to_CLOSE_v1.md` · round=**R2** diff --git a/docs/tasks/done/task_chatbi_v3_p2_resilience_health_ready_v1.md b/docs/tasks/done/task_chatbi_v3_p2_resilience_health_ready_v1.md index 293fcebf..44f19fd8 100644 --- a/docs/tasks/done/task_chatbi_v3_p2_resilience_health_ready_v1.md +++ b/docs/tasks/done/task_chatbi_v3_p2_resilience_health_ready_v1.md @@ -16,6 +16,8 @@ | semi_auto | `true` | | audit_profile | `post_close` | | git_branch | `task/chatbi-v3-p2-1a-health` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_chatbi_v3_p2_resilience_loop_v1.md b/docs/tasks/done/task_chatbi_v3_p2_resilience_loop_v1.md index 1771c9e4..0257447e 100644 --- a/docs/tasks/done/task_chatbi_v3_p2_resilience_loop_v1.md +++ b/docs/tasks/done/task_chatbi_v3_p2_resilience_loop_v1.md @@ -24,6 +24,8 @@ | **git_branch** | `task/chatbi-v3-p2-loop-v1` | | **worktree_root** | 主仓 `ai-ink-brain-api-python/`(**取消** 双轨 worktree) | | **task_slug** | `chatbi-v3-p2-loop` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_v3_p2_resilience_rate_limit_v1.md b/docs/tasks/done/task_chatbi_v3_p2_resilience_rate_limit_v1.md index c95537a3..aacc386f 100644 --- a/docs/tasks/done/task_chatbi_v3_p2_resilience_rate_limit_v1.md +++ b/docs/tasks/done/task_chatbi_v3_p2_resilience_rate_limit_v1.md @@ -22,6 +22,8 @@ | audit_profile | `post_close` | | git_branch | `task/chatbi-v3-p2-1b-rate-limit` | | worktree_root | 主仓 `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_chatbi_v3_p2_resilience_v1.md b/docs/tasks/done/task_chatbi_v3_p2_resilience_v1.md index 139a71c4..9b4e789e 100644 --- a/docs/tasks/done/task_chatbi_v3_p2_resilience_v1.md +++ b/docs/tasks/done/task_chatbi_v3_p2_resilience_v1.md @@ -23,6 +23,8 @@ | **git_branch** | `task/chatbi-v3-p2-resilience-spec` | | **执行模式** | **单闸关账试验**:kickoff 人签 `HG-TASK-DRAFT` + 预批 `HG-AUDIT-R1`;链式 20→22?→30→40→50;**仅** `HG-REINSPECT` 关账前人签 | | **推荐路径(10 帽)** | **B(30)** — 本 task 已起草;22 可选零阻塞落盘,不挡 30 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_chatbi_v3_prompt_injection_guard_poc_v1.md b/docs/tasks/done/task_chatbi_v3_prompt_injection_guard_poc_v1.md index e93a9acd..378077d5 100644 --- a/docs/tasks/done/task_chatbi_v3_prompt_injection_guard_poc_v1.md +++ b/docs/tasks/done/task_chatbi_v3_prompt_injection_guard_poc_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V3 — **Prompt 注入** 防护 PoC(P1-2) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-20 · 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` > **与总规批次对应**:`docs/spec/v3-agent/SPEC-ChatBI-V3-Overview.md` **§2.1 P1-2** diff --git a/docs/tasks/done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md b/docs/tasks/done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md index 3b259873..0b2e71cc 100644 --- a/docs/tasks/done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md +++ b/docs/tasks/done/task_chatbi_v3_sql_ast_text2sql_gate_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI V3 — Text2SQL 后闸 **SQL AST 硬化**(P1-1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-14 验收通过)` > **与总规批次对应**:`docs/spec/v3-agent/SPEC-ChatBI-V3-Overview.md` **§2.1 P1-1** > **L1 子规**:`docs/spec/v3-agent/SPEC-ChatBI-V3-Security.md` **§2**(SQL 解析 / 策略 / 失败形态) diff --git a/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md b/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md index a34fc3f4..d084565a 100644 --- a/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md +++ b/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1.md @@ -1,5 +1,13 @@ # V3 待办:Text2SQL 工具链延迟与可观测性(多轮场景) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + ## 元信息 - **状态**:**done**(2026-05-11;本单与 RUNBOOK 已归档至 **`docs/tasks/done/`**) diff --git a/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md b/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md index f961f033..97dea1fa 100644 --- a/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md +++ b/docs/tasks/done/task_chatbi_v3_text2sql_tool_latency_obs_v1_RUNBOOK.md @@ -1,5 +1,13 @@ # Text2SQL 可观测(V3)— 执行计划 · Checklist · 验收流程 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本文件无 Wiki 增量(2.19 lint-wiki-delta) | + + > **状态**:done(2026-05-11 验收通过) > **关联任务(真值:拍板 / 改进点 / 主验收勾选)**:[`task_chatbi_v3_text2sql_tool_latency_obs_v1.md`](./task_chatbi_v3_text2sql_tool_latency_obs_v1.md) > **维护约定**:本文件为 **过程文档**;实现推进中 **随 PR / 会议结论同步改**(执行步骤打勾、环境键名、事件名、pytest 路径等)。**架构拍板** 仍以任务单 **§拍板** 为准;若与本 runbook 冲突,**以任务单为准**并修正本文件。 diff --git a/docs/tasks/done/task_coding_wiki_ingest_test_strategy_v1.md b/docs/tasks/done/task_coding_wiki_ingest_test_strategy_v1.md index 120b8dfc..1b4395cb 100644 --- a/docs/tasks/done/task_coding_wiki_ingest_test_strategy_v1.md +++ b/docs/tasks/done/task_coding_wiki_ingest_test_strategy_v1.md @@ -22,6 +22,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-a1-a4-v1` | | **task_slug** | `wiki-a1-ingest-test-strategy` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_coding_wiki_pilot_v1.md b/docs/tasks/done/task_coding_wiki_pilot_v1.md index 1fd5e532..bcbb2a97 100644 --- a/docs/tasks/done/task_coding_wiki_pilot_v1.md +++ b/docs/tasks/done/task_coding_wiki_pilot_v1.md @@ -22,6 +22,8 @@ | **semi_auto** | `true` | | **audit_profile** | `post_close` | | **git_branch** | `task/coding-wiki-pilot-v1` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_coding_wiki_schema_test_strategy_rule_v1.md b/docs/tasks/done/task_coding_wiki_schema_test_strategy_rule_v1.md index 20d71e5f..5f56aa0f 100644 --- a/docs/tasks/done/task_coding_wiki_schema_test_strategy_rule_v1.md +++ b/docs/tasks/done/task_coding_wiki_schema_test_strategy_rule_v1.md @@ -22,6 +22,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-a1-a4-v1` | | **task_slug** | `wiki-a2-schema-test-strategy` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_coding_wiki_t1c_test_archive_v1.md b/docs/tasks/done/task_coding_wiki_t1c_test_archive_v1.md index 8f26c408..91c3f872 100644 --- a/docs/tasks/done/task_coding_wiki_t1c_test_archive_v1.md +++ b/docs/tasks/done/task_coding_wiki_t1c_test_archive_v1.md @@ -22,6 +22,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/coding-wiki-t1c-v1` | | **task_slug** | `coding-wiki-t1c` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 触及 docs/coding_wiki(2.19 lint-wiki-delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_docs_tasks_reorg_move_v1.md b/docs/tasks/done/task_docs_tasks_reorg_move_v1.md index 081cdbd7..3918e6d7 100644 --- a/docs/tasks/done/task_docs_tasks_reorg_move_v1.md +++ b/docs/tasks/done/task_docs_tasks_reorg_move_v1.md @@ -1,5 +1,13 @@ # Task:Docs Tasks 规整迁移(v1)— 按类型/状态移动 tasks 文档 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > 状态:done(2026-05-22 验收通过) > 范围:仅 `ai-ink-brain-api-python/docs/`(不涉及代码与 `_tech_graph/`) > 关联:`docs/README.md`、`docs/tasks/_views/*.md` diff --git a/docs/tasks/done/task_docs_truth_and_rag_unify_v1.md b/docs/tasks/done/task_docs_truth_and_rag_unify_v1.md index 00079fa8..1afd3b95 100644 --- a/docs/tasks/done/task_docs_truth_and_rag_unify_v1.md +++ b/docs/tasks/done/task_docs_truth_and_rag_unify_v1.md @@ -1,5 +1,13 @@ # Task:文档真值校准(PROJECT_CONFIG)+ 图谱 Backlog 状态对齐 + Legacy RAG 与 Unified 去重复用 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-28 验收通过) > **归档路径**:`docs/tasks/done/task_docs_truth_and_rag_unify_v1.md` > **交付**:T1 PROJECT_CONFIG、T2 `99_spec` 表、T3 初批 `api/rag_shared` diff --git a/docs/tasks/done/task_engineering_chatbi_sse_first_v1.md b/docs/tasks/done/task_engineering_chatbi_sse_first_v1.md index 75d2a7b4..1aa17dd9 100644 --- a/docs/tasks/done/task_engineering_chatbi_sse_first_v1.md +++ b/docs/tasks/done/task_engineering_chatbi_sse_first_v1.md @@ -1,5 +1,13 @@ # Task:ChatBI 工程约定 — **新功能以 SSE 优先**(Harness 需求帽落盘) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-05-15 验收通过) > **帽子依据**:工作区 `docs/harness/prompts/hats/10-requirements.md` > **test_strategy**:`not_applicable` diff --git a/docs/tasks/done/task_engineering_graph_v2_schema_dual_track_v1.md b/docs/tasks/done/task_engineering_graph_v2_schema_dual_track_v1.md index acb470d6..77defaa7 100644 --- a/docs/tasks/done/task_engineering_graph_v2_schema_dual_track_v1.md +++ b/docs/tasks/done/task_engineering_graph_v2_schema_dual_track_v1.md @@ -23,6 +23,8 @@ | **worktree_root** | `ai-ink-brain-api-python/` | | **freeze_id** | `GRAPH-V2-SCHEMA-DUAL-TRACK` | | **epic** | Inform 规范层 · Post-YAML | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸(草案) diff --git a/docs/tasks/done/task_engineering_graph_yaml_doc_hygiene_p0_v1.md b/docs/tasks/done/task_engineering_graph_yaml_doc_hygiene_p0_v1.md index 15ea1413..14b0ad6b 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_doc_hygiene_p0_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_doc_hygiene_p0_v1.md @@ -21,6 +21,8 @@ | **worktree_root** | `ai-ink-brain-api-python/` | | **freeze_id** | `GRAPH-YAML-DOC-HYGIENE-P0` | | **epic** | 图谱 YAML 迁移 · 续(Inform 闭环) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_engineering_graph_yaml_export_from_yaml_p1_v1.md b/docs/tasks/done/task_engineering_graph_yaml_export_from_yaml_p1_v1.md index 6d0e6365..d9834ceb 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_export_from_yaml_p1_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_export_from_yaml_p1_v1.md @@ -22,6 +22,8 @@ | **freeze_id** | `GRAPH-YAML-EXPORT-YAML-P1` | | **epic** | 图谱 YAML 迁移 · 续(Inform 闭环) | | **blocked_by** | P0 done + **P0 PR CI 绿 + merge** | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_engineering_graph_yaml_migration_epic_v1.md b/docs/tasks/done/task_engineering_graph_yaml_migration_epic_v1.md index 5171272c..a84c5bff 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_migration_epic_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_migration_epic_v1.md @@ -18,6 +18,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_p0_00_main_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p0_00_main_v1.md index 5fd0aa56..00a22574 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p0_00_main_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p0_00_main_v1.md @@ -25,6 +25,8 @@ | **kpi_aggregator** | `CLOSE` | | **experience_capture** | `recommended` | | **freeze_id** | (30 完成后填,如 `GRAPH_YAML_P0_FREEZE_YYYYMMDD`) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_engineering_graph_yaml_p1_10_flow_rag_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p1_10_flow_rag_v1.md index 01d33d1e..0e3b5aba 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p1_10_flow_rag_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p1_10_flow_rag_v1.md @@ -24,6 +24,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_p2_11_flow_text2sql_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p2_11_flow_text2sql_v1.md index c526a732..812e9508 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p2_11_flow_text2sql_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p2_11_flow_text2sql_v1.md @@ -24,6 +24,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_p3a_12_flow_fts_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p3a_12_flow_fts_v1.md index 4715a254..d5817322 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p3a_12_flow_fts_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p3a_12_flow_fts_v1.md @@ -24,6 +24,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_p3b_13_flow_supabase_rpc_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p3b_13_flow_supabase_rpc_v1.md index 28b897a2..8640e0ca 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p3b_13_flow_supabase_rpc_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p3b_13_flow_supabase_rpc_v1.md @@ -24,6 +24,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_p4_14_runtime_observability_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p4_14_runtime_observability_v1.md index dbc2a140..5c65a49e 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p4_14_runtime_observability_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p4_14_runtime_observability_v1.md @@ -24,6 +24,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_p5_15_e2e_boundary_v1.md b/docs/tasks/done/task_engineering_graph_yaml_p5_15_e2e_boundary_v1.md index 09966bff..a4a91ae8 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_p5_15_e2e_boundary_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_p5_15_e2e_boundary_v1.md @@ -24,6 +24,8 @@ | **experience_capture** | `required` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_engineering_graph_yaml_post_epic_fix_v1.md b/docs/tasks/done/task_engineering_graph_yaml_post_epic_fix_v1.md index df09ab19..3e1e4556 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_post_epic_fix_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_post_epic_fix_v1.md @@ -20,6 +20,8 @@ | **git_branch** | `task/graph-yaml-post-epic-fix` | | **worktree_root** | `ai-ink-brain-api-python/` | | **freeze_id** | `GRAPH-YAML-POST-EPIC-FIX` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_engineering_graph_yaml_remove_ai_md_v1.md b/docs/tasks/done/task_engineering_graph_yaml_remove_ai_md_v1.md index f1929059..d418fbb6 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_remove_ai_md_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_remove_ai_md_v1.md @@ -20,6 +20,8 @@ | **worktree_root** | `ai-ink-brain-api-python/` | | **freeze_id** | `GRAPH-YAML-REMOVE-AI-MD` | | **epic** | 图谱 YAML 迁移 · G0 后继 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_engineering_graph_yaml_subgraph_nit_v1.md b/docs/tasks/done/task_engineering_graph_yaml_subgraph_nit_v1.md index 2a04d6f2..370d2664 100644 --- a/docs/tasks/done/task_engineering_graph_yaml_subgraph_nit_v1.md +++ b/docs/tasks/done/task_engineering_graph_yaml_subgraph_nit_v1.md @@ -19,6 +19,8 @@ | **git_branch** | `task/graph-yaml-subgraph-nit` | | **worktree_root** | `ai-ink-brain-api-python/` | | **freeze_id** | `GRAPH-YAML-SUBGRAPH-NIT` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md b/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md index 574a7e1b..2df66a03 100644 --- a/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_gate_a_perf_compare_v1.md @@ -1,5 +1,13 @@ # Task:闸口 A — 静态 `graph.json` vs Mermaid 语料(代号 A/B)性能对比(后端主导 · v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-15 验收通过)` > **关联规划**:`docs/tech_graph/改进方向.md`(闸口 A / 极低 token 叙事);`docs/tech_graph/SPEC/json_graph/scheme_1_graph_json.md` > **父文档(真值口径)**:`ai-ink-brain-api-python/docs/tech_graph/gate_a_scheme1_backend.md` — **「下一阶段:静态 graph.json vs 旧 Mermaid — 初步对比方案(v0)」**(§2 代号 A/B、§3 指标表、§3.1 后端子表;**§3.2 浏览器**默认 **N/A** 于主结论,见父文档「结论」主口径) diff --git a/docs/tasks/done/task_engineering_tech_graph_gate_a_token_compare_v1.md b/docs/tasks/done/task_engineering_tech_graph_gate_a_token_compare_v1.md index 5a32514a..e2490d68 100644 --- a/docs/tasks/done/task_engineering_tech_graph_gate_a_token_compare_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_gate_a_token_compare_v1.md @@ -1,5 +1,13 @@ # Task:闸口 A 附录 — `graph.json` vs Mermaid 拼接体 **token 粗估** 工具与 CI +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-15 验收通过)` > **关联**:`docs/tech_graph/gate_a_scheme1_backend.md` §3「Agent / LM context(可选)」;[`gate_a_scheme1_perf_compare_backend_detail.md`](../../tech_graph/gate_a_scheme1_perf_compare_backend_detail.md) > **test_strategy**:`required` diff --git a/docs/tasks/done/task_engineering_tech_graph_gate_c_double_prime_v1.md b/docs/tasks/done/task_engineering_tech_graph_gate_c_double_prime_v1.md index f8c4ec00..fb56566c 100644 --- a/docs/tasks/done/task_engineering_tech_graph_gate_c_double_prime_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_gate_c_double_prime_v1.md @@ -1,5 +1,13 @@ # Task:闸口 C″ — 分题物化修补 T003 impact(graph_v2 查询轨 · 实验先行) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-20 · 闸口 C″ T003 物化收口 · HG-AUDIT-CLOSE 人签 · PR #38)` > **结论(accepted)**:`docs/diary/jsonPKmermaid/reports/conclusion_gate_c_double_prime_v1_zh.md` > **50 关账审查**:`docs/harness/reviews/task_engineering_tech_graph_gate_c_double_prime_v1_audit_CLOSE_20260520.md` diff --git a/docs/tasks/done/task_engineering_tech_graph_gate_c_prime_f1_v1.md b/docs/tasks/done/task_engineering_tech_graph_gate_c_prime_f1_v1.md index 48a4cc32..558e10aa 100644 --- a/docs/tasks/done/task_engineering_tech_graph_gate_c_prime_f1_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_gate_c_prime_f1_v1.md @@ -1,5 +1,13 @@ # Task:闸口 C′ — graph_v2 查询轨 impact F1 提升与对照重跑 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-20 · 闸口 C′ F1 物化增强收口 · HG-GATE-C-PRIME-SIGNOFF 人签)` > **结论(accepted)**:`docs/diary/jsonPKmermaid/reports/conclusion_gate_c_prime_f1_v1_zh.md` > **前置 task(done)**:`docs/tasks/done/task_engineering_tech_graph_v2_query_coverage_v1.md`(`graph_v2_freeze_id` `V2_3` · T002 union 物化) diff --git a/docs/tasks/done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md b/docs/tasks/done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md index af17d2e2..aea591a3 100644 --- a/docs/tasks/done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md @@ -1,5 +1,13 @@ # Task:技术图谱 — 闸口 C 对比实验(graph_v2 查询轨 vs 双轨原文) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-18 · 闸口 C 实验收口 · 50 关账)` > **P2 结论(accepted)**:`docs/diary/jsonPKmermaid/reports/conclusion_gate_c_v2_dual_track_v1_zh.md` > **前置 task(done)**:`docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md`(闸口 B · `CTX_QUERY`) diff --git a/docs/tasks/done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md b/docs/tasks/done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md index 6e97e09a..e3fa4902 100644 --- a/docs/tasks/done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_gate_d_v2_tasks_v1.md @@ -1,5 +1,13 @@ # Task:闸口 D — `gate_ctx_ab_v2` 题集扩域(v1 三题 + T004/T005) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-21 · 闸口 D v2 五题扩域 · HG-GATE-D-SIGNOFF 人签 · PR #41 · merge abb08f4)` > **结论(accepted)**:`docs/diary/jsonPKmermaid/reports/conclusion_gate_d_ctx_v2_tasks_v1_zh.md` > **50 关账复检**:`docs/harness/reviews/task_engineering_tech_graph_gate_d_v2_tasks_v1_reinspect_R1_20260521.md` diff --git a/docs/tasks/done/task_engineering_tech_graph_graph_json_export_v1.md b/docs/tasks/done/task_engineering_tech_graph_graph_json_export_v1.md index c73f827a..93358a61 100644 --- a/docs/tasks/done/task_engineering_tech_graph_graph_json_export_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_graph_json_export_v1.md @@ -1,5 +1,13 @@ # Task:技术图谱 — 方案1 静态 `graph.json` 导出与 CI 门禁(后端仓) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-15 验收通过)` > **关联规划**:`docs/tech_graph/改进方向.md` **v1.1.3**(含 **2026-05-15** 勘误行:R1 与 scheme_1「PR 必绿」一致);`docs/tech_graph/SPEC/json_graph/scheme_1_graph_json.md` > **invoke_snapshot**:`docs/tech_graph/invokes/invoke_20260514_0000_10_tech-graph-scheme1-dual-task-draft.md`;`docs/harness/invokes/invoke_20260514_0031_10_tech-graph-scheme1-exec-converge.md`;`docs/harness/invokes/invoke_20260515_0000_10_tech-graph-scheme1-exec-converge-hat10.md`(链:`docs/harness/invokes/invoke_20260514_20_tech-graph-scheme1-review-hat20.md`) diff --git a/docs/tasks/done/task_engineering_tech_graph_scheme2_completion_v1.md b/docs/tasks/done/task_engineering_tech_graph_scheme2_completion_v1.md index a4798170..d9c2a8af 100644 --- a/docs/tasks/done/task_engineering_tech_graph_scheme2_completion_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_scheme2_completion_v1.md @@ -1,5 +1,13 @@ # Task:技术图谱 — 方案2 补全(API 缺口 + 文档对齐 + 可选 MCP/Harness) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-18 验收通过 · PR #31 merged)` > **终轮审查**:`docs/harness/reviews/task_engineering_tech_graph_scheme2_completion_v1_audit_CLOSE_20260518.md` > **前置 task(done)**:`docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md`(P2-0~P2-3 · **方案2 核心** + 闸口 B 已签收) diff --git a/docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md b/docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md index f12dee4d..ff765f4a 100644 --- a/docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md @@ -1,5 +1,13 @@ # Task:技术图谱 — 机器轨升级(graph_v2 + 方案2 图查询 + 闸口 B) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-17 验收通过)` > **终轮审查**:`docs/harness/reviews/by-task/engineering_tech_graph_v2_graph_query_v1/task_engineering_tech_graph_v2_graph_query_v1_audit_CLOSE_20260517.md` > **关联规划**:`docs/tech_graph/改进方向.md` **v1.1.3**;`docs/tech_graph/SPEC/json_graph/scheme_1_graph_json.md`;`docs/tech_graph/SPEC/query_graph/scheme_2_graph_query.md` diff --git a/docs/tasks/done/task_engineering_tech_graph_v2_p4_extended_v1.md b/docs/tasks/done/task_engineering_tech_graph_v2_p4_extended_v1.md index 308daee8..07d3802e 100644 --- a/docs/tasks/done/task_engineering_tech_graph_v2_p4_extended_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_v2_p4_extended_v1.md @@ -1,5 +1,13 @@ # Task:技术图谱 — graph_v2 扩展(P2-4)与闸口 B follow-up 切片 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-17 · P2-4a 验收通过)` > **终轮审查**:`docs/harness/reviews/by-task/engineering_tech_graph_v2_p4_extended_v1/task_engineering_tech_graph_v2_p4_extended_v1_audit_CLOSE_20260517.md` > **关闭回溯**:见终轮审查 **「执行路线与 Commit 回溯」** diff --git a/docs/tasks/done/task_engineering_tech_graph_v2_query_coverage_v1.md b/docs/tasks/done/task_engineering_tech_graph_v2_query_coverage_v1.md index 83d592f0..4fc7723e 100644 --- a/docs/tasks/done/task_engineering_tech_graph_v2_query_coverage_v1.md +++ b/docs/tasks/done/task_engineering_tech_graph_v2_query_coverage_v1.md @@ -1,5 +1,13 @@ # Task:技术图谱 — graph_v2 查询可达性优化(闸口 C follow-up) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done(2026-05-19 · graph_v2 查询可达性 follow-up · 50 关账)` > **前置 task(done)**:`docs/tasks/done/task_engineering_tech_graph_gate_c_v2_dual_track_v1.md`(闸口 C · accepted) > **前置 task(done)**:`docs/tasks/done/task_engineering_tech_graph_v2_graph_query_v1.md`(闸口 B · CTX_QUERY 默认) diff --git a/docs/tasks/done/task_gov_docs_noise_p0_readme_v1.md b/docs/tasks/done/task_gov_docs_noise_p0_readme_v1.md index ffd288fd..042bd512 100644 --- a/docs/tasks/done/task_gov_docs_noise_p0_readme_v1.md +++ b/docs/tasks/done/task_gov_docs_noise_p0_readme_v1.md @@ -27,6 +27,8 @@ | **close_action** | `merge` — CI Required 全绿后 **00/CLOSE 可执行** `gh pr merge --squash`(本 task 授权 · [#121](https://github.com/Cyning12/ai-ink-brain-api-python/pull/121)) | | **experience_capture** | `recommended` | | **experience_capture_note** | 执行简报已落盘 diary;关账后可蒸馏 Task 链 PROMPT 惯例 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_gov_docs_noise_p1_archived_v1.md b/docs/tasks/done/task_gov_docs_noise_p1_archived_v1.md index 9755fd0b..9a8b2242 100644 --- a/docs/tasks/done/task_gov_docs_noise_p1_archived_v1.md +++ b/docs/tasks/done/task_gov_docs_noise_p1_archived_v1.md @@ -29,6 +29,8 @@ | **close_action** | `merge` — CI Required 全绿后 **00/CLOSE 可执行** `gh pr merge --squash` | | **experience_capture** | `recommended` | | **experience_capture_note** | 执行简报落盘 diary;关账后可蒸馏 Claude Task 链 PROMPT 惯例 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_gov_docs_noise_p2_readorder_v1.md b/docs/tasks/done/task_gov_docs_noise_p2_readorder_v1.md index f963c32a..a0937b7c 100644 --- a/docs/tasks/done/task_gov_docs_noise_p2_readorder_v1.md +++ b/docs/tasks/done/task_gov_docs_noise_p2_readorder_v1.md @@ -28,6 +28,8 @@ | **close_action** | `merge` — CI Required 全绿后 **00/CLOSE 可执行** `gh pr merge --squash` | | **experience_capture** | `recommended` | | **experience_capture_note** | 执行简报落盘 diary;关账后可蒸馏 P2 PROMPT 惯例 | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_gov_docs_noise_p3_index_v1.md b/docs/tasks/done/task_gov_docs_noise_p3_index_v1.md index db2ea829..f5f58635 100644 --- a/docs/tasks/done/task_gov_docs_noise_p3_index_v1.md +++ b/docs/tasks/done/task_gov_docs_noise_p3_index_v1.md @@ -29,6 +29,8 @@ | **close_action** | `merge` — CI Required 全绿后 **00/CLOSE 可执行** `gh pr merge --squash` | | **experience_capture** | `recommended` | | **experience_capture_note** | 执行简报落盘 diary;治理线 docs-noise 全量 CLOSE 后可蒸馏整条线 PROMPT 惯例 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_docs_noise_line_manifest_v1.md b/docs/tasks/done/task_governance_docs_noise_line_manifest_v1.md index ae4b837a..135d21da 100644 --- a/docs/tasks/done/task_governance_docs_noise_line_manifest_v1.md +++ b/docs/tasks/done/task_governance_docs_noise_line_manifest_v1.md @@ -16,6 +16,8 @@ | **git_branch(当前子批)** | `—`(母单已 CLOSE) | | **Open Folder** | `ai-ink-brain-api-python` | | **test_strategy** | `not_applicable`(母单本身无实现) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_governance_kimi_harness_pilot_recentsync_v1.md b/docs/tasks/done/task_governance_kimi_harness_pilot_recentsync_v1.md index 2989efe0..fe96993b 100644 --- a/docs/tasks/done/task_governance_kimi_harness_pilot_recentsync_v1.md +++ b/docs/tasks/done/task_governance_kimi_harness_pilot_recentsync_v1.md @@ -27,6 +27,8 @@ | **kpi_aggregator** | `CLOSE` | | **experience_capture** | `required` | | **experience_capture_note** | 关账已落盘 [`docs/diary/2026-06-08-kimi-harness-pilot-recentsync_zh.md`](../../diary/2026-06-08-kimi-harness-pilot-recentsync_zh.md) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_l2_manifest_ci_v1.md b/docs/tasks/done/task_governance_l2_manifest_ci_v1.md index 15b572c4..ac64cb72 100644 --- a/docs/tasks/done/task_governance_l2_manifest_ci_v1.md +++ b/docs/tasks/done/task_governance_l2_manifest_ci_v1.md @@ -20,6 +20,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-l2-manifest-ci-v1` | | **task_slug** | `gov-l2-manifest-ci` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_l2_phase_c_design_v1.md b/docs/tasks/done/task_governance_l2_phase_c_design_v1.md index 40d93280..41d25683 100644 --- a/docs/tasks/done/task_governance_l2_phase_c_design_v1.md +++ b/docs/tasks/done/task_governance_l2_phase_c_design_v1.md @@ -16,6 +16,8 @@ | **semi_auto** | `true` | | **git_branch** | `task/wiki-loop-p2-followup-v1` | | **task_slug** | `gov-l2-phase-c-design` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_governance_l2_phase_c_impl_v1.md b/docs/tasks/done/task_governance_l2_phase_c_impl_v1.md index 62cc12cf..1de3f5e6 100644 --- a/docs/tasks/done/task_governance_l2_phase_c_impl_v1.md +++ b/docs/tasks/done/task_governance_l2_phase_c_impl_v1.md @@ -21,6 +21,8 @@ | **git_branch** | `task/wiki-unit-ab-plan-v1` | | **task_slug** | `gov-l2-phase-c-impl` | | **executor** | `claude-code` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_l2_r3_test_manifest_v1.md b/docs/tasks/done/task_governance_l2_r3_test_manifest_v1.md index 4d3a6f62..d96761ff 100644 --- a/docs/tasks/done/task_governance_l2_r3_test_manifest_v1.md +++ b/docs/tasks/done/task_governance_l2_r3_test_manifest_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-spec-t4-l2-v1` | | **task_slug** | `gov-l2-r3-test-manifest` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md b/docs/tasks/done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md index b7abebc6..9b7b9c67 100644 --- a/docs/tasks/done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md +++ b/docs/tasks/done/task_governance_loop_c2_verify_r1_schedule_draft_v1.md @@ -18,6 +18,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-c2-verify-v1` | | **task_slug** | `wiki-c2-r1-schedule-draft` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_loop_c2_verify_r2_index_sync_v1.md b/docs/tasks/done/task_governance_loop_c2_verify_r2_index_sync_v1.md index 24244155..15e5758f 100644 --- a/docs/tasks/done/task_governance_loop_c2_verify_r2_index_sync_v1.md +++ b/docs/tasks/done/task_governance_loop_c2_verify_r2_index_sync_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-c2-verify-v1` | | **task_slug** | `wiki-c2-r2-index-sync` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_recent_schedule_wiki_sync_v1.md b/docs/tasks/done/task_governance_recent_schedule_wiki_sync_v1.md index 2acd9a6f..bbab566c 100644 --- a/docs/tasks/done/task_governance_recent_schedule_wiki_sync_v1.md +++ b/docs/tasks/done/task_governance_recent_schedule_wiki_sync_v1.md @@ -21,6 +21,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-a1-a4-v1` | | **task_slug** | `wiki-a4-recent-schedule` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_t4_spec_active_v1.md b/docs/tasks/done/task_governance_t4_spec_active_v1.md index a14bbb0f..131016e2 100644 --- a/docs/tasks/done/task_governance_t4_spec_active_v1.md +++ b/docs/tasks/done/task_governance_t4_spec_active_v1.md @@ -16,6 +16,8 @@ | **semi_auto** | `true` | | **git_branch** | `task/wiki-loop-p2-followup-v1` | | **task_slug** | `gov-t4-spec-active` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_governance_task_schedule_wiki_bridge_v1.md b/docs/tasks/done/task_governance_task_schedule_wiki_bridge_v1.md index c05d6b0a..fb6ed169 100644 --- a/docs/tasks/done/task_governance_task_schedule_wiki_bridge_v1.md +++ b/docs/tasks/done/task_governance_task_schedule_wiki_bridge_v1.md @@ -19,6 +19,8 @@ | **task_slug** | `gov-task-schedule-wiki-bridge` | | **schedule_ref** | RECENT §0 · 排期桥接优先于 V3 P2-1b | | **epic** | 治理 · Wiki / 排期 hygiene | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md b/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md index 6f184ebd..0e581cfb 100644 --- a/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md +++ b/docs/tasks/done/task_governance_tasks_done_index_hygiene_v1.md @@ -34,6 +34,8 @@ | **epic** | `治理 · docs/tasks 索引卫生` | | **blocked_by** | RECENT 治理/backlog 锚点;编码规范 Epic CLOSE(W1~W8 done) | | **blocks** | 后续 `docs/tasks/done//` 物理迁移子 task(P1) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_agent_readorder_v1.md b/docs/tasks/done/task_governance_wiki_agent_readorder_v1.md index af2308ba..76472618 100644 --- a/docs/tasks/done/task_governance_wiki_agent_readorder_v1.md +++ b/docs/tasks/done/task_governance_wiki_agent_readorder_v1.md @@ -20,6 +20,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-wiki-agent-readorder-v1` | | **task_slug** | `gov-wiki-agent-readorder` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_bq3_spec_schedule_sync_v1.md b/docs/tasks/done/task_governance_wiki_bq3_spec_schedule_sync_v1.md index e325f6fa..69e01b64 100644 --- a/docs/tasks/done/task_governance_wiki_bq3_spec_schedule_sync_v1.md +++ b/docs/tasks/done/task_governance_wiki_bq3_spec_schedule_sync_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-bq3-recheck-v1` | | **task_slug** | `wiki-bq3-r3-gov-sync` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_ctx_ab_representative_v1.md b/docs/tasks/done/task_governance_wiki_ctx_ab_representative_v1.md index 2c62b0de..b54cd984 100644 --- a/docs/tasks/done/task_governance_wiki_ctx_ab_representative_v1.md +++ b/docs/tasks/done/task_governance_wiki_ctx_ab_representative_v1.md @@ -20,6 +20,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-ctx-ab-representative-v1` | | **task_slug** | `wiki-ctx-ab-representative` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_docs_hygiene_v1.md b/docs/tasks/done/task_governance_wiki_docs_hygiene_v1.md index 32262452..5c5ca085 100644 --- a/docs/tasks/done/task_governance_wiki_docs_hygiene_v1.md +++ b/docs/tasks/done/task_governance_wiki_docs_hygiene_v1.md @@ -17,6 +17,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-unit-ab-plan-v1` | | **task_slug** | `gov-wiki-docs-hygiene` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_governance_wiki_ingest_batch_2_v1.md b/docs/tasks/done/task_governance_wiki_ingest_batch_2_v1.md index 008893ef..e664543b 100644 --- a/docs/tasks/done/task_governance_wiki_ingest_batch_2_v1.md +++ b/docs/tasks/done/task_governance_wiki_ingest_batch_2_v1.md @@ -16,6 +16,8 @@ | **semi_auto** | `true` | | **git_branch** | `task/wiki-loop-p2-followup-v1` | | **task_slug** | `gov-wiki-ingest-batch-2` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_governance_wiki_ingest_batch_3_v1.md b/docs/tasks/done/task_governance_wiki_ingest_batch_3_v1.md index fb20094a..020b39a5 100644 --- a/docs/tasks/done/task_governance_wiki_ingest_batch_3_v1.md +++ b/docs/tasks/done/task_governance_wiki_ingest_batch_3_v1.md @@ -16,6 +16,8 @@ | **semi_auto** | `true` | | **git_branch** | `task/wiki-unit-ab-plan-v1` | | **task_slug** | `gov-wiki-ingest-batch-3` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_governance_wiki_ingest_batch_v1.md b/docs/tasks/done/task_governance_wiki_ingest_batch_v1.md index cf05075a..d7d74c05 100644 --- a/docs/tasks/done/task_governance_wiki_ingest_batch_v1.md +++ b/docs/tasks/done/task_governance_wiki_ingest_batch_v1.md @@ -20,6 +20,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-wiki-ingest-batch-v1` | | **task_slug** | `gov-wiki-ingest-batch` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_milestone_acceptance_expand_v1.md b/docs/tasks/done/task_governance_wiki_milestone_acceptance_expand_v1.md index f086c82f..0a527e3d 100644 --- a/docs/tasks/done/task_governance_wiki_milestone_acceptance_expand_v1.md +++ b/docs/tasks/done/task_governance_wiki_milestone_acceptance_expand_v1.md @@ -23,6 +23,8 @@ | **git_branch** | `task/gov-wiki-milestone-acceptance-expand-v1` | | **worktree_root** | `../ai-ink-brain-api-python-wt-wiki-accept`(与 P2-1b 并行) | | **task_slug** | `gov-wiki-milestone-acceptance-expand` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_spec_comparison_sync_v1.md b/docs/tasks/done/task_governance_wiki_spec_comparison_sync_v1.md index 727f0038..3a3c104f 100644 --- a/docs/tasks/done/task_governance_wiki_spec_comparison_sync_v1.md +++ b/docs/tasks/done/task_governance_wiki_spec_comparison_sync_v1.md @@ -22,6 +22,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-a1-a4-v1` | | **task_slug** | `wiki-a3-spec-comparison` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_t4_expand_v2.md b/docs/tasks/done/task_governance_wiki_t4_expand_v2.md index 2e910879..28b4e76c 100644 --- a/docs/tasks/done/task_governance_wiki_t4_expand_v2.md +++ b/docs/tasks/done/task_governance_wiki_t4_expand_v2.md @@ -20,6 +20,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-wiki-t4-expand-v1` | | **task_slug** | `gov-wiki-t4-expand` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_t4_ops_v1.md b/docs/tasks/done/task_governance_wiki_t4_ops_v1.md index fa03b136..749869df 100644 --- a/docs/tasks/done/task_governance_wiki_t4_ops_v1.md +++ b/docs/tasks/done/task_governance_wiki_t4_ops_v1.md @@ -22,6 +22,8 @@ | **git_branch** | `task/gov-wiki-t4-ops-v1` | | **task_slug** | `gov-wiki-t4-ops` | | **executor** | `claude-code` 或 Cursor(建议与 Unit A/B 同半自动纪律) | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_t4_r1_pilot_v1.md b/docs/tasks/done/task_governance_wiki_t4_r1_pilot_v1.md index 9dc9df1e..761e11c0 100644 --- a/docs/tasks/done/task_governance_wiki_t4_r1_pilot_v1.md +++ b/docs/tasks/done/task_governance_wiki_t4_r1_pilot_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-spec-t4-l2-v1` | | **task_slug** | `wiki-t4-r1-pilot` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_t4_r2_l0_align_v1.md b/docs/tasks/done/task_governance_wiki_t4_r2_l0_align_v1.md index 73a5f4e3..3d78812e 100644 --- a/docs/tasks/done/task_governance_wiki_t4_r2_l0_align_v1.md +++ b/docs/tasks/done/task_governance_wiki_t4_r2_l0_align_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-spec-t4-l2-v1` | | **task_slug** | `wiki-t4-r2-l0-align` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_governance_wiki_t4_rollout_v1.md b/docs/tasks/done/task_governance_wiki_t4_rollout_v1.md index df78af8b..37732f1e 100644 --- a/docs/tasks/done/task_governance_wiki_t4_rollout_v1.md +++ b/docs/tasks/done/task_governance_wiki_t4_rollout_v1.md @@ -16,6 +16,8 @@ | **semi_auto** | `true` | | **git_branch** | `task/wiki-unit-ab-plan-v1` | | **task_slug** | `gov-wiki-t4-rollout` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_governance_wiki_unit_ab_closeout_v1.md b/docs/tasks/done/task_governance_wiki_unit_ab_closeout_v1.md index a0b93c95..6921ae11 100644 --- a/docs/tasks/done/task_governance_wiki_unit_ab_closeout_v1.md +++ b/docs/tasks/done/task_governance_wiki_unit_ab_closeout_v1.md @@ -22,6 +22,8 @@ | **git_branch** | `task/gov-wiki-unit-ab-closeout-v1` | | **task_slug** | `gov-wiki-unit-ab-closeout` | | **executor** | `claude-code`(建议 · 与 Unit A/B 同平台) | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_chain_orchestration_spec_v1.md b/docs/tasks/done/task_harness_chain_orchestration_spec_v1.md index 1c8195dc..0dfc2612 100644 --- a/docs/tasks/done/task_harness_chain_orchestration_spec_v1.md +++ b/docs/tasks/done/task_harness_chain_orchestration_spec_v1.md @@ -24,6 +24,8 @@ | **kpi_aggregator** | `CLOSE` | | **experience_capture** | `required` | | **experience_capture_note** | 关账后更新 planning diary §5 checklist | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_in_repo_prompts_and_rules_v1.md b/docs/tasks/done/task_harness_in_repo_prompts_and_rules_v1.md index 09bd60fe..a6f3813d 100644 --- a/docs/tasks/done/task_harness_in_repo_prompts_and_rules_v1.md +++ b/docs/tasks/done/task_harness_in_repo_prompts_and_rules_v1.md @@ -1,5 +1,13 @@ # Task:Harness 模板与规则内嵌后端仓(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-05-22 验收通过) > **范围**:仅 `ai-ink-brain-api-python/docs/harness/`、`.cursor/rules/`、`AGENTS.md`、`docs/README.md` > **目标**:后端 **最小 Harness**(10/20/30/40 + HANDOFF);无 `reviews/`、历史 invoke 在 `docs/diary/harness-archive/`。 diff --git a/docs/tasks/done/task_harness_invokes_by_task_prompts_sync_v1.md b/docs/tasks/done/task_harness_invokes_by_task_prompts_sync_v1.md index efe9c837..27922d6a 100644 --- a/docs/tasks/done/task_harness_invokes_by_task_prompts_sync_v1.md +++ b/docs/tasks/done/task_harness_invokes_by_task_prompts_sync_v1.md @@ -17,6 +17,8 @@ | **semi_auto** | `true` | | **git_branch** | `task/harness-invokes-by-task-prompts-sync` | | **freeze_id** | `HARNESS-INVOKES-BY-TASK-PROMPTS@2026-06-02` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_harness_kpi_v1_2_pilot_v1.md b/docs/tasks/done/task_harness_kpi_v1_2_pilot_v1.md index 54e63078..a6a42f1e 100644 --- a/docs/tasks/done/task_harness_kpi_v1_2_pilot_v1.md +++ b/docs/tasks/done/task_harness_kpi_v1_2_pilot_v1.md @@ -12,6 +12,8 @@ | 字段 | 值 | |------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | | **task_slug** | `harness-kpi-v1-2-pilot` | | **test_strategy** | `not_applicable` | | **test_strategy_note** | 纯 Harness 文档与索引;不触达 `api/` / 行为变更 | diff --git a/docs/tasks/done/task_harness_p0_audit_selfcheck_v1.md b/docs/tasks/done/task_harness_p0_audit_selfcheck_v1.md index a22d2d1f..0a9613e4 100644 --- a/docs/tasks/done/task_harness_p0_audit_selfcheck_v1.md +++ b/docs/tasks/done/task_harness_p0_audit_selfcheck_v1.md @@ -18,6 +18,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/harness-p0-openspec-tdd` | | **task_slug** | `p0-audit-selfcheck` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_harness_p0_openspec_tdd_loop_v1.md b/docs/tasks/done/task_harness_p0_openspec_tdd_loop_v1.md index b163ea06..c7adf406 100644 --- a/docs/tasks/done/task_harness_p0_openspec_tdd_loop_v1.md +++ b/docs/tasks/done/task_harness_p0_openspec_tdd_loop_v1.md @@ -23,6 +23,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/harness-p0-openspec-tdd` | | **task_slug** | `p0-openspec-tdd` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_p0_status_cursor_v1.md b/docs/tasks/done/task_harness_p0_status_cursor_v1.md index e68d7824..86d9fc52 100644 --- a/docs/tasks/done/task_harness_p0_status_cursor_v1.md +++ b/docs/tasks/done/task_harness_p0_status_cursor_v1.md @@ -17,6 +17,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/harness-p0-openspec-tdd` | | **task_slug** | `p0-status-cursor` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_harness_p0_task_validate_v1.md b/docs/tasks/done/task_harness_p0_task_validate_v1.md index 5122a1d1..8609629d 100644 --- a/docs/tasks/done/task_harness_p0_task_validate_v1.md +++ b/docs/tasks/done/task_harness_p0_task_validate_v1.md @@ -17,6 +17,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/harness-p0-openspec-tdd` | | **task_slug** | `p0-task-validate` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | | human_gate_id | status | blocks_hats | 说明 | |---------------|--------|-------------|------| diff --git a/docs/tasks/done/task_harness_p1_docs_consolidation_v1.md b/docs/tasks/done/task_harness_p1_docs_consolidation_v1.md index 6e8fae8b..23162f01 100644 --- a/docs/tasks/done/task_harness_p1_docs_consolidation_v1.md +++ b/docs/tasks/done/task_harness_p1_docs_consolidation_v1.md @@ -21,6 +21,8 @@ | **semi_auto** | `true` | | **audit_profile** | `post_close` | | **git_branch** | `task/harness-p1-docs-consolidation` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_semi_auto_retirement_manifest_v1.md b/docs/tasks/done/task_harness_semi_auto_retirement_manifest_v1.md index e4af438f..d0f5f126 100644 --- a/docs/tasks/done/task_harness_semi_auto_retirement_manifest_v1.md +++ b/docs/tasks/done/task_harness_semi_auto_retirement_manifest_v1.md @@ -16,6 +16,8 @@ | **orchestration** | **MANIFEST 仅** — 子批各自 Lead + `PROMPT_*_chain_serial_*` | | **test_strategy** | `not_applicable`(母单无实现) | | **git_branch** | `—`(子批各自分支) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_harness_semi_auto_retirement_phase2_v1.md b/docs/tasks/done/task_harness_semi_auto_retirement_phase2_v1.md index bc46c158..598e0603 100644 --- a/docs/tasks/done/task_harness_semi_auto_retirement_phase2_v1.md +++ b/docs/tasks/done/task_harness_semi_auto_retirement_phase2_v1.md @@ -27,6 +27,8 @@ | **kpi_aggregator** | `CLOSE` | | **experience_capture** | `required` | | **experience_capture_note** | 关账后更新 RECENT §1.4 与 MANIFEST Phase 2 行 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_theory_align_p0_v1.md b/docs/tasks/done/task_harness_theory_align_p0_v1.md index caf25bcf..83cc5ecf 100644 --- a/docs/tasks/done/task_harness_theory_align_p0_v1.md +++ b/docs/tasks/done/task_harness_theory_align_p0_v1.md @@ -17,6 +17,8 @@ | **semi_auto** | `true` | | **audit_profile** | `post_close` | | **git_branch** | `task/harness-theory-align-p0` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_theory_align_p1_v1.md b/docs/tasks/done/task_harness_theory_align_p1_v1.md index c241ca1a..720f1c53 100644 --- a/docs/tasks/done/task_harness_theory_align_p1_v1.md +++ b/docs/tasks/done/task_harness_theory_align_p1_v1.md @@ -16,6 +16,8 @@ | **audit_profile** | `full` | | **git_branch** | `task/harness-theory-align-p1` | | **linter_target** | **候选 C** — 结构化错误响应 `ok` / `error_code` / `message` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_upgrade_2.19.0.md b/docs/tasks/done/task_harness_upgrade_2.19.0.md new file mode 100644 index 00000000..00a2125e --- /dev/null +++ b/docs/tasks/done/task_harness_upgrade_2.19.0.md @@ -0,0 +1,110 @@ +# Task:Harness 升级至 2.19.0 · lint-wiki-delta + +> **状态**:`completed` +> **类型**:基础设施(过程轨 upgrade + 文档对齐) +> **关联**:npm `@cyning/harness@2.19.0` · `task lint-wiki-delta` · 前置 `task/harness-upgrade-2-18-migrate`(PR #238) +> **Open Folder**:`ai-ink-brain-api-python/` + +--- + +## Harness 元信息 + +| 字段 | 值 | +| --- | --- | +| **task_slug** | `harness-upgrade-2.19.0` | +| **git_branch** | `task/harness-upgrade-2-19-0` | +| **graph_change_layer** | `none` | +| **graph_delta** | `none` | +| **graph_delta_note** | 仅过程轨 / 钉版本 / 文档;不改业务图谱 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 本波只升版本 + lint-wiki-delta;未改 `docs/coding_wiki/`(RUNBOOK POINTER 落在 `docs/harness/`) | +| **review_hat** | `20` | +| **thinking_profile** | `shortest` | +| **invoke_retention_profile** | `minimal` | +| **required_invoke_hats** | `30` | +| **experience_capture** | `recommended` | +| **test_strategy** | `recommended` | +| **test_strategy_note** | `upgrade --yes`;`check`;`task lint-wiki-delta --scope all`;`ruff` / `pytest`(本仓惯例) | +| **code_quality_bar** | `not_applicable` | +| **freeze_id** | `HARNESS-UPGRADE-2.19.0@2026-07-28` | +| **kpi_rubric** | `KPI_RUBRIC_v1_2` | +| **kpi_aggregator** | `CLOSE` | +| **orchestration** | Cursor Agent · 棒 A 升级 | + +### 人工闸 + +| human_gate_id | status | blocks_hats | 说明 | +| --- | --- | --- | --- | +| **HG-GRAPH-MODULES** | approved | **30** | 00 代签:仅过程轨,不改模块边界 | +| **HG-TASK-DRAFT** | approved | 22-R1 | 维护者:升 2.19.0 + 字段扫描 + overlay | +| **HG-AUDIT-R1** | approved | **30** | 00 代签:无业务 API 变更 | + +--- + +## 背景与目标 + +在已钉 `@cyning/harness@2.18.0` 且存量 `wiki_delta` 已补的前提下,一把升到 **2.19.0**,跑 `task lint-wiki-delta --scope all`,恢复 upgrade 冲掉的 overlay,跑本仓质量门。 + +**完成态**: + +- [x] `upgrade --yes --target .`(不带 `--ide`)→ manifest **2.19.0** +- [x] overlay 恢复(AGENTS / CLAUDE / FRAGMENT_30 / `06-harness-pointer` / `11-coding-wiki-readorder` / prompts README) +- [x] `check` → 已是最新 +- [x] `lint-wiki-delta --scope all` → missing=0 · PASS(补齐 10 个遗漏归档/PROMPT/RUNBOOK) +- [x] `harness.pin.json` → 2.19.0 +- [x] 拷贝 RUNBOOK POINTER 至 `docs/harness/`(**未**覆盖 `docs/coding_wiki/`) +- [x] ruff / pytest 质量门(见 invoke) + +**不做**:用 ops-desk 模板覆盖 `coding_wiki`;改 `profile.wiki=true`;关闭其它 active 业务 task;默认 `--allow-wiki-gap` + +--- + +## 失败路径 + +| 触发条件 | 系统行为 | 可重试 | 用户可见 | +| --- | --- | --- | --- | +| lint-wiki-delta missing>0 | 补 `wiki_delta` 后再关 | 是 | CLI FAIL | +| upgrade 冲 overlay | 从升级前快照恢复 | 是 | diff 可见 | +| pytest 预存红(非本波) | 记摩擦,不改业务 API | 视情况 | CI | + +--- + +## 验收标准 + +- [x] manifest / pin = `2.19.0` · `check` 已是最新 +- [x] `lint-wiki-delta --scope all` PASS · missing=0 +- [x] overlay 与升级前一致(AGENTS harness 段 · FRAGMENT · wiki 读序规则) +- [x] `docs/coding_wiki/` **无**本波 diff +- [x] 仅本 upgrade task 走 `task close --file … --yes`(禁止 `--target .`) + +--- + +### 自检结论(执行者) + +| 项 | 内容 | +| --- | --- | +| **日期** | 2026-07-28 | +| **结论** | **PASS · 建议 CLOSE + PR** | +| **manifest** | `2.19.0`(from `2.18.0`) | +| **lint-wiki-delta** | scanned=197 · missing=0 · PASS | +| **coding_wiki** | 未改动 | + +### 经验总结 + +- 每次 `upgrade` 后必 diff 并恢复 AGENTS / FRAGMENT / Cursor 规则 overlay。 +- `lint-wiki-delta --scope all` 会扫到 `done_*` / `*_AGENT_PROMPT` / `*_RUNBOOK` / `Task 04.md` 等非标准名;缺字段须补,勿假设仅 `task_*.md`。 +- `task close` 的 `--target` 是归档目标路径,**不是**仓根;关账用 `--file --yes`。 + +### KPI + +| 项 | 分 | +| --- | --- | +| Task_KPI% | 100 | + +## CLOSE + +| 项 | 内容 | +| --- | --- | +| **日期** | 2026-07-28 | +| **PR** | [#239](https://github.com/Cyning12/ai-ink-brain-api-python/pull/239) | +| **manifest** | `2.19.0` | diff --git a/docs/tasks/done/task_harness_wiki_loop_a1_a4_v1.md b/docs/tasks/done/task_harness_wiki_loop_a1_a4_v1.md index 2ef46cd4..83361635 100644 --- a/docs/tasks/done/task_harness_wiki_loop_a1_a4_v1.md +++ b/docs/tasks/done/task_harness_wiki_loop_a1_a4_v1.md @@ -23,6 +23,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-a1-a4-v1` | | **task_slug** | `wiki-loop-a1-a4` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_wiki_loop_bq3_recheck_v1.md b/docs/tasks/done/task_harness_wiki_loop_bq3_recheck_v1.md index 403f4c26..6e97265e 100644 --- a/docs/tasks/done/task_harness_wiki_loop_bq3_recheck_v1.md +++ b/docs/tasks/done/task_harness_wiki_loop_bq3_recheck_v1.md @@ -23,6 +23,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-bq3-recheck-v1` | | **task_slug** | `wiki-loop-bq3-recheck` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_wiki_loop_c2_verify_v1.md b/docs/tasks/done/task_harness_wiki_loop_c2_verify_v1.md index a662463f..7f9bf561 100644 --- a/docs/tasks/done/task_harness_wiki_loop_c2_verify_v1.md +++ b/docs/tasks/done/task_harness_wiki_loop_c2_verify_v1.md @@ -22,6 +22,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-c2-verify-v1` | | **task_slug** | `wiki-loop-c2-verify` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_wiki_loop_p2_followup_v1.md b/docs/tasks/done/task_harness_wiki_loop_p2_followup_v1.md index 23abe6a7..7b349d63 100644 --- a/docs/tasks/done/task_harness_wiki_loop_p2_followup_v1.md +++ b/docs/tasks/done/task_harness_wiki_loop_p2_followup_v1.md @@ -22,6 +22,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-p2-followup-v1` | | **task_slug** | `wiki-loop-p2-followup` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_wiki_loop_t4_l2_v1.md b/docs/tasks/done/task_harness_wiki_loop_t4_l2_v1.md index 753c11e8..d6f889b5 100644 --- a/docs/tasks/done/task_harness_wiki_loop_t4_l2_v1.md +++ b/docs/tasks/done/task_harness_wiki_loop_t4_l2_v1.md @@ -23,6 +23,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/gov-spec-t4-l2-v1` | | **task_slug** | `wiki-loop-t4-l2` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_wiki_loop_unit_a_v1.md b/docs/tasks/done/task_harness_wiki_loop_unit_a_v1.md index 2f25e524..f3f9e5aa 100644 --- a/docs/tasks/done/task_harness_wiki_loop_unit_a_v1.md +++ b/docs/tasks/done/task_harness_wiki_loop_unit_a_v1.md @@ -22,6 +22,8 @@ | **git_branch** | `task/wiki-unit-ab-plan-v1` | | **task_slug** | `wiki-loop-unit-a` | | **executor** | `claude-code`(关账后见 §SKILL 测评) | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_harness_workspace_taxonomy_promote_v1.md b/docs/tasks/done/task_harness_workspace_taxonomy_promote_v1.md index 993ad42a..2e86dbae 100644 --- a/docs/tasks/done/task_harness_workspace_taxonomy_promote_v1.md +++ b/docs/tasks/done/task_harness_workspace_taxonomy_promote_v1.md @@ -1,5 +1,13 @@ # Pointer · Task:工作区 Harness taxonomy 推广(T3 · v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **类型**:子仓排期索引 · **非执行真值** > **状态**:`done(2026-05-26 关账)` · 工作区真值 > **freeze_id**:`HARNESS-TAXONOMY-T3@2026-05-25` diff --git a/docs/tasks/done/task_intent_router_backend_v1.md b/docs/tasks/done/task_intent_router_backend_v1.md index a1c51c59..a7efca90 100644 --- a/docs/tasks/done/task_intent_router_backend_v1.md +++ b/docs/tasks/done/task_intent_router_backend_v1.md @@ -1,5 +1,13 @@ # Task:Intent Router(后端 v1)— Unified Chat 路由增强(rag/text2sql/no_data/tool) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:**done(核心已落地;2026-05-08 回补 `rag_rule_hits` 与 no_data 门控验收;2026-05-13 自 `docs/tasks/active/` 迁入 `docs/tasks/done/`)** 范围:仅后端 `ai-ink-brain-api-python` 设计:`docs/UI/v1/UI-04-intent-router-v1.md` diff --git a/docs/tasks/done/task_ops_desk_graph_consume_backend_v1.md b/docs/tasks/done/task_ops_desk_graph_consume_backend_v1.md index 11f03db1..107a4697 100644 --- a/docs/tasks/done/task_ops_desk_graph_consume_backend_v1.md +++ b/docs/tasks/done/task_ops_desk_graph_consume_backend_v1.md @@ -1,5 +1,13 @@ # Task · Ops Desk · Graph 矩阵 + graph_analyst 消费层 · 后端 · v1 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`pending` > **Harness 母单**:[`Projects/docs/harness/tasks/active/task_ops_desk_graph_consume_v1.md`](../../../../docs/harness/tasks/active/task_ops_desk_graph_consume_v1.md) > **Open Folder**:**本仓根** `ai-ink-brain-api-python/` diff --git a/docs/tasks/done/task_ops_desk_p0_github_sync_v1.md b/docs/tasks/done/task_ops_desk_p0_github_sync_v1.md index 38743ff6..ed6577f7 100644 --- a/docs/tasks/done/task_ops_desk_p0_github_sync_v1.md +++ b/docs/tasks/done/task_ops_desk_p0_github_sync_v1.md @@ -21,6 +21,8 @@ | **audit_profile** | `full` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_ops_desk_p0_supabase_schema_v1.md b/docs/tasks/done/task_ops_desk_p0_supabase_schema_v1.md index 554a0232..9e5b5bc3 100644 --- a/docs/tasks/done/task_ops_desk_p0_supabase_schema_v1.md +++ b/docs/tasks/done/task_ops_desk_p0_supabase_schema_v1.md @@ -21,6 +21,8 @@ | **audit_profile** | `full` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 diff --git a/docs/tasks/done/task_ops_desk_p1_demo_cache_v1.md b/docs/tasks/done/task_ops_desk_p1_demo_cache_v1.md index 0da271c6..559f161f 100644 --- a/docs/tasks/done/task_ops_desk_p1_demo_cache_v1.md +++ b/docs/tasks/done/task_ops_desk_p1_demo_cache_v1.md @@ -18,6 +18,8 @@ | **git_branch** | `task/ops-desk-p1-demo-cache` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p1_metrics_api_v1.md b/docs/tasks/done/task_ops_desk_p1_metrics_api_v1.md index 22f9fb32..70a57c00 100644 --- a/docs/tasks/done/task_ops_desk_p1_metrics_api_v1.md +++ b/docs/tasks/done/task_ops_desk_p1_metrics_api_v1.md @@ -19,6 +19,8 @@ | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | | **链序** | P1-1 / 3 · **须先于 P1-2、P1-3** | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p1_ops_run_schema_v1.md b/docs/tasks/done/task_ops_desk_p1_ops_run_schema_v1.md index 2dc12326..75ac1201 100644 --- a/docs/tasks/done/task_ops_desk_p1_ops_run_schema_v1.md +++ b/docs/tasks/done/task_ops_desk_p1_ops_run_schema_v1.md @@ -17,6 +17,8 @@ | **freeze_id** | `OPS-DESK-KIMI-CODE-P1-OPS-RUN-SCHEMA` | | **git_branch** | `task/ops-desk-p1-backend-chain` | | **链序** | P1-2 / 3 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p1_orchestrator_core_v1.md b/docs/tasks/done/task_ops_desk_p1_orchestrator_core_v1.md index 33307d3e..a00b7b79 100644 --- a/docs/tasks/done/task_ops_desk_p1_orchestrator_core_v1.md +++ b/docs/tasks/done/task_ops_desk_p1_orchestrator_core_v1.md @@ -18,6 +18,8 @@ | **freeze_id** | `OPS-DESK-KIMI-CODE-P1-ORCHESTRATOR-CORE` | | **git_branch** | `task/ops-desk-p1-backend-chain` | | **链序** | P1-3 / 3 · **本串行链终点** | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_bailian_provider_cache_metrics_v1.md b/docs/tasks/done/task_ops_desk_p2_bailian_provider_cache_metrics_v1.md index fc9e386c..d877d53c 100644 --- a/docs/tasks/done/task_ops_desk_p2_bailian_provider_cache_metrics_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_bailian_provider_cache_metrics_v1.md @@ -15,6 +15,8 @@ | **freeze_id** | `OPS-DESK-KIMI-CODE-P2-BAILIAN-PROVIDER-CACHE-METRICS` | | **git_branch** | `task/ops-desk-p2-bailian-provider-cache-metrics` | | **worktree_root** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_bailian_provider_v1.md b/docs/tasks/done/task_ops_desk_p2_bailian_provider_v1.md index 80f3881e..6b491964 100644 --- a/docs/tasks/done/task_ops_desk_p2_bailian_provider_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_bailian_provider_v1.md @@ -18,6 +18,8 @@ | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | | **human_gate** | run `33d484ea` · D4 bailian · tt=1855 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_graph_tab_backend_v1.md b/docs/tasks/done/task_ops_desk_p2_graph_tab_backend_v1.md index f686ba52..f1db613d 100644 --- a/docs/tasks/done/task_ops_desk_p2_graph_tab_backend_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_graph_tab_backend_v1.md @@ -18,6 +18,8 @@ | **git_branch** | `task/ops-desk-p2-graph-tab-backend` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_langfuse_eval_v1.md b/docs/tasks/done/task_ops_desk_p2_langfuse_eval_v1.md index 5aa6544a..75243d47 100644 --- a/docs/tasks/done/task_ops_desk_p2_langfuse_eval_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_langfuse_eval_v1.md @@ -16,6 +16,8 @@ | **freeze_id** | `OPS-DESK-KIMI-CODE-P2-LANGFUSE-EVAL` | | **git_branch** | `task/ops-desk-p2-langfuse-eval` | | **worktree_root** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_langfuse_trace_redact_v1.md b/docs/tasks/done/task_ops_desk_p2_langfuse_trace_redact_v1.md index d0a301fd..78f9f533 100644 --- a/docs/tasks/done/task_ops_desk_p2_langfuse_trace_redact_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_langfuse_trace_redact_v1.md @@ -19,6 +19,8 @@ | **git_branch** | `fix/ops-desk-p2-langfuse-trace-redact` | | **worktree_root** | `ai-ink-brain-api-python/` | | **human_gate** | 开 `LANGFUSE_TRACING=true` 跑 A4 · Cloud GENERATION input **无** JWT / `supabase_key` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_langfuse_tracing_v1.md b/docs/tasks/done/task_ops_desk_p2_langfuse_tracing_v1.md index d3da381a..5ac97664 100644 --- a/docs/tasks/done/task_ops_desk_p2_langfuse_tracing_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_langfuse_tracing_v1.md @@ -16,6 +16,8 @@ | **git_branch** | `task/ops-desk-p2-langfuse-tracing` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_llm_usage_metrics_v1.md b/docs/tasks/done/task_ops_desk_p2_llm_usage_metrics_v1.md index ae5e75e1..243732fa 100644 --- a/docs/tasks/done/task_ops_desk_p2_llm_usage_metrics_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_llm_usage_metrics_v1.md @@ -18,6 +18,8 @@ | **git_branch** | `task/ops-desk-p2-llm-usage-metrics` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_manual_sync_backend_v1.md b/docs/tasks/done/task_ops_desk_p2_manual_sync_backend_v1.md index 2521ca6c..9d23a523 100644 --- a/docs/tasks/done/task_ops_desk_p2_manual_sync_backend_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_manual_sync_backend_v1.md @@ -17,6 +17,8 @@ | **git_branch** | `task/ops-desk-p2-manual-sync-backend` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_provider_cache_metrics_v1.md b/docs/tasks/done/task_ops_desk_p2_provider_cache_metrics_v1.md index c96bae93..e7dc591e 100644 --- a/docs/tasks/done/task_ops_desk_p2_provider_cache_metrics_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_provider_cache_metrics_v1.md @@ -17,6 +17,8 @@ | **git_branch** | `task/ops-desk-p2-provider-cache-metrics` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_scan_ingest_backend_v1.md b/docs/tasks/done/task_ops_desk_p2_scan_ingest_backend_v1.md index 9df1fc12..f7e0f14f 100644 --- a/docs/tasks/done/task_ops_desk_p2_scan_ingest_backend_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_scan_ingest_backend_v1.md @@ -20,6 +20,8 @@ | **git_branch** | `task/ops-desk-p2-scan-ingest-backend` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p2_thinking_chain_v2_backend_v1.md b/docs/tasks/done/task_ops_desk_p2_thinking_chain_v2_backend_v1.md index f82e019b..8d8020ee 100644 --- a/docs/tasks/done/task_ops_desk_p2_thinking_chain_v2_backend_v1.md +++ b/docs/tasks/done/task_ops_desk_p2_thinking_chain_v2_backend_v1.md @@ -17,6 +17,8 @@ | **git_branch** | `task/ops-desk-p2-thinking-chain-v2-backend` | | **worktree_root** | `ai-ink-brain-api-python/` | | **Open Folder** | `ai-ink-brain-api-python/` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_desk_p3_react_fallback_backend_v1.md b/docs/tasks/done/task_ops_desk_p3_react_fallback_backend_v1.md index dcb12536..aaf29361 100644 --- a/docs/tasks/done/task_ops_desk_p3_react_fallback_backend_v1.md +++ b/docs/tasks/done/task_ops_desk_p3_react_fallback_backend_v1.md @@ -18,6 +18,8 @@ | **git_branch** | `task/ops-desk-p3-react-fallback` | | **worktree_root** | `ai-ink-brain-api-python/` | | **PR** | [#221](https://github.com/Cyning12/ai-ink-brain-api-python/pull/221) · merge `730a3735` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_ops_session_s0_schema_v1.md b/docs/tasks/done/task_ops_session_s0_schema_v1.md index 9a365fa0..90eaf020 100644 --- a/docs/tasks/done/task_ops_session_s0_schema_v1.md +++ b/docs/tasks/done/task_ops_session_s0_schema_v1.md @@ -21,6 +21,8 @@ | **worktree_root** | `ai-ink-brain-api-python/` | | **git_branch** | `task/ops-session-s0-schema` | | **blocks** | S1 `ops-session-s1-multiturn` · S2 `ops-session-s2-langgraph-00` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_ops_session_s1_multiturn_api_v1.md b/docs/tasks/done/task_ops_session_s1_multiturn_api_v1.md index a814560e..f739fd41 100644 --- a/docs/tasks/done/task_ops_session_s1_multiturn_api_v1.md +++ b/docs/tasks/done/task_ops_session_s1_multiturn_api_v1.md @@ -22,6 +22,8 @@ | **test_strategy** | `required` | | **worktree_root** | `ai-ink-brain-api-python/` | | **git_branch** | `task/ops-session-s1-multiturn-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_ops_session_s2_langgraph_00_api_v1.md b/docs/tasks/done/task_ops_session_s2_langgraph_00_api_v1.md index 5ca2d7af..837a5938 100644 --- a/docs/tasks/done/task_ops_session_s2_langgraph_00_api_v1.md +++ b/docs/tasks/done/task_ops_session_s2_langgraph_00_api_v1.md @@ -24,6 +24,8 @@ | **git_branch** | `task/ops-session-s2-langgraph-00-api` | | **blocks** | S3 `ops-session-s3-subagent` | | **blocked_by** | S1 `ops-session-s1-multiturn-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_ops_session_s3_subagent_api_v1.md b/docs/tasks/done/task_ops_session_s3_subagent_api_v1.md index 51dab893..94297834 100644 --- a/docs/tasks/done/task_ops_session_s3_subagent_api_v1.md +++ b/docs/tasks/done/task_ops_session_s3_subagent_api_v1.md @@ -24,6 +24,8 @@ | **git_branch** | `task/ops-session-s3-subagent-api` | | **blocks** | S4 `ops-session-s4-verify` | | **blocked_by** | S2 `ops-session-s2-langgraph-00-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_ops_session_s4_verify_api_v1.md b/docs/tasks/done/task_ops_session_s4_verify_api_v1.md index a6867e1a..d163274b 100644 --- a/docs/tasks/done/task_ops_session_s4_verify_api_v1.md +++ b/docs/tasks/done/task_ops_session_s4_verify_api_v1.md @@ -25,6 +25,8 @@ | **git_branch** | `task/ops-session-s4-verify-api` | | **blocks** | S5 `ops-session-s5-extract` | | **blocked_by** | S3 `ops-session-s3-subagent-api` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | diff --git a/docs/tasks/done/task_portfolio_rag_demo_v1.md b/docs/tasks/done/task_portfolio_rag_demo_v1.md index a24ef080..11cd0e59 100644 --- a/docs/tasks/done/task_portfolio_rag_demo_v1.md +++ b/docs/tasks/done/task_portfolio_rag_demo_v1.md @@ -27,6 +27,8 @@ | **git_branch** | `task/portfolio-rag-w5-v1`(W5 关账 Loop · 自 `task/portfolio-rag-demo-v1` 续跑) | | **Open Folder** | `ai-ink-brain-api-python`(W2/W3 落盘);W5 预跑须开双仓读前端 content / Unified Chat | | **推荐路径** | **A(22 R1)** — 与前端 portfolio task 审查节奏对齐 | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 工作包映射(SPEC §7 → 本 task) diff --git a/docs/tasks/done/task_rag_b1_metadata_structured_recall_v1.md b/docs/tasks/done/task_rag_b1_metadata_structured_recall_v1.md index 330048a6..bc62bfb9 100644 --- a/docs/tasks/done/task_rag_b1_metadata_structured_recall_v1.md +++ b/docs/tasks/done/task_rag_b1_metadata_structured_recall_v1.md @@ -10,6 +10,8 @@ | **test_strategy_note** | legacy 归档消化;正文为历史交付记录,P2 仅补状态与元信息表 | | **semi_auto** | `false` | | **git_branch** | `task/gov-docs-noise-p2-v1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ## 失败路径 diff --git a/docs/tasks/done/task_rag_b2_fts_alias_backfill_v1.md b/docs/tasks/done/task_rag_b2_fts_alias_backfill_v1.md index 1a5a17bd..313dea29 100644 --- a/docs/tasks/done/task_rag_b2_fts_alias_backfill_v1.md +++ b/docs/tasks/done/task_rag_b2_fts_alias_backfill_v1.md @@ -10,6 +10,8 @@ | **test_strategy_note** | legacy 归档消化;正文为历史交付记录,P2 仅补状态与元信息表 | | **semi_auto** | `false` | | **git_branch** | `task/gov-docs-noise-p2-v1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ## 失败路径 diff --git a/docs/tasks/done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md b/docs/tasks/done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md index 17614573..13bb8510 100644 --- a/docs/tasks/done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md +++ b/docs/tasks/done/task_rag_b2_v2_fts_alias_symbols_versions_identifiers.md @@ -10,6 +10,8 @@ | **test_strategy_note** | legacy 归档消化;正文为历史交付记录,P2 仅补状态与元信息表 | | **semi_auto** | `false` | | **git_branch** | `task/gov-docs-noise-p2-v1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ## 失败路径 diff --git a/docs/tasks/done/task_rag_i18n_crosslingual_recall_v1.md b/docs/tasks/done/task_rag_i18n_crosslingual_recall_v1.md index 334946f0..b65bb130 100644 --- a/docs/tasks/done/task_rag_i18n_crosslingual_recall_v1.md +++ b/docs/tasks/done/task_rag_i18n_crosslingual_recall_v1.md @@ -1,5 +1,13 @@ # Task:RAG i18n(跨语言检索)v1|中文查询召回英文内容 +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-24 验收通过) > **关联图谱**:`docs/_tech_graph/10_flow_rag.md`、`docs/_tech_graph/12_flow_fts.md` > **关联 Issue/PR**:无 diff --git a/docs/tasks/done/task_rag_keyword_websearch_date_normalize_v1.md b/docs/tasks/done/task_rag_keyword_websearch_date_normalize_v1.md index afe8f753..de46d455 100644 --- a/docs/tasks/done/task_rag_keyword_websearch_date_normalize_v1.md +++ b/docs/tasks/done/task_rag_keyword_websearch_date_normalize_v1.md @@ -10,6 +10,8 @@ | **test_strategy_note** | legacy 归档消化;正文为历史交付记录,P2 仅补状态与元信息表 | | **semi_auto** | `false` | | **git_branch** | `task/gov-docs-noise-p2-v1` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ## 失败路径 diff --git a/docs/tasks/done/task_standards_backend_api_modularization_manifest_v1.md b/docs/tasks/done/task_standards_backend_api_modularization_manifest_v1.md index b1b6b9f5..bce68a04 100644 --- a/docs/tasks/done/task_standards_backend_api_modularization_manifest_v1.md +++ b/docs/tasks/done/task_standards_backend_api_modularization_manifest_v1.md @@ -20,6 +20,8 @@ | **test_strategy_note** | 母单无代码;子 task 均为 `required` + pytest | | **freeze_id** | `CODING_BACKEND_L2@2026-06-09` | | **git_branch** | `—`(子批各自分支) | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | --- diff --git a/docs/tasks/done/task_standards_backend_l2_draft_v1.md b/docs/tasks/done/task_standards_backend_l2_draft_v1.md index f7214180..706be85f 100644 --- a/docs/tasks/done/task_standards_backend_l2_draft_v1.md +++ b/docs/tasks/done/task_standards_backend_l2_draft_v1.md @@ -27,6 +27,8 @@ | **experience_capture** | `recommended` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_standards_backend_p3_p4_l3_ruff_v1.md b/docs/tasks/done/task_standards_backend_p3_p4_l3_ruff_v1.md index a73a5930..1212418c 100644 --- a/docs/tasks/done/task_standards_backend_p3_p4_l3_ruff_v1.md +++ b/docs/tasks/done/task_standards_backend_p3_p4_l3_ruff_v1.md @@ -28,6 +28,8 @@ | **experience_capture** | `recommended` | | **kpi_rubric** | `KPI_RUBRIC_v1_2` | | **kpi_aggregator** | `CLOSE` | +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_tech_graph_p0_handoff_and_drift_check_v1.md b/docs/tasks/done/task_tech_graph_p0_handoff_and_drift_check_v1.md index bc298f63..e3ad6652 100644 --- a/docs/tasks/done/task_tech_graph_p0_handoff_and_drift_check_v1.md +++ b/docs/tasks/done/task_tech_graph_p0_handoff_and_drift_check_v1.md @@ -1,4 +1,12 @@ # Task:Tech Graph P0 — 可接手性补强 + 最小漂移校验 + +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + > **状态**:done > **关联图谱**:`docs/_tech_graph/00_main.md`、`docs/_tech_graph/01_struct.md`、`docs/_tech_graph/99_spec.md` diff --git a/docs/tasks/done/task_tech_graph_p1_manifest_and_validation_v1.md b/docs/tasks/done/task_tech_graph_p1_manifest_and_validation_v1.md index 7cdefa47..f8ae53ad 100644 --- a/docs/tasks/done/task_tech_graph_p1_manifest_and_validation_v1.md +++ b/docs/tasks/done/task_tech_graph_p1_manifest_and_validation_v1.md @@ -1,5 +1,13 @@ # Task:Tech Graph P1 — 方案A最小落地(manifest + 自动校验) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done > **关联图谱**:`docs/_tech_graph/00_main.ai.md`、`docs/_tech_graph/10_flow_*.ai.md`、`docs/_tech_graph/99_spec.md` > **前端依赖**:无 diff --git a/docs/tasks/done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md b/docs/tasks/done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md index 1597ee5e..0e88055a 100644 --- a/docs/tasks/done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md +++ b/docs/tasks/done/task_tech_graph_p2_layered_views_and_failure_paths_v1.md @@ -1,5 +1,13 @@ # Task:Tech Graph P2 — 分层视角 + 失败路径/排障图(基于 manifest) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done > **关联图谱**:`docs/_tech_graph/00_main.ai.md`、`docs/_tech_graph/10_flow_rag.ai.md`、`docs/_tech_graph/11_flow_text2sql.ai.md`、`docs/_tech_graph/12_flow_fts.ai.md`、`docs/_tech_graph/13_flow_supabase_rpc.ai.md` > **前端依赖**:无 diff --git a/docs/tasks/done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md b/docs/tasks/done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md index 31e4be96..f3f1792c 100644 --- a/docs/tasks/done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md +++ b/docs/tasks/done/task_tech_graph_p3_e2e_boundary_and_contract_v1.md @@ -1,5 +1,13 @@ # Task:Tech Graph P3 — 端到端边界图 + 契约视图(跨仓按需加载) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-27 验收通过) > **范围**:以 `ai-ink-brain-api-python` 为主仓,仅画“跨仓边界与契约”;不改业务代码 > **关联图谱**:`docs/_tech_graph/00_main.ai.md`、`docs/_tech_graph/14_runtime_observability.ai.md`、`docs/_tech_graph/99_spec.md` diff --git a/docs/tasks/done/task_tech_graph_p4_ci_guardrail_v1.md b/docs/tasks/done/task_tech_graph_p4_ci_guardrail_v1.md index 65d67bc0..04c813aa 100644 --- a/docs/tasks/done/task_tech_graph_p4_ci_guardrail_v1.md +++ b/docs/tasks/done/task_tech_graph_p4_ci_guardrail_v1.md @@ -1,5 +1,13 @@ # Task:Tech Graph P4 — CI 门禁(manifest_check 作为必过检查) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-27 验收通过) > **范围**:仅后端仓 `ai-ink-brain-api-python`(不改业务代码) > **关联图谱**:`docs/_tech_graph/_manifest.json`、`docs/_tech_graph/99_spec.md` diff --git a/docs/tasks/done/task_tech_graph_p5_auto_render_from_manifest_v1.md b/docs/tasks/done/task_tech_graph_p5_auto_render_from_manifest_v1.md index 8403de0d..fdbba3b9 100644 --- a/docs/tasks/done/task_tech_graph_p5_auto_render_from_manifest_v1.md +++ b/docs/tasks/done/task_tech_graph_p5_auto_render_from_manifest_v1.md @@ -1,5 +1,13 @@ # Task:Tech Graph P5 — 自动补全/增量渲染(从 manifest 生成 .ai.md 局部) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-27 验收通过) > **范围**:仅后端仓 `ai-ink-brain-api-python`(不改业务代码) > **关联图谱**:`docs/_tech_graph/_manifest.json`、`docs/_tech_graph/00_main.ai.md` diff --git a/docs/tasks/done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md b/docs/tasks/done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md index 1568ec45..9d0cde5d 100644 --- a/docs/tasks/done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md +++ b/docs/tasks/done/task_tech_graph_p6_cross_repo_contract_guardrail_v1.md @@ -1,5 +1,13 @@ # Task:Tech Graph P6 — 跨仓契约 Manifest + Cross-Repo 门禁脚本(SSE/Events) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done > **关联图谱**:`docs/_tech_graph/14_runtime_observability.ai.md`、`docs/_tech_graph/15_e2e_boundary.ai.md` > **前端依赖**:无(不要求改前端代码,但需要读取前端仓文件做校验) diff --git a/docs/tasks/done/task_tech_graph_p7_contract_ci_guardrail_v1.md b/docs/tasks/done/task_tech_graph_p7_contract_ci_guardrail_v1.md index 83191091..26dfa84c 100644 --- a/docs/tasks/done/task_tech_graph_p7_contract_ci_guardrail_v1.md +++ b/docs/tasks/done/task_tech_graph_p7_contract_ci_guardrail_v1.md @@ -1,5 +1,13 @@ # Task:P7 - Cross-Repo Contract Check 接入 CI(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-27 验收通过) > **关联图谱**:`docs/_tech_graph/15_e2e_boundary.ai.md`、`docs/_tech_graph/14_runtime_observability.ai.md` > **关联 Issue/PR**:无 diff --git a/docs/tasks/done/task_text2sql_schema_prefetch_before_mutate_v1.md b/docs/tasks/done/task_text2sql_schema_prefetch_before_mutate_v1.md index 053191aa..d6d2f04b 100644 --- a/docs/tasks/done/task_text2sql_schema_prefetch_before_mutate_v1.md +++ b/docs/tasks/done/task_text2sql_schema_prefetch_before_mutate_v1.md @@ -1,5 +1,13 @@ # Task:Text2SQL — 变更类 SQL 前强制表结构预取(防臆造列名) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:`done`(**2026-05-13** 自 `docs/tasks/active/` 迁入 `docs/tasks/done/`) > **关联实录**:`docs/spec/v3-agent/text2sql/1.md`(`tool.call.end` 报错:`column "id" of relation "agent_info" does not exist`,INSERT 列名与真实表结构不一致) > **关联实现入口**:`api/tools.py::text2sql_execute`、`api/text2sql_core.py::build_sql_prompt`、`api/text2sql_store.py`(检索 DDL)、`api/unified_chat.py`(非 Agent 路径若仍调 Text2SQL 需对齐) diff --git a/docs/tasks/done/task_unified_chat_router_evidence_event_v1.md b/docs/tasks/done/task_unified_chat_router_evidence_event_v1.md index ff444df0..a16fb81e 100644 --- a/docs/tasks/done/task_unified_chat_router_evidence_event_v1.md +++ b/docs/tasks/done/task_unified_chat_router_evidence_event_v1.md @@ -1,5 +1,13 @@ # Task:Unified Chat(后端)— 新增 `router.evidence` 事件(降级前证据可视化) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + 状态:done(2026-04-30 验收通过) 范围:仅后端 `ai-ink-brain-api-python` 关联: diff --git a/docs/tasks/done/task_unified_chat_router_evidence_observability_v1.md b/docs/tasks/done/task_unified_chat_router_evidence_observability_v1.md index 19b4b542..8acdbbaf 100644 --- a/docs/tasks/done/task_unified_chat_router_evidence_observability_v1.md +++ b/docs/tasks/done/task_unified_chat_router_evidence_observability_v1.md @@ -1,5 +1,13 @@ # Task:Unified Chat(后端)— Router Evidence 可追溯日志(SSE + DB,v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-30 验收通过) 范围:仅后端 `ai-ink-brain-api-python` 前置:`docs/tasks/done/task_unified_chat_router_evidence_event_v1.md`(`router.evidence` 已验收通过) diff --git a/docs/tasks/done/task_unified_chat_router_observability_full_trace_v1.md b/docs/tasks/done/task_unified_chat_router_observability_full_trace_v1.md index a3cbd4ef..b9039cce 100644 --- a/docs/tasks/done/task_unified_chat_router_observability_full_trace_v1.md +++ b/docs/tasks/done/task_unified_chat_router_observability_full_trace_v1.md @@ -1,5 +1,13 @@ # Task:Unified Chat(后端)— Router Observability Full Trace 落库(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-30 验收通过) > **关联图谱**:无(仅补齐可追溯日志,不改业务流程) > **关联 Issue/PR**:无 diff --git a/docs/tasks/done/task_unified_chat_router_trace_text2sql_exec_v1.md b/docs/tasks/done/task_unified_chat_router_trace_text2sql_exec_v1.md index 180bf91a..3a46070a 100644 --- a/docs/tasks/done/task_unified_chat_router_trace_text2sql_exec_v1.md +++ b/docs/tasks/done/task_unified_chat_router_trace_text2sql_exec_v1.md @@ -1,5 +1,13 @@ # Task:Unified Chat(后端)— Router Trace 记录 Text2SQL SQL 与结果摘要(v1) +## Harness 元信息 + +| 字段 | 值 | +|------|-----| +| **wiki_delta** | `none` | +| **wiki_delta_note** | 存量迁移 · 本 task 无 Wiki 增量(2.18 wiki_delta) | + + > **状态**:done(2026-04-30 验收通过) > **关联图谱**:无(仅补齐可追溯日志字段,不改业务流程) > **关联 Issue/PR**:无 diff --git a/docs/tasks/done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md b/docs/tasks/done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md index c49b2bb9..97f9c2e3 100644 --- a/docs/tasks/done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md +++ b/docs/tasks/done/task_wiki_ctx_ab_multi_bq3_recheck_v1.md @@ -20,6 +20,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-bq3-recheck-v1` | | **task_slug** | `wiki-bq3-r1-payload-scorecard` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md b/docs/tasks/done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md index 5864d832..83f5592a 100644 --- a/docs/tasks/done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md +++ b/docs/tasks/done/task_wiki_ctx_ab_multi_conclusion_bq3_sync_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-loop-bq3-recheck-v1` | | **task_slug** | `wiki-bq3-r2-conclusion` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_wiki_ctx_ab_multi_slug_v1.md b/docs/tasks/done/task_wiki_ctx_ab_multi_slug_v1.md index a64fda17..f2a3d30d 100644 --- a/docs/tasks/done/task_wiki_ctx_ab_multi_slug_v1.md +++ b/docs/tasks/done/task_wiki_ctx_ab_multi_slug_v1.md @@ -23,6 +23,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-ctx-ab-multi-slug-v1` | | **task_slug** | `wiki-ctx-ab-multi` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/docs/tasks/done/task_wiki_ctx_ab_v1.md b/docs/tasks/done/task_wiki_ctx_ab_v1.md index 2270ad5c..4f680462 100644 --- a/docs/tasks/done/task_wiki_ctx_ab_v1.md +++ b/docs/tasks/done/task_wiki_ctx_ab_v1.md @@ -19,6 +19,8 @@ | **audit_profile** | `post_close` | | **git_branch** | `task/wiki-ctx-ab-p2-v1` | | **task_slug** | `wiki-ctx-ab` | +| **wiki_delta** | `docs/coding_wiki` | +| **wiki_delta_note** | 存量迁移 · 本 task 触及 docs/coding_wiki(2.18 wiki_delta) | ### 人工闸 `human_gate` diff --git a/harness.pin.json b/harness.pin.json new file mode 100644 index 00000000..7041fd4a --- /dev/null +++ b/harness.pin.json @@ -0,0 +1,4 @@ +{ + "package": "@cyning/harness", + "version": "2.19.0" +}