docs(blueprint/intent-catalog): IC4 跨客户端纸面编译通过（Codex）并修订指南 #45

Merged

lanrtop merged 2 commits from feat/intent-catalog into master 2026-10-04 10:22:29 +08:00

Conversation 0 Commits 2 Files Changed 3 +27 -9

lanrtop commented 2026-10-04 10:18:12 +08:00

Owner

Copy Link

概述

意图目录 IC4：跨客户端纸面编译。Codex 只读照指南对 INT-02 编出确认卡，验证通过。按它的反馈，指南修订 7 处。

改动

• .blueprint/modules/intent-catalog.md：
  • IC6–IC10 加卡侧挂靠 - intent: INT-02@1.0（补丁）；
  • IC4 ✅，附结果记录；
  • notes 报备改断言：目标章由书签章改为指定 INT-02。理由是书签所指的 P8 卡在统筹会话文件里，且几乎全为 ✅。
• docs/ai-context/intent-catalog-guide.md，7 处修订：
  • 无 Bash 时允许用语义等价命令；
  • 检查一律逐行解析；
  • 只读演练不写盘；
  • 区分机器检查与人工核对；
  • 第 4 步检查 depends，确认卡新增「前置」行；
  • 体量改量 git blob；
  • 确认卡与 /goal 的终点写法一致，黑名单加「符合预期」。
• .blueprint/manifest.yaml：进度 31%。

自验（agent_verify，对照 IC4 acceptance）

• [CLI] git log -1 --grep='IC4' --format=%B 含 项目、分支/worktree、HEAD、纳入卡、终点、终验待办、停止找人、没验什么、作废 9 个字段，以及 Compiled-By: Codex。
• [CLI] 标签 blob 8392d18 等于该提交中 .blueprint/catalog.md 的短 blob。
• [人工核对] 5 条终点可追溯到 IC6–IC10 的 agent_verify 原文。
• [CLI] 按当时的黑名单命中 0。按新增的「符合预期」，确认卡的终点 1 命中 1 次，这正是本次发现的写法不一致；/goal 文本本身命中 0。
• [CLI] IC2 回归：5 个必备节、模型名 0；目录检查第 7 条通过；### 计数不变。

没验什么

• 只做了纸面编译，没有粘贴执行；IC6–IC10 依赖 P8 收口，尚未开工。
• DSH 没有试跑，跨客户端样本只有 Codex 一个。
• 新增的「前置」行、新黑名单还没有在第二次编译中验证，留给 IC5。

🤖 Generated with Claude Code

## 概述 意图目录 IC4：跨客户端纸面编译。Codex 只读照指南对 INT-02 编出确认卡，验证通过。按它的反馈，指南修订 7 处。 ## 改动 - `.blueprint/modules/intent-catalog.md`： - IC6–IC10 加卡侧挂靠 `- intent: INT-02@1.0`（补丁）； - IC4 ✅，附结果记录； - notes 报备改断言：目标章由书签章改为指定 INT-02。理由是书签所指的 P8 卡在统筹会话文件里，且几乎全为 ✅。 - `docs/ai-context/intent-catalog-guide.md`，7 处修订： - 无 Bash 时允许用语义等价命令； - 检查一律逐行解析； - 只读演练不写盘； - 区分机器检查与人工核对； - 第 4 步检查 depends，确认卡新增「前置」行； - 体量改量 git blob； - 确认卡与 /goal 的终点写法一致，黑名单加「符合预期」。 - `.blueprint/manifest.yaml`：进度 31%。 ## 自验（agent_verify，对照 IC4 acceptance） - [CLI] `git log -1 --grep='IC4' --format=%B` 含 项目、分支/worktree、HEAD、纳入卡、终点、终验待办、停止找人、没验什么、作废 9 个字段，以及 `Compiled-By: Codex`。 - [CLI] 标签 blob `8392d18` 等于该提交中 `.blueprint/catalog.md` 的短 blob。 - [人工核对] 5 条终点可追溯到 IC6–IC10 的 agent_verify 原文。 - [CLI] 按当时的黑名单命中 0。按新增的「符合预期」，确认卡的终点 1 命中 1 次，这正是本次发现的写法不一致；/goal 文本本身命中 0。 - [CLI] IC2 回归：5 个必备节、模型名 0；目录检查第 7 条通过；`### ` 计数不变。 ## 没验什么 - 只做了纸面编译，没有粘贴执行；IC6–IC10 依赖 P8 收口，尚未开工。 - DSH 没有试跑，跨客户端样本只有 Codex 一个。 - 新增的「前置」行、新黑名单还没有在第二次编译中验证，留给 IC5。 🤖 Generated with [Claude Code](https://claude.com/claude-code)

lanrtop added 2 commits 2026-10-04 10:18:13 +08:00

docs(blueprint/intent-catalog): IC6–IC10 卡侧挂靠 INT-02@1.0（补丁）；IC4 开工，报备目标章由书签章改为指定 INT-02 ... 216a056ae1

