From 216a056ae1781bf8ea5c6ae9727f80119c519a1f Mon Sep 17 00:00:00 2001 From: lanrtop Date: Sun, 4 Oct 2026 04:00:32 +0900 Subject: [PATCH] =?UTF-8?q?docs(blueprint/intent-catalog):=20IC6=E2=80=93I?= =?UTF-8?q?C10=20=E5=8D=A1=E4=BE=A7=E6=8C=82=E9=9D=A0=20INT-02@1.0?= =?UTF-8?q?=EF=BC=88=E8=A1=A5=E4=B8=81=EF=BC=89=EF=BC=9BIC4=20=E5=BC=80?= =?UTF-8?q?=E5=B7=A5=EF=BC=8C=E6=8A=A5=E5=A4=87=E7=9B=AE=E6=A0=87=E7=AB=A0?= =?UTF-8?q?=E7=94=B1=E4=B9=A6=E7=AD=BE=E7=AB=A0=E6=94=B9=E4=B8=BA=E6=8C=87?= =?UTF-8?q?=E5=AE=9A=20INT-02?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - IC6–IC10 各加一行 `- intent: INT-02@1.0`（紧跟 complexity），离线检查第 7 条通过（引用的章都存在） - IC4 🔵；notes 报备改断言理由：书签所指 INT-01（P8）的卡在统筹会话的 agent-client-parity.md 中且几乎全为 ✅，纸面编译无测试价值；INT-02 挂有五张待做卡，纸面编译即 IC5 预演 Co-Authored-By: Claude Opus 5.5 --- .blueprint/modules/intent-catalog.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/.blueprint/modules/intent-catalog.md b/.blueprint/modules/intent-catalog.md index 7a110e0..9cbdfee 100644 --- a/.blueprint/modules/intent-catalog.md +++ b/.blueprint/modules/intent-catalog.md @@ -117,11 +117,12 @@ agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题 - depends: IC2 - acceptance: "agent_verify: [CLI] grep -c 'catalog_version: 1.0' → 1；grep -cE '^## INT-[0-9]{2} ' 介于 2–4；wc -l ≤200 且 wc -c ≤8192；grep -cE '^- (status|progress|doc|files|acceptance|model):' → 0；指南中的 path 指针检查 → 0 悬空；cat .blueprint/modules/*.md | grep -c '^### ' 前后相等。human_verify: 用户逐章确认意图与不做（1.0 为大版本，人定稿），提交带 Feature-Confirmed: true。" -### 📋 IC4 — 跨 agent 纸面编译：Codex 或 DSH 按指南对书签章编译确认卡（不粘贴） -- status: todo +### 🔵 IC4 — 跨 agent 纸面编译：Codex 或 DSH 按指南对书签章编译确认卡（不粘贴） +- status: in_progress - complexity: S - files: .blueprint/modules/intent-catalog.md - depends: IC3 +- notes: 2026-10-04 报备改断言：目标章由「书签章」改为指定 INT-02。理由：书签所指的 INT-01（P8）卡在统筹会话的 agent-client-parity.md 中，且几乎全为 ✅，纸面编译无测试价值；INT-02 挂有 IC6–IC10 五张待做卡，纸面编译即 IC5 的预演。 - acceptance: "agent_verify: [CLI] git log -1 --grep='IC4' --format=%B → 含 项目、分支/worktree、HEAD、纳入卡、终点、终验待办、停止找人、没验什么、作废 9 字段与 Compiled-By: <非 Claude 客户端>；标签 blob 等于该提交中 .blueprint/catalog.md 的短 blob；每条终点可在来源卡 agent_verify 原文找到；过程词黑名单 grep → 0。" ### 📋 IC5 — 首次真实 /goal：为 Phase 4 的卡编译 → 人粘贴 → 收口回执 @@ -134,6 +135,7 @@ agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题 ### 📋 IC6 — intent-gate.cjs 核心：结构、防膨胀、类型指针、卡侧引用，加 --self-test - status: todo - complexity: M +- intent: INT-02@1.0 - files: .claude/hooks/intent-gate.cjs - depends: IC3, P8 收口 - acceptance: "agent_verify: [gate 脚本] node .claude/hooks/intent-gate.cjs --self-test → exit 0 且输出 self-test ok，内置 6 类坏样例（悬空 path:、未知 INT、超长字段、status: 键、card: 指向不存在的卡、探索章缺预算或收敛信号）各恰好 1 条警告；node .claude/hooks/intent-gate.cjs → exit 0、真实目录 0 警告；INTENT_CATALOG=/nonexistent → 无输出、exit 0。" @@ -141,6 +143,7 @@ agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题 ### 📋 IC7 — 门控只读视图 --report/--impact/--pending 与目录提交审计 - status: todo - complexity: M +- intent: INT-02@1.0 - files: .claude/hooks/intent-gate.cjs - depends: IC6 - acceptance: "agent_verify: [gate 脚本] --self-test 夹具：章 rev 1.1 而 📋 卡钉 1.0 → --impact 报 stale；钉墓碑章 → orphan；只有模块默认挂靠 → low_confidence；前缀 🔵 而 status: todo → --report 报 divergence 并标 status_source；含 human_verify 而无终验行的 ✅ 卡 → --pending 列出；缺 Feature-Confirmed 的目录提交 → --report 审计列出；全部 exit 0，运行前后 sha256sum .blueprint/catalog.md .blueprint/modules/*.md 不变。" @@ -148,6 +151,7 @@ agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题 ### 📋 IC8 — 接线：lefthook 加 intent-gate、AGENTS.md 块外加 T5 与启动读书签、agent-button-system 单处改名 - status: todo - complexity: S +- intent: INT-02@1.0 - files: lefthook.yml, AGENTS.md, docs/ai-context/agent-button-system.md, docs/ai-context/intent-catalog-guide.md, .blueprint/modules/intent-catalog.md - depends: IC6, P8 收口 - acceptance: "agent_verify: [YAML 解析] lefthook.yml 可解析且 pre-commit.commands.intent-gate.run 以 || true 结尾；[cargo test] cargo test onboarding → 0 failed；[CLI] git diff -U0 AGENTS.md 全部 hunk 位于 BLUEPRINT_MANAGED_START 行之前；grep -c '意图层 — AGENTS.md' docs/ai-context/agent-button-system.md → 0；临时 worktree 内提交一次「改章文不升 rev」→ pre-commit 输出 1 条警告且提交成功，验证后移除该 worktree。" @@ -155,6 +159,7 @@ agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题 ### 📋 IC9 — cargo test 锁定 parse_module_md 忽略 intent 与终验行 - status: todo - complexity: S +- intent: INT-02@1.0 - files: src-tauri/src/commands/blueprint.rs - depends: P8 收口 - acceptance: "agent_verify: [cargo test] cargo test parse_module_md_ignores_intent_lines → 1 passed：含 intent、终验行与模块头 intent 的样本，和删去这些行的样本相比，tasks.len()、status、acceptance、notes 逐字段相等（只改 #[cfg(test)]）；全量 cargo test 无 FAILED。" @@ -162,6 +167,7 @@ agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题 ### 📋 IC10 — 书签交接：目录书签自持三行，coordination §0 改为指向书签 - status: todo - complexity: S +- intent: INT-02@1.0 - files: .blueprint/catalog.md, docs/tasks/2026-10-03-coordination.md - depends: IC7, IC8 - acceptance: "agent_verify: [gate 脚本] node .claude/hooks/intent-gate.cjs → 0 警告；[CLI] grep -A3 '^## 书签' .blueprint/catalog.md → 当前、终点、确认 三行且当前章存在未撤销；coordination §0（若仍存在）含指向书签的一行；提案附 --report 与 base blob；提交带 Feature-Confirmed: true。human_verify: 用户确认书签切换。"