@openprd/cli 0.1.19 → 0.1.21

package/.openprd/changes/openprd-control-plane-v020/.openprd.yaml

@@ -0,0 +1,2 @@
+schema: openprd.change.v1
+generatedFrom: v0018

package/.openprd/changes/openprd-control-plane-v020/design.md

@@ -0,0 +1,78 @@
+# 设计
+
+## 背景
+
+0.1.19 已暴露多真相源、并发和跨版本迁移风险，需要在 0.1.20 建立兼容控制平面
+
+## 目标
+
+- 用唯一 Project Ledger 管理项目业务事实，并把 current、task graph、review、knowledge index 等降为可重建投影
+- 用 Lane/Task Runtime 支持同项目多线程、多 Agent、多 worktree 安全 claim、lease、heartbeat、write-set 与 CAS
+- 用 Context Compiler 向 Agent 提供最精准、最小 token、可缓存、可增量、可解释且默认只读的上下文
+- 用 scoped Evidence 和 Gate 让局部任务不被无关项目债务阻断，同时保持发布级门禁
+- 从同一 ReviewModel 生成小白可懂的业务视图和工程可执行视图，并保持同一 digest 与决策链
+- 统一 Codex、Cursor、Claude Code 的 Adapter SPI、能力协商、事件归一和跨版本协议
+- 把 Knowledge Evolution 变为有作用域、证据、有效期、替代链和可回滚的持续维护系统
+- 安全将产品版本升级到 0.1.20，并刷新所有真实本地 OpenPrd 安装与旧项目
+
+## 范围
+
+- Project Manifest、Event Envelope、Atomic Store、Project Ledger 与可重建投影
+- Session/Lane/Task Runtime：claim、lease、heartbeat、write-set、CAS、worktree/branch trace
+- Context Capsule、Delta、Cache、token budget、authority/freshness、引用解析与 secret redaction
+- project/change/work-unit/task/lane/operation 分级 Gate 与 Evidence
+- Review canonical model、业务/工程双投影、决策与 Canvas 标注绑定
+- Knowledge v3 生命周期、检索预算、telemetry 分离、Learning/Growth 边界
+- Codex/Cursor/Claude Code Adapter SPI、能力协商、runtime detection 与生成文件漂移修复
+- 协议/reader/writer/adapter/projection 版本、N/N-1 兼容、幂等迁移、备份与回滚
+- fleet nested legacy 扫描、symlink 安全、registry 隔离/压缩和真实本地项目批量刷新
+- 面向普通用户的中文产品文案、i18n 提醒和 Review Studio 视觉交互验证
+
+## 约束
+
+- 保持现有 CLI、JSONL/JSON workspace 与 Codex/Claude/Cursor 生成路径的向后兼容
+- 当前 git worktree 含既有 i18n 和 unfinished session 修改，必须保留用户改动并分层整合，禁止 reset/stash
+- Repo-local canonical source 与生成文件必须区分，写入前检查任一路径祖先是否为 symlink
+- 测试必须使用隔离 OPENPRD_HOME，禁止污染真实全局 registry
+- Review Studio 改动必须复用现有视觉系统并提供前后、焦点、验证与对齐证据
+- 上下文与日志不得包含 API key、token、账号、个人隐私或未脱敏 prompt 原文
+- 迁移备份只包含当前任务需要的最小文件并保留本机权限，不向外发送
+- 不修改用户归档、远程仓库或生产环境
+- 现有 OpenPrd CLI、skills、hooks、workspace schema、review renderer、quality/standards/test infrastructure
+- 本机 Node.js、npm 全局软链接与真实 OpenPrd 项目 inventory
+- Codex、Cursor、Claude Code 当前可观测的 runtime capability 与生成协议
+
+## 业务护栏
+
+- 成本来源: 全量线程与项目扫描、并发压力测试、Review 视觉验证、旧项目备份和批量迁移
+- 成本来源: 重复上下文注入和过宽文档读取造成的 token 与执行时间
+- 额度限制: 默认 context Capsule 800 tokens，Delta 250 tokens；超预算需可解释裁剪
+- 额度限制: 真实 fleet 按 Home、Projects、Context、活跃 worktree 分批执行，归档不纳入
+- 额度限制: 单项目迁移失败不继续覆盖该项目，也不阻断已经验证成功的其他项目
+- 滥用防护: 高风险操作绑定明确 lane/operation approval ID，短句确认不能放行其他 lane
+- 滥用防护: Symlink 路径、too-new schema、dirty archive 分类不明时拒绝破坏性写入
+- 滥用防护: Context 编译进行 secret redaction，Knowledge promotion 需要证据和 reviewer
+- 监控信号: context token、cold/warm p50/p95、cache hit、included/excluded reason
+- 监控信号: claim 冲突、lease recovery、CAS conflict、lost update、write-set overlap
+- 监控信号: projection digest、migration digest、rollback result、adapter drift、registry stale count
+- 监控信号: 业务 Review 完成率、需求修订次数、用户可理解性检查与技术词泄漏
+- 报警阈值: 任何 lost update、错误项目写入、归档 checksum 变化、secret 泄漏或无法回滚均为阻断
+- 报警阈值: Context 超预算、p95 超 SLO、adapter fixture 不一致或 migration 对账不一致阻断真实 fleet
+- 报警阈值: 质量报告 productionReady=false 时不得声称整体完成
+- 止损动作: 切回 legacy read/storageMode，停止后续批次并按项目 restore preimage
+- 止损动作: 保留失败报告、revision、digest 和 capability gap，不用写死逻辑绕过门禁
+- 止损动作: 对分类不明的归档、副本或 symlink 目标保持只读
+
+## 风险与开放问题
+
+- 假设: 0.1.20 可在不移除 legacy 文件的前提下交付兼容控制平面纵向能力
+- 假设: 现有 43 个活跃真实项目与历史 0.1.15/0.1.19 fixture 足以覆盖主要迁移形态
+- 假设: Codex、Cursor、Claude Code 平台差异可通过 capability negotiation 明确表达
+- 风险: 改造横跨状态、hook、CLI、review、knowledge 与迁移，若没有兼容分层会形成大爆炸式回归
+- 风险: 当前 dirty worktree 与语义污染状态可能把既有用户改动误当成稳定基线
+- 风险: Home 级 Skill symlink 与通用 skills-sync 可能再次制造跨适配器漂移
+- 风险: 全局 registry 已被测试临时目录污染，直接 compact 或 fleet 可能误删仍需的定位索引
+- 风险: Review 双投影若没有 canonical digest 会再次产生两套真相
+- 问题: Ledger 默认读路径在 0.1.20 是否切换到 dual-read，或先保持 legacy-read + shadow ledger；本轮以安全对账结果决定
+- 问题: Home 全局 Skill 最终采用 adapter-neutral shared 内容还是让外部 skills-sync 排除 OpenPrd；本轮优先实现兼容 shared 内容与 symlink fence
+- 问题: 历史 Documents 归档保持不可变，只验证 scanner 排除，不纳入版本刷新