- 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 <noreply@anthropic.com>

docs(blueprint/intent-catalog): IC4 跨客户端纸面编译通过（Codex），按其反馈修订指南七处 ... 50a8bf2f8c

Codex 照指南对 INT-02 纸面编译（只读、未粘贴）的确认卡原文如下：

[INT-02@1.0#8392d18] 目标确认卡
项目: dev-manager-tauri | 分支/worktree: feat/intent-catalog @ E:\code-project\dev-manager-tauri-wt-intent | HEAD: 216a056
章意图: 人给出意图或模糊轮廓，agent 编译出可判定的 /goal：定型章编交付终点，探索章编每轮试验终点，人粘贴即确认 | 不做: 炼境不编译 goal、不判定完成；目录不存状态与进度
形态: 定型
纳入卡: IC6（[gate 脚本] node .claude/hooks/intent-gate.cjs --self-test → exit 0 且输出 self-test ok，内置 6 类坏样例各恰好 1 条警告；node .claude/hooks/intent-gate.cjs → exit 0、真实目录 0 警告；INTENT_CATALOG=/nonexistent → 无输出、exit 0）、IC7（[gate 脚本] --self-test 夹具的 --impact/--report/--pending 报 stale、orphan、low_confidence、divergence、status_source、缺终验、缺 Feature-Confirmed；全部 exit 0，运行前后 sha256sum 不变）、IC8（[YAML 解析] lefthook.yml 可解析且 intent-gate.run 以 || true 结尾；[cargo test] cargo test onboarding → 0 failed；[CLI] AGENTS.md hunk 均在托管块前；grep → 0；临时 worktree 提交输出 1 条警告且成功，验证后移除）、IC9（[cargo test] cargo test parse_module_md_ignores_intent_lines → 1 passed；全量 cargo test 无 FAILED）、IC10（[gate 脚本] 0 警告；书签三行有效、coordination 指向书签、提案附 --report 与 base blob、提交带 Feature-Confirmed: true）
终点（合取）: 1) IC6 的 self-test、真实目录检查和不存在目录降级均符合预期。 2) IC7 的夹具报告覆盖 stale、orphan、low_confidence、divergence、status_source、缺终验及目录提交审计，且全程不改 catalog/module 文件。 3) IC8 的 lefthook、Rust onboarding、AGENTS.md 位置、术语及临时 worktree 警告提交检查通过。 4) IC9 的定向与全量 Rust 测试通过。 5) IC10 的门控、书签、coordination 指向、提案证据及提交 trailer 检查通过。 6) IC6–IC10 均为 ✅，且收口提交已写 Goal-Receipt。
终验待办: IC10：用户确认书签切换。
停止找人: 出现 human_verify；需写运行中的数据库；需删除文件、数据或分支；需变更凭据或机器状态；工作超出 IC6–IC10 或 INT-02；需修改目录；出现 stale 或 orphan；同一问题失败 3 次。
能力入口: node .claude/hooks/intent-gate.cjs（IC6 落地后）；cargo test onboarding；cargo test parse_module_md_ignores_intent_lines；cargo test；Git、YAML 解析与临时 worktree。
没验什么: 本次仅纸面编译，未执行尚未实现的 intent-gate，未运行 cargo test 或 lefthook，未创建/删除临时 worktree，未确认 P8 收口及各依赖卡实际状态，也未进行用户书签终验。
作废: 分支变化或 catalog blob ≠ 8392d18

核对（主会话）：9 个字段齐全；标签 blob 8392d18 = HEAD:.blueprint/catalog.md；5 条终点可追溯到 IC6–IC10 的 agent_verify；按当时的黑名单（按方针|符合设计|设计已完成|基本完成）命中 0。Codex 的 /goal 文本逐条写了「命令 → 预期输出」，但上面确认卡的终点 1 被改写成「均符合预期」，两者写法不一致，这是本次发现之一。

指南修订（docs/ai-context/intent-catalog-guide.md）：
- 无 Bash 环境（Codex 沙箱报 E_ACCESS_DENIED）允许用语义等价命令，并在确认卡注明
- 检查一律逐行解析（整文件正则会跨行误报悬空）
- 只读演练不写盘：第 10 条改为管道检查
- 第 3 步区分机器检查（必须通过）和人工核对（结果写进确认卡）
- 第 4 步检查 depends，确认卡新增「前置」行；有未满足的前置时只能纸面编译
- 体量改量提交里的 blob（git cat-file -s），工作区 CRLF 会让 wc -c 多算 34 字节
- 确认卡与 /goal 的终点写法必须一致；黑名单加「符合预期」

模块：IC4 ✅（附结果记录）、下一步 IC5；manifest 进度 31%。

Compiled-By: Codex
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

lanrtop added 1 commit 2026-10-04 10:18:13 +08:00

docs(blueprint/intent-catalog): IC4 跨客户端纸面编译通过（Codex），按其反馈修订指南七处 ... 50a8bf2f8c

