From 6d9f3648bdda2df323e813be6af3459eb6dd8919 Mon Sep 17 00:00:00 2001 From: WeiCHEN Date: Wed, 23 Sep 2026 09:11:56 +0800 Subject: [PATCH 1/2] docs(audit): add modular refactor plan review checklist MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Provide phase-1/2 and cancel-contract self-check items for the off-host refactor plan, with N01–N22 mapping placeholders and product-host backfill steps. --- ...-modular-refactor-plan-review-checklist.md | 297 ++++++++++++++++++ .doc/audit/INDEX.md | 8 + .../2026-09-23-modular-refactor-review.md | 66 ++++ 3 files changed, 371 insertions(+) create mode 100644 .doc/audit/2026-09-23-modular-refactor-plan-review-checklist.md create mode 100644 .doc/ops/short-term/2026-09-23-modular-refactor-review.md diff --git a/.doc/audit/2026-09-23-modular-refactor-plan-review-checklist.md b/.doc/audit/2026-09-23-modular-refactor-plan-review-checklist.md new file mode 100644 index 00000000..7bdc1bf0 --- /dev/null +++ b/.doc/audit/2026-09-23-modular-refactor-plan-review-checklist.md @@ -0,0 +1,297 @@ +--- +title: "系统整改与重构方案 — 前两阶段及取消状态契约审核检查清单" +status: done +created: 2026-09-23 +updated: 2026-09-23 +severity: high +task_id: modular-refactor-review-2026-09-23 +--- + +# 系统整改与重构方案 — 前两阶段及取消状态契约审核检查清单 + +## 1. 目的与范围 + +本清单供**产物机器**上的方案执行者，对照自查《系统整改与重构方案》中**阶段 1、阶段 2、取消状态契约**是否可审、可测、可回退。 + +| 项 | 值 | +|---|---| +| 目标方案（产物机器，本机不可见） | `.doc/remediation/2026-09-22-agent-system-modular-refactor-plan.md` | +| 目标 worktree（产物机器） | `.worktrees/modular-contract-standard-2026-09-22` | +| 本机清单基线 | local `dev@8f0e31e53a5f8d0dd25a908ba6d127a5bb6768a4` | +| 本轮授权 | **仅编制清单并合入本机 dev**；不实施业务代码；不审核方案正文（本机无正文）；不 push | +| 自查结果枚举 | `符合` / `偏差` / `阻断` | + +**非目标**：阶段 3–6 全量逐条（除非阶段 1/2 或取消契约依赖它们）；业务实施；改 YAML 例外；FAV live / `production_ready` / test·main 晋升。 + +## 2. 「22 条规范」映射回填（本机未定位权威编号表） + +本机可见权威材料中**没有**名为「22 条规范」的独立编号清单。邻近可对账来源： + +| 候选来源 | 本机状态 | 与「22」的距离 | +|---|---|---| +| [模块开发规范](../system-design/2026-09-20-module-development-standards.md) §2–§4（端口规则表、事件契约、故障隔离红线 1–7、checklist） | active | 条目合计接近但**未编号为 1–22** | +| [耦合审计](./2026-09-20-module-coupling-audit.md) + [A–G 分批计划](../remediation/2026-09-20-module-decoupling-batch-plan.md) | A–G 能力行已 `done` | 21 条 YAML `exceptions` + 边界规则，**非**「22 条规范」正文 | +| 产物机器新方案（2026-09-22） | 本机不可见 | **应以方案正文为准** | + +产物机器回填表（填完后本清单才可宣称「22 条已闭环对账」）： + +| 规范编号 | 方案章节/工作包 ID | 本机对账锚点（规范/A–G/代码路径） | 阶段归属 | 自查 | +|---|---|---|---|---| +| N01 | _待填_ | _待填_ | 1 / 2 / cancel / 其他 | | +| N02 | _待填_ | _待填_ | | | +| … | | | | | +| N22 | _待填_ | _待填_ | | | + +若方案「22 条」≠ 上表候选来源，在回填表首行注明**权威出处路径 + SHA**，禁止用 A–G `done` 冒充新方案已验收。 + +## 3. 判定规则 + +| 判定 | 条件 | +|---|---| +| 符合 | 方案条目写明代码位置、依赖、责任范围、测试场景、回退条件；与本机锚点无冲突；测试可复现 | +| 偏差 | 可合入意图成立，但路径过时、依赖遗漏、测试偏弱或回退含糊；实施前须修订方案 | +| 阻断 | 与生效规范/[验证契约](../ops/2026-09-21-validation-contract.md)/表写者/事件至少一次语义冲突；或回退会丢数据/假 PASS | + +每条核对项须留下：方案段落锚点、对照 SHA、结论、证据路径（可为本机相对路径或产物机器截图哈希）。 + +--- + +## 4. 阶段 1 — 契约、模块职责、验证基线 + +### R1.1 三种通信契约完整且无第四种 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 模块开发规范 §2.1–§2.3；ADR 模块化单体 | +| 应核对代码/文档 | `internal/app/*/ports.go`；`internal/events/registry.go` `StaticContracts()`；`internal/server` wire DTO；方案工作包是否禁止 gRPC/全局 bus/跨包未导出 helper | +| 依赖与责任 | 消费者定义端口；组合根（`internal/app`、`cmd/*`）注入；server 不持领域 SQL | +| 测试场景 | 新增端口无 JSON/`pgx`/物理路径；事件改动跑 registry↔YAML parity；HTTP 错误信封 `code/message/request_id` | +| 回退核对 | 契约变更可单批 revert；不留下「半套第四种通信」 | +| 自查 | | + +### R1.2 表唯一写者与解包事务名单 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §4 红线 1–2；`module-boundaries.yaml` `table_owners` | +| 应核对代码 | YAML `table_owners` / `tx_unpackers`；工作包是否把跨表原子性放在用例 UnitOfWork，而非各模块自开事务 | +| 依赖与责任 | 非属主不得 `INSERT/UPDATE/DELETE`；server/chat 不得解包 `pgx.Tx`（除非已登记例外且有到期日） | +| 测试场景 | `./scripts/arch-check.sh --mode block`；针对新增写路径的属主负例 | +| 回退核对 | 回退代码与恢复/删除 exception **成对**，避免门禁与代码错位 | +| 自查 | | + +### R1.3 事件信封与至少一次投递 + 幂等 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §2.2、§3.2 | +| 应核对代码 | `internal/events/registry.go`；`ClaimLeases` / outbox 同 UoW；消费者 inbox/`source_event_id`（例：`internal/notification/service.go` `EmitVisible*`） | +| 依赖与责任 | 生产路径为 PG outbox + `cmd/events`；`MemoryBus` 仅特征测试 | +| 测试场景 | 重复投递仅一个可见副作用；缺 `environment`/`project_id` fail closed；永久失败进 dead/quarantine 不堵其他订阅者 | +| 回退核对 | 不回退到 SELECT-only claim（`ClaimIDs` 已禁用） | +| 自查 | | + +### R1.4 模块职责与 A–G 残留边界 + +| 字段 | 内容 | +|---|---| +| 规范来源 | [A–G 分批计划](../remediation/2026-09-20-module-decoupling-batch-plan.md)；FEATURE-MATRIX「模块解耦批次 A–G」=`done` | +| 应核对 | 新方案 17 工作包是否**重复**已合入的 A–G，或明确「在 A–G 之上增量」；互斥 mutex 是否与已关闭批次冲突 | +| 依赖与责任 | 新工作包不得把 FAV live / RPC / `production_ready` 回退写进完成定义 | +| 测试场景 | 声明的依赖边在合入后可用 `go list` / arch-check 证明消失或未回潮 | +| 回退核对 | 单工作包 revert；不整支回滚无关批次 | +| 自查 | | + +### R1.5 验证基线与门禁衔接 + +| 字段 | 内容 | +|---|---| +| 规范来源 | [验证契约](../ops/2026-09-21-validation-contract.md)；规范 §7 | +| 应核对 | 方案阶段 1「验证基线」是否映射到：`arch-check --mode block`、`go vet ./...`、`go test -short ./...`；前端相关则 `npm test` / `npm run build`；纯文档不要求 PI | +| 依赖与责任 | stub/SKIP 不得作交付 PASS；共享环境测试须持锁 | +| 测试场景 | 方案每个工作包的「测试场景」列能落到精确包路径或 `-run` 名 | +| 回退核对 | 失败时保留候选证据，不伪造 PASS | +| 自查 | | + +### R1.6 稳定词汇与跨包错误 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §3.3；批次 C | +| 应核对 | `internal/contracts/vocabulary`；方案是否禁止新增 `docgov.State*` / `Role*` / `Err*` 跨包引用 | +| 依赖与责任 | 带哈希/路径的函数留在属主模块（如 `doccontent`） | +| 测试场景 | 热点引用改为端口或词汇后，原状态机测试仍绿；HTTP code 不变 | +| 回退核对 | 单批 revert | +| 自查 | | + +--- + +## 5. 阶段 2 — 通知事务、事件领取、授权、业务入口一致性 + +### R2.1 通知与领域提交同事务 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §2.2「副作用与 receipt 能进同一数据库事务的必须同事务」；§4 红线 4（持锁不做外部 IO） | +| 应核对代码 | `internal/notification/service.go` / `document_events.go`（`EmitVisible*` 要求 caller fenced tx）；`internal/app/docadvance/consumer.go`；dispatcher `handle` 在 lease tx 内调用 handler | +| 依赖与责任 | notify 消费者不在持锁路径调 LLM/HTTP/SSE；可见通知以 `source_event_id` / dedupe 幂等 | +| 测试场景 | 提交失败无可见通知；重复 `source_event_id` 成功且不双写；`HashVisibleNotifications` 类对账 | +| 回退核对 | 回退后不得留下「已提交领域、无通知」或相反的半状态；优先前滚修复 | +| 自查 | | + +### R2.2 事件领取：lease、续租、抢占 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §2.2；Phase 2 事件计划（投递/lease 语义） | +| 应核对代码 | `internal/events/dispatcher.go` `ClaimLeases` / `HeartbeatLease`；`internal/events/worker.go`；`cmd/events` | +| 依赖与责任 | 生产禁止 `ClaimIDs`；quarantine/expire 不可被再次 claim；多 worker 互斥由 `FOR UPDATE SKIP LOCKED` 语义保证 | +| 测试场景 | `dispatcher_pg_test`：双 worker 仅一人领到；quarantine 不可领；续租失败不再处理 | +| 回退核对 | 不恢复已禁用的 SELECT-only claim；lease 时长变更有观察窗 | +| 自查 | | + +### R2.3 授权检查收敛点 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §2.1「Principal 只来自已认证会话」；§2.3 授权拒绝不泄露存在性；多意图设计「卡片/SSE 不能替代授权」 | +| 应核对代码 | `internal/authz`；`internal/server/*_handlers.go`（task/intent/freeform 等）在 Flush/副作用前鉴权；`events.AuthorizePrincipal` 于消费者路径 | +| 依赖与责任 | 请求体不得覆盖 UserID/ProjectID；消费者授权失败 → quarantine，非无限重试 | +| 测试场景 | 跨用户 IDOR 负例 403；SSE 鉴权在 Flush 前（对照 gap `AUTH-TASK-SSE`）；重复提交不绕过 | +| 回退核对 | 回退不得重新打开已关闭 IDOR；测试与代码同批 | +| 自查 | | + +### R2.4 业务入口一致性（HTTP / 对话 / SSE / 事件投影） + +| 字段 | 内容 | +|---|---| +| 规范来源 | 规范 §2.3；多意图权威性排序：认证主体与资源 → 授权/不变量 → PG → 卡片投影 → SSE | +| 应核对代码 | 同一命令是否只经一个用例入口；chat action 与 REST 是否共用端口；投影/SSE 是否只读权威状态 | +| 依赖与责任 | GET 不修投影（红线 6）；修复为独立命令并写审计 | +| 测试场景 | 双入口同输入同权威结果；刷新后以 GET 覆盖本地缓存；投影丢失仍能经 active discovery 找回 | +| 回退核对 | 入口合并失败时可切回旧入口且状态不分裂 | +| 自查 | | + +### R2.5 与阶段 1 基线的衔接（方案自述三处衔接问题） + +| 字段 | 内容 | +|---|---| +| 规范来源 | 用户汇报：审阅发现的三处衔接问题已修正 | +| 应核对 | 方案正文是否显式列出三处问题的**原描述、修正段落、回归检查**；是否仍依赖未合入的阶段 3+ 契约 | +| 依赖与责任 | 修正不得静默改验证契约或放宽 arch-check | +| 测试场景 | 针对三处各有一条可执行核对（文档锚点或测试名） | +| 回退核对 | 修正可独立 revert 而不拆阶段 1 | +| 自查 | | + +--- + +## 6. 取消状态契约 — Runner 取消、未知结果、SSE 恢复 + +> 用户建议优先审核。本机可见实现重心：`internal/taskrun`（`Cancel`/`StatusCancelled`/`taskrun.cancelled` 事件）、`internal/server/task_run_handlers.go`（Cancel + SSE `after_seq`）、`internal/agent/piagent.go`、多意图计划中的 cancel 转移。 + +### R3.1 取消状态机覆盖全转移 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 方案「取消状态契约」；多意图步骤状态含 `cancelled`；`taskrun.cancelled` 事件登记 | +| 应核对 | 状态集合是否覆盖：`cancel_requested` →（执行中）→ `cancelled` / `unknown`（或方案等价命名）；禁止从终态回退到 running | +| 代码锚点 | `internal/taskrun/finalize.go`（`Commands.Cancel`、`StatusCancelled`、事件名）；`manager.go` `Cancel`；意图计划状态机（若工作包触及） | +| 依赖与责任 | 取消与 finalize 竞态仅一个终态（见 `TestPG_FinalizeCancelRaceOneTerminal` / `TestCommands_CancelWinsOverFinalizeMemory`） | +| 测试场景 | 用户取消、租约过期视同取消、Runner 已结束后的迟到取消、双端并发 cancel/finalize | +| 回退核对 | 回退不得出现双终态或「已取消仍计费/仍写产物」 | +| 自查 | | + +### R3.2 未知结果：幂等重试与人工裁定 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 操作规范/AGENTS：Docker/网络超时先区分未知与未执行；管理器不自动撤销外部副作用 | +| 应核对 | 方案是否定义 `unknown`（或等价）的进入条件、可见对外语义、幂等重试键、人工裁定 API/运维入口、超时升级 | +| 代码锚点 | taskrun 结果应用路径；PI Runner 客户端（`internal/agent/piagent.go`）；方案工作包列出的裁定命令 | +| 依赖与责任 | 未知不得冒充 `succeeded`/`cancelled`；重试必须带 fencing/idempotency，避免双执行 | +| 测试场景 | Runner 超时无响应 → unknown；重试仅一次可见副作用；裁定后 SSE/GET 一致 | +| 回退核对 | 清除 unknown 标记不得删除审计；禁止自动 Down/删库「恢复」 | +| 自查 | | + +### R3.3 执行租约、fencing 与取消的交互 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 多意图设计：短 lease + owner + lease_until + fencing；续租失败不再领步骤 | +| 应核对 | 取消是否使 lease 立即失效；旧 fencing token 的迟到心跳/完成是否被拒绝 | +| 代码锚点 | `internal/taskrun` store/lease；workspace lease 相关迁移与调用 | +| 依赖与责任 | 持 lock 期间取消不调用外部 IO；取消收据与 outbox 同事务（若发 `taskrun.cancelled`） | +| 测试场景 | 取消后旧 worker 心跳失败；fencing 错则拒绝 finalize | +| 回退核对 | 放宽 fencing 视为阻断，不得以「兼容」绕过 | +| 自查 | | + +### R3.4 SSE 恢复后与权威状态一致 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 系统健康整改 Wave0（`after_seq`、心跳、Flush 前鉴权）；多意图「SSE 允许重复/乱序/丢失，缺口 GET 对账」 | +| 应核对代码 | `internal/server/task_run_handlers.go`（`after_seq`、`extendSSEWriteDeadline`、Cancel handler）；`web/src/api/taskStream.ts`；聊天 SSE 同等语义 | +| 依赖与责任 | SSE 非权威；取消/unknown 以 PG/GET 为准覆盖本地 | +| 测试场景 | 断线重连不重复创建运行；取消过程中重连看到终态；WriteTimeout 后同 turn 不误 409（对照 `DOCREV-SSE-IDEM-BUSY` 经验） | +| 回退核对 | 去掉 `after_seq` 视为回归阻断 | +| 自查 | | + +### R3.5 Runner 取消传播 + +| 字段 | 内容 | +|---|---| +| 规范来源 | 方案阶段 2/3 交界：Runner 取消与未知结果 | +| 应核对 | HTTP/对话取消 → taskrun → PI Runner 取消信号是否端到端定义；Runner 已完成后的取消应答 | +| 代码锚点 | `Manager.Cancel`；server cancel 路由；PI 客户端 cancel | +| 依赖与责任 | 取消失败进入 unknown 而非假 cancelled（若方案如此定义则测试锁定） | +| 测试场景 | Runner 可取消；Runner 无响应 → unknown；已终态 cancel 幂等成功 | +| 回退核对 | 回退保留「至少不双执行」不变量 | +| 自查 | | + +--- + +## 7. 工作包级抽查模板（阶段 1/2 + 取消相关包） + +对方案中每个相关工作包复制下表（ID 以方案为准）： + +| 工作包 ID | 阶段 | 规范 Nxx | 代码位置（方案 vs 本机） | 依赖 | 责任范围 | 测试场景可执行？ | 回退可操作？ | 判定 | +|---|---|---|---|---|---|---|---|---| +| WP-? | 1 | | | | | 是/否 | 是/否 | | +| WP-? | 2 | | | | | | | | +| WP-? | cancel | | | | | | | | + +**阻断级缺省**（出现任一条则该包不得开工实施）： + +1. 无精确文件/包路径，或路径在本机 `dev@8f0e31e5` 已改名且方案未更新。 +2. 测试场景只有「手动看看」或依赖 stub 作交付。 +3. 回退是「再想想」或要求硬重置/删库。 +4. 扩大写路径/mutex 未在任务登记中重新认领。 +5. 将卡片/SSE/前端缓存当作授权或权威状态。 + +## 8. 产物机器回填指引 + +1. 在产物机器打开方案 + 本清单（本清单合入本机 `dev` 后，经授权 `push` 或手动同步到产物机器）。 +2. 先填 §2 的 N01–N22 映射；未填完不得宣称阶段 1 审核通过。 +3. 按 §4–§6 逐条标 `符合`/`偏差`/`阻断`，证据写入方案附录或 `.doc/test-reports/`（普通文档级即可）。 +4. 若有 `阻断`：只改方案文档，**不**开工对应业务代码；修正后更新方案 `updated` 与衔接说明。 +5. 全部阶段 1/2 + 取消契约无 `阻断` 且偏差有修订计划后，在产物机器 CURRENT 登记「方案审核通过、待实施授权」——实施须**另开**任务与授权，不由本清单授权。 +6. 本清单单列任务 `modular-refactor-review-2026-09-23`；方案合入/实施不得冒用本 task_id 扩权。 + +## 9. 本机环境与证据边界 + +| 项 | 记录 | +|---|---| +| 本机 | macOS Darwin；仓库 `/private/tmp/Agent-System` | +| 方案正文 | **不可见**（另一主机 `/home/weichen/projects/...`；origin/frp-mix 无对应分支） | +| agentctl | 本机已可用 `with` / `docs apply` / `validate` / `integrate`（进程层）；创建本任务时已 `task register` | +| 清单性质 | 审核**方法**与核对项，不是对方案正文的已审结论 | + +## 10. 相关链接 + +- 任务记录：[../ops/short-term/2026-09-23-modular-refactor-review.md](../ops/short-term/2026-09-23-modular-refactor-review.md) +- 模块开发规范：[../system-design/2026-09-20-module-development-standards.md](../system-design/2026-09-20-module-development-standards.md) +- A–G 分批：[../remediation/2026-09-20-module-decoupling-batch-plan.md](../remediation/2026-09-20-module-decoupling-batch-plan.md) +- 耦合审计：[./2026-09-20-module-coupling-audit.md](./2026-09-20-module-coupling-audit.md) +- 验证契约：[../ops/2026-09-21-validation-contract.md](../ops/2026-09-21-validation-contract.md) +- gap-matrix：[../remediation/gap-matrix.md](../remediation/gap-matrix.md) +- 操作规范：[../ops/2026-09-21-agent-worktree-workflow.md](../ops/2026-09-21-agent-worktree-workflow.md) diff --git a/.doc/audit/INDEX.md b/.doc/audit/INDEX.md index 9025c792..ac9ceaa3 100644 --- a/.doc/audit/INDEX.md +++ b/.doc/audit/INDEX.md @@ -13,6 +13,14 @@ ## 核心文档（按阅读顺序推荐） +### 模块化重构方案审核检查清单（2026-09-23） + +**文件**: [2026-09-23-modular-refactor-plan-review-checklist.md](./2026-09-23-modular-refactor-plan-review-checklist.md) + +**结论**: 产物机器方案（`modular-contract-standard-2026-09-22`）本机不可见；本清单按已生效模块开发规范与 A–G/验证契约，覆盖阶段 1、阶段 2 与取消状态契约自查项，并留「22 条规范」映射回填。不实施业务代码。 + +**任务**: [short-term](../ops/short-term/2026-09-23-modular-refactor-review.md) + ### 模块耦合现状（2026-09-20） **文件**: [2026-09-20-module-coupling-audit.md](./2026-09-20-module-coupling-audit.md) diff --git a/.doc/ops/short-term/2026-09-23-modular-refactor-review.md b/.doc/ops/short-term/2026-09-23-modular-refactor-review.md new file mode 100644 index 00000000..4704294a --- /dev/null +++ b/.doc/ops/short-term/2026-09-23-modular-refactor-review.md @@ -0,0 +1,66 @@ +--- +title: "重构方案审核检查清单（阶段1/2 + 取消契约）" +task_id: modular-refactor-review-2026-09-23 +status: in_progress +created: 2026-09-23 +updated: 2026-09-23 +owner: Cursor +task_type: research +task_tier: small +policy_revision: "AGENTS+CURRENT+validation-contract @ 8f0e31e53a5f8d0dd25a908ba6d127a5bb6768a4" +branch: feature/modular-refactor-review-2026-09-23 +worktree: .worktrees/modular-refactor-review-2026-09-23 +base_dev_sha: "8f0e31e53a5f8d0dd25a908ba6d127a5bb6768a4" +write_scope: [".doc"] +allowed_environments: [] +head_sha: "" +mutex: "docs-audit-modular-refactor-review" +review_state: pending +integration_state: pending +deployment: not_required +cleanup: pending +cleanup_owner: "独立维护者" +cleanup_trigger: "tip 为 local_dev 祖先且无进程占用后 remove" +remote_sync: not_requested +--- + +# 重构方案审核检查清单（阶段1/2 + 取消契约） + +## 用户目标与授权 + +- 用户目标：为产物机器上的《系统整改与重构方案》编制审核检查清单，优先覆盖前两阶段及取消状态契约；清单合入本机 `dev`；不做业务实施；默认不 push。 +- 授权来源：用户确认计划「审核清单 + 审核后排队合入」；本任务仅文档成果。 +- 交付终点：`.doc/audit/2026-09-23-modular-refactor-plan-review-checklist.md` 合入本机 `dev`；CURRENT 登记本任务。 +- 禁止项：不读/改业务代码实施；不操作 test/main；不 push；不清理他人 worktree；不宣称已审核方案正文（正文本机不可见）。 + +## 范围与非目标 + +- 允许写入：`.doc/audit/**`、`.doc/ops/short-term/**`、`.doc/ops/CURRENT.md`（经 docs apply）、必要 INDEX 链接。 +- 非目标：方案正文审核结论、17 工作包实施、22 条规范权威表（本机无编号 SSOT，清单留回填位）。 + +## 步骤与验收 + +1. [x] 基线研读（gap-matrix、A–G、模块开发规范、验证契约、FEATURE-MATRIX、文档地图） +2. [x] 从 `dev@8f0e31e5` 创建 worktree 并 `agentctl task register` +3. [x] 编写审核检查清单 + 本任务文 + audit INDEX 入口 +4. [ ] 普通文档自检与提交 +5. [ ] docs apply 认领 CURRENT → validate → integrate 合入本机 dev +6. [ ] 收口分项报告 + +## 验证与证据 + +| 范围 / 被测 SHA | 命令与环境 | 预期 | 实际 / 判定 | 证据 / 脱敏说明 | +|---|---|---|---|---| +| 纯文档 | 相对链接、taxonomy、状态字段 | 链接可达；落在 `.doc/audit` | 待提交后核 | 本文件 + checklist | +| 门禁 | 不跑 Go/PI/容器 | not_required | not_required | 验证契约「纯规范/普通文档」行 | + +## 收口与交接 + +- 产物机器执行者按 checklist §8 回填 N01–N22 与自查结论。 +- 本地提交 / dev 集成 / 部署 / 远端：见会话收口（完成后更新本表字段）。 +- 获取清单：需用户后续授权 push，或手动自本机同步。 + +## 相关链接 + +- 清单：[../../audit/2026-09-23-modular-refactor-plan-review-checklist.md](../../audit/2026-09-23-modular-refactor-plan-review-checklist.md) +- 目标方案（产物机器，本机不可见）：`.doc/remediation/2026-09-22-agent-system-modular-refactor-plan.md` From f0de2b21582b1428c397a14915550eb61a04f189 Mon Sep 17 00:00:00 2001 From: WeiCHEN Date: Wed, 23 Sep 2026 09:12:38 +0800 Subject: [PATCH 2/2] docs(ops): claim CURRENT row for modular-refactor-review Register the checklist task in the parallel-claim table so coordination snapshots match the agentctl registration. --- .doc/ops/CURRENT.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md index db821b9f..4b2ba42f 100644 --- a/.doc/ops/CURRENT.md +++ b/.doc/ops/CURRENT.md @@ -18,6 +18,7 @@ | owner | task | branch | worktree | mutex | status | |---|---|---|---|---|---| +| Cursor | modular-refactor-review-2026-09-23 | feature/modular-refactor-review-2026-09-23 | .worktrees/modular-refactor-review-2026-09-23 | ops-audit-modular-refactor-review | in_progress | | Cursor | 2026-09-22-status-reconcile | feature/status-reconcile-2026-09-22 | .worktrees/status-reconcile-2026-09-22 | ops-status-reconcile | done | | Cursor | 2026-09-22-dev-prod-ready-test-promotion | feature/dev-prod-ready-test-promotion-2026-09-22 | .worktrees/dev-prod-ready-test-promotion-2026-09-22 | dev-runtime-migration+release-gate+test-promotion | done | | Cursor | integrate-dev-prod-ready-test-promotion-2026-09-22 | feature/integrate-dev-prod-ready-test-promotion-2026-09-22 | .worktrees/integrate-dev-prod-ready-test-promotion-2026-09-22 | git:dev | done |