package/.openprd/changes/openprd-control-plane-v020/proposal.md

@@ -0,0 +1,54 @@
+# OpenPrd 可解释项目控制平面与跨工具上下文升级
+
+## 背景与原因
+
+统一项目事实、并发运行态和上下文编译，降低 token、延迟、错误目标与长期维护成本
+
+## 变更内容
+
+- Project Manifest、Event Envelope、Atomic Store、Project Ledger 与可重建投影
+- Session/Lane/Task Runtime：claim、lease、heartbeat、write-set、CAS、worktree/branch trace
+- Context Capsule、Delta、Cache、token budget、authority/freshness、引用解析与 secret redaction
+- project/change/work-unit/task/lane/operation 分级 Gate 与 Evidence
+- Review canonical model、业务/工程双投影、决策与 Canvas 标注绑定
+- Knowledge v3 生命周期、检索预算、telemetry 分离、Learning/Growth 边界
+- Codex/Cursor/Claude Code Adapter SPI、能力协商、runtime detection 与生成文件漂移修复
+- 协议/reader/writer/adapter/projection 版本、N/N-1 兼容、幂等迁移、备份与回滚
+- fleet nested legacy 扫描、symlink 安全、registry 隔离/压缩和真实本地项目批量刷新
+- 面向普通用户的中文产品文案、i18n 提醒和 Review Studio 视觉交互验证
+- 提供 project manifest、ledger append/read/head/verify/rebuild、projection replay API
+- 提供 task claim/heartbeat/release、lease recovery、write-set conflict、lane binding API 与 CLI
+- 提供 context compile/diff/cache/render/reference API，保持 run --context 兼容入口
+- 提供 scoped gate/evidence evaluation 与明确 approval ID 绑定
+- 提供 ReviewModel 业务/工程投影与稳定确认合同
+- 提供 adapter detect/capabilities/install/normalize/render/handoff SPI
+- 提供 Knowledge v3 validate/promote/deprecate/supersede/query 生命周期
+- 提供 upgrade plan/dry-run/backup/atomic apply/restore 与 fleet 安全批处理
+- 提供 registry prune/compact 与测试环境 OPENPRD_HOME 隔离
+- 全量单元、集成、并发、迁移、回滚、性能和三平台契约测试通过
+- 最新 Markdown/HTML 测试报告、质量报告、架构与视觉证据可追溯
+- standards、quality、run verify 与 doctor 在发布/刷新前全部健康
+- 所有真实项目刷新报告包含版本、checksum、备份、迁移结果和失败回滚状态
+
+## 能力范围
+
+- `agent-requirements`: OpenPrd 可解释项目控制平面与跨工具上下文升级 需求。
+
+## 影响范围
+
+- 主要用户: 用自然语言驱动 Codex、Cursor、Claude Code 完成产品开发的非专业或半专业用户
+- 主要用户: 在同一代码项目中并发运行多个 Agent、线程、worktree 的开发者
+- 主要用户: 需要持续维护需求、代码健康、知识与版本迁移的项目负责人
+- 成本来源: 全量线程与项目扫描、并发压力测试、Review 视觉验证、旧项目备份和批量迁移
+- 成本来源: 重复上下文注入和过宽文档读取造成的 token 与执行时间
+- 额度限制: 默认 context Capsule 800 tokens，Delta 250 tokens；超预算需可解释裁剪
+- 额度限制: 真实 fleet 按 Home、Projects、Context、活跃 worktree 分批执行，归档不纳入
+- 额度限制: 单项目迁移失败不继续覆盖该项目，也不阻断已经验证成功的其他项目
+- 依赖: 现有 OpenPrd CLI、skills、hooks、workspace schema、review renderer、quality/standards/test infrastructure
+- 依赖: 本机 Node.js、npm 全局软链接与真实 OpenPrd 项目 inventory
+- 依赖: Codex、Cursor、Claude Code 当前可观测的 runtime capability 与生成协议
+- 风险: 改造横跨状态、hook、CLI、review、knowledge 与迁移，若没有兼容分层会形成大爆炸式回归
+- 风险: 当前 dirty worktree 与语义污染状态可能把既有用户改动误当成稳定基线
+- 风险: Home 级 Skill symlink 与通用 skills-sync 可能再次制造跨适配器漂移
+- 风险: 全局 registry 已被测试临时目录污染，直接 compact 或 fleet 可能误删仍需的定位索引
+- 风险: Review 双投影若没有 canonical digest 会再次产生两套真相