Codex 照指南对 INT-02 纸面编译（只读、未粘贴）的确认卡原文如下：

[INT-02@1.0#8392d18] 目标确认卡
项目: dev-manager-tauri | 分支/worktree: feat/intent-catalog @ E:\code-project\dev-manager-tauri-wt-intent | HEAD: 216a056
章意图: 人给出意图或模糊轮廓，agent 编译出可判定的 /goal：定型章编交付终点，探索章编每轮试验终点，人粘贴即确认 | 不做: 炼境不编译 goal、不判定完成；目录不存状态与进度
形态: 定型
纳入卡: IC6（[gate 脚本] node .claude/hooks/intent-gate.cjs --self-test → exit 0 且输出 self-test ok，内置 6 类坏样例各恰好 1 条警告；node .claude/hooks/intent-gate.cjs → exit 0、真实目录 0 警告；INTENT_CATALOG=/nonexistent → 无输出、exit 0）、IC7（[gate 脚本] --self-test 夹具的 --impact/--report/--pending 报 stale、orphan、low_confidence、divergence、status_source、缺终验、缺 Feature-Confirmed；全部 exit 0，运行前后 sha256sum 不变）、IC8（[YAML 解析] lefthook.yml 可解析且 intent-gate.run 以 || true 结尾；[cargo test] cargo test onboarding → 0 failed；[CLI] AGENTS.md hunk 均在托管块前；grep → 0；临时 worktree 提交输出 1 条警告且成功，验证后移除）、IC9（[cargo test] cargo test parse_module_md_ignores_intent_lines → 1 passed；全量 cargo test 无 FAILED）、IC10（[gate 脚本] 0 警告；书签三行有效、coordination 指向书签、提案附 --report 与 base blob、提交带 Feature-Confirmed: true）
终点（合取）: 1) IC6 的 self-test、真实目录检查和不存在目录降级均符合预期。 2) IC7 的夹具报告覆盖 stale、orphan、low_confidence、divergence、status_source、缺终验及目录提交审计，且全程不改 catalog/module 文件。 3) IC8 的 lefthook、Rust onboarding、AGENTS.md 位置、术语及临时 worktree 警告提交检查通过。 4) IC9 的定向与全量 Rust 测试通过。 5) IC10 的门控、书签、coordination 指向、提案证据及提交 trailer 检查通过。 6) IC6–IC10 均为 ✅，且收口提交已写 Goal-Receipt。
终验待办: IC10：用户确认书签切换。
停止找人: 出现 human_verify；需写运行中的数据库；需删除文件、数据或分支；需变更凭据或机器状态；工作超出 IC6–IC10 或 INT-02；需修改目录；出现 stale 或 orphan；同一问题失败 3 次。
能力入口: node .claude/hooks/intent-gate.cjs（IC6 落地后）；cargo test onboarding；cargo test parse_module_md_ignores_intent_lines；cargo test；Git、YAML 解析与临时 worktree。
没验什么: 本次仅纸面编译，未执行尚未实现的 intent-gate，未运行 cargo test 或 lefthook，未创建/删除临时 worktree，未确认 P8 收口及各依赖卡实际状态，也未进行用户书签终验。
作废: 分支变化或 catalog blob ≠ 8392d18

核对（主会话）：9 个字段齐全；标签 blob 8392d18 = HEAD:.blueprint/catalog.md；5 条终点可追溯到 IC6–IC10 的 agent_verify；按当时的黑名单（按方针|符合设计|设计已完成|基本完成）命中 0。Codex 的 /goal 文本逐条写了「命令 → 预期输出」，但上面确认卡的终点 1 被改写成「均符合预期」，两者写法不一致，这是本次发现之一。

指南修订（docs/ai-context/intent-catalog-guide.md）：
- 无 Bash 环境（Codex 沙箱报 E_ACCESS_DENIED）允许用语义等价命令，并在确认卡注明
- 检查一律逐行解析（整文件正则会跨行误报悬空）
- 只读演练不写盘：第 10 条改为管道检查
- 第 3 步区分机器检查（必须通过）和人工核对（结果写进确认卡）
- 第 4 步检查 depends，确认卡新增「前置」行；有未满足的前置时只能纸面编译
- 体量改量提交里的 blob（git cat-file -s），工作区 CRLF 会让 wc -c 多算 34 字节
- 确认卡与 /goal 的终点写法必须一致；黑名单加「符合预期」

模块：IC4 ✅（附结果记录）、下一步 IC5；manifest 进度 31%。

Compiled-By: Codex
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

lanrtop merged commit 0ffaad03fd into master 2026-10-04 10:22:29 +08:00

lanrtop referenced this issue from a commit 2026-10-04 10:22:30 +08:00

Merge pull request 'docs(blueprint/intent-catalog): IC4 跨客户端纸面编译通过（Codex）并修订指南' (#45) from feat/intent-catalog into master

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No Label

Milestone

Clear milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

No Assignees

1 Participants

Notifications

Subscribe

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: lanrtop/dev-manager-tauri#45

No description provided.