package/.openprd/changes/openprd-control-plane-v020/specs/agent-requirements/spec.md

@@ -0,0 +1,16 @@
+## 新增需求
+
+### 需求：OpenPrd 可解释项目控制平面与跨工具上下文升级
+统一项目事实、并发运行态和上下文编译，降低 token、延迟、错误目标与长期维护成本
+
+#### 场景：主流程成功
+- **当** Agent 进入已有项目，Adapter 识别运行环境，Context Compiler 基于 lane/task/revision 在预算内生成 Capsule 或 Delta
+- **则** 全量单元、集成、并发、迁移、回滚、性能和三平台契约测试通过
+
+#### 场景：边界情况保持可见
+- **当** 同一 session ID 在多个工作区有线索时不语义猜测，返回候选和安全阻断
+- **则** 产品应保持该情况明确可见，以支持实现和验证
+
+#### 场景：失败模式得到处理
+- **当** expectedRevision 不一致时返回 OPENPRD_REVISION_CONFLICT，不覆盖新状态
+- **则** 产品应提供有边界且可评审的结果

package/.openprd/changes/openprd-control-plane-v020/task-events.jsonl

@@ -0,0 +1,27 @@
+{"version":1,"at":"2026-07-11 03:10:46","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.01","taskTitle":"评审生成的 spec 覆盖","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"Spec、PRD、架构、可视评审与验收边界已覆盖并由报告索引。"}
+{"version":1,"at":"2026-07-11 03:10:58","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.02","taskTitle":"对齐共享契约与 Host API 调用边界","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:58","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.03","taskTitle":"接通界面入口、导航与页面挂载","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:58","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.04","taskTitle":"提供 project manifest、ledger append/read/head/verify/rebuild、projection replay API","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.05","taskTitle":"提供 task claim/heartbeat/release、lease recovery、write-set conflict、lane binding API 与 CLI","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.06","taskTitle":"提供 context compile/diff/cache/render/reference API，保持 run --context 兼容入口","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.07","taskTitle":"提供 scoped gate/evidence evaluation 与明确 approval ID 绑定","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.08","taskTitle":"提供 ReviewModel 业务/工程投影与稳定确认合同","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.09","taskTitle":"提供 adapter detect/capabilities/install/normalize/render/handoff SPI","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.10","taskTitle":"提供 Knowledge v3 validate/promote/deprecate/supersede/query 生命周期","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.11","taskTitle":"提供 upgrade plan/dry-run/backup/atomic apply/restore 与 fleet 安全批处理","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:10:59","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.12","taskTitle":"提供 registry prune/compact 与测试环境 OPENPRD_HOME 隔离","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:11:00","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.13","taskTitle":"打通主流程闭环：Agent 进入已有项目，Adapter 识别运行环境，Context Compiler 基于 lane/tas 等 6 项","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:11:00","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.14","taskTitle":"验证全量单元、集成、并发、迁移、回滚、性能和三平台契约测试通过","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:11:00","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.15","taskTitle":"验证最新 Markdown/HTML 测试报告、质量报告、架构与视觉证据可追溯","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现与任务级证据已登记，完整测试、交互和环境刷新结果见统一验证报告。"}
+{"version":1,"at":"2026-07-11 03:17:38","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.16","taskTitle":"验证standards、quality、run verify 与 doctor 在发布/刷新前全部健康","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"standards、run verify 与 doctor 已通过；quality 唯一 attention 为尚未闭合的后续任务账本，待全部任务登记后最终复跑。"}
+{"version":1,"at":"2026-07-11 03:17:38","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.17","taskTitle":"验证所有真实项目刷新报告包含版本、checksum、备份、迁移结果和失败回滚状态","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:38","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.18","taskTitle":"回归非功能约束：Node.js 20.19+，优先零新增运行时依赖，复用现有 YAML 与 Sharp 等 2 项","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:39","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.19","taskTitle":"回归非功能约束：读取路径默认无业务状态写入；telemetry 与事实真相分离 等 2 项","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:39","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.20","taskTitle":"回归非功能约束：新旧 CLI 在一个兼容周期内保持字段与退出码兼容，并标注 deprecated 字段 等 2 项","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:39","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.21","taskTitle":"回归边界条件与失败处理：边界情况：同一 session ID 在多个工作区有线索时不语义猜测，返回候选和安全阻断 等 12 项","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:39","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.22","taskTitle":"验证成本与额度护栏","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:40","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.23","taskTitle":"验证滥用与越权路径","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:40","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.24","taskTitle":"验证成本监控、报警和止损","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:40","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.25","taskTitle":"维护 docs/basic 项目基础文档","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:40","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.26","taskTitle":"更新文件说明书和文件夹 README","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}
+{"version":1,"at":"2026-07-11 03:17:40","changeId":"openprd-control-plane-v020","action":"advance","taskId":"T001.27","taskTitle":"运行 OpenPrd spec 校验","ok":true,"verify":null,"evidence":".openprd/harness/test-reports/openprd-control-plane-v020-20260711.md","notes":"实现、非功能约束、真实环境刷新、文档与治理证据已登记。"}

package/.openprd/changes/openprd-control-plane-v020/tasks-002.md

@@ -0,0 +1,35 @@
+# 任务
+
+- [x] T001.26 更新文件说明书和文件夹 README
+  - type: documentation
+  - deps: T001.25
+  - done: 本次变更涉及的文件说明书和文件夹 README 已检查；缺失的已补齐，过期的已更新
+  - verify: openprd standards . --verify
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: docs
+  - evidence-plan: openprd standards . --verify
+  - upgrade-reason: 文档任务以标准校验和人工审查证据为主
+  - execution-mode: parallel-workers
+  - parallel-group: docs
+  - write-scope: docs/basic/**, README*.md
+  - owner-role: worker
+  - local-verify: openprd standards . --verify
+  - integration-owner: main-agent
+
+- [x] T001.27 运行 OpenPrd spec 校验
+  - type: governance
+  - deps: T001.26
+  - done: 生成的 change 通过 OpenPrd 校验
+  - verify: openprd change . --validate --change openprd-control-plane-v020
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: governance
+  - evidence-plan: openprd change . --validate --change openprd-control-plane-v020
+  - upgrade-reason: 治理任务以结构校验、评审确认和变更状态证据为主
+  - execution-mode: serial
+  - parallel-group: governance
+  - write-scope: .openprd/changes/**, .openprd/**
+  - owner-role: main-agent
+  - local-verify: openprd change . --validate --change openprd-control-plane-v020
+  - integration-owner: main-agent