plan-governance-cli 1.0.1 → 1.0.3

package/README.md

@@ -353,7 +353,8 @@ python3 -m pytest
 - 统计 `scripts/` 下的 Python 代码。
 - 开启分支覆盖率。
 - 总覆盖率低于 85% 时测试失败。
-- CI 会同时运行测试覆盖率检查和计划治理检查。
+- 本地执行 `npm run verify` 会依次运行严格计划治理检查、Python 测试与覆盖率检查、Node 测试；npm 发布前也会自动执行。
+- 本仓库不配置 GitHub Actions CI，推送和 PR 不自动运行上述验证。
 
 ## 状态
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plan-governance-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "统一入口的计划治理检查 CLI",
   "private": false,
   "type": "module",

package/resources/skill/references/cli.md

@@ -14,10 +14,14 @@
 
 限量窗口不等于完整验收证据；有阻塞、缺关键上下文或需要复核结论时，按 source 回查，或去掉 `--evidence-limit` 读取完整记录。`--include-history` 仍只控制是否纳入历史计划。普通文本不显示记录表，不需要此参数；旧 CLI（包括 1.0.0）不支持限量时，继续用完整输出，按已获授权更新版本。
 
+面向当前任务读取时，可在工具内解析完整 JSON 后只展示目标计划的状态、阶段、下一动作、有效阻塞和少量证据。跨计划检查仍保留直接依赖和不能归属的诊断；展示限量不裁剪底层门禁或清除阻塞。先选取相关字段再回传，不先以过小输出预算截断、随后又打印全部正文。按来源展开缺口，不为已知无关的警告反复倾倒所有计划。
+
 ## 分发与资源
 
 SKILL、三个 references、agents 元数据与 assets 由同一 npm 包的 manifest 分发。`plan-governance-cli setup --target codex|claude|all --dry-run` 查看同步差异；实际覆盖需既有用户授权并按 setup 冲突提示处理，不自动清理用户目录残留。项目升级不迁移旧计划，受管块外内容必须保持。
 
+仅更新计划格式不等于更新项目入口；更新 AGENTS/CLAUDE 入口也不等于当前阶段已采用风险分流。已有项目在任务交接、没有进行中的实施或复核时更新受管入口；阶段策略单独按 verification 兼容规则处理，不批量回写历史。安装副本与仓库开发规则有差异时说明本次选用来源，不能因版本号相同就混读正文。
+
 ## 初始化、模板和检查脚本
 
 - `../assets/PLAN_MAP.template.md`：治理入口模板。

package/resources/skill/references/planning.md

@@ -121,8 +121,14 @@ docs/
 
 ## 执行与恢复
 
-首次接手读取 PLAN_MAP、当前计划和确实相关的 ADR/migration/spec。恢复时先用已有当前工作集、当前阶段、最近实施/验证记录和实际 diff 定位进度；只有缺失、冲突或相关范围变化时再展开旧资料。历史会话和全部计划不是每轮必读材料。规则与当前证据入口应可访问；只有不可检索的输出 ID 时先补真实内容或可复验入口。
+首次接手先区分项目仅更新了文档格式、已接入共享入口，还是当前阶段已显式选择风险策略；新会话或新版 skill 不替代项目策略接入，按 [verification 的旧计划兼容](verification.md#旧计划兼容)核对当前阶段并处理一次性显式迁移，已有策略直接复用。按任务读取 PLAN_MAP、当前计划和确实相关的契约；未启用治理的有限原型不为接入入口强建整套目录。
+
+恢复先用已有当前工作集、当前阶段、少量最近证据和实际 diff 定位进度；缺失、冲突或相关范围变化时再展开对应段落。规则参考按当前动作读取，不因拆成多个文件就每次全读。跨计划只展开直接相关对象，完整数据中发现的有效阻塞仍须保留。证据入口不可检索时补要点或可复验入口，不倾倒全部历史代替定位。
 
 先确认当前阶段准入和授权，再实施。假设、公共契约、兼容、范围、完成条件或依赖变化时，先更新唯一事实源和地图，再评估准入；阶段内原范围反馈追加差异和验证，不自动新开计划或重开所有门。原验收预期从原场景读取，不因新边界输入自行发明业务规则。
 
+用户连续确认普通决定时，由当前 AI 同步相应文档并自查；一组决定收敛后，再按 verification 判断是否需要独立检查。不把每次回答、文档保存或同步操作当作一个复核点；应先判断的高影响取舍不能积压到实施后。
+
+验收涉及未来周期或新增工作时，尽早明确它与当前交付的关系。经用户确认范围后，将未来事项的职责、触发条件和证据要求放入适合的现有或独立计划。后续计划尚未准入本身不阻塞当前交付，但当前运行安全、恢复能力和已承诺验收仍须满足；不得仅靠拆计划移走有效阻塞。复核分别判断当前交付与后续承接，结论落档顺序见 verification。
+
 治理文档变更后做适用链接、结构、反向引用和 `plan-governance-cli check .`；用 `rg` 搜索同名计划、P 编号、状态/关键字段，以及 `草案为准|以草案为事实源|详见草案|draft is source|source of truth.*draft|以.*draft.*为准`。纯落档不重跑已有效覆盖的全部代码测试；规范行为变化仍需验证受影响场景。

package/resources/skill/references/verification.md

@@ -10,9 +10,13 @@
 | 安全/权限/隐私/公开暴露、数据完整性/迁移、核心公共契约/生命周期、广泛共享逻辑或难以撤销后果 | 保留独立复核，在关键设计或完成边界安排必要检查；一行代码或配置也可能高影响 |
 | 风险暂不明确、反复修复无效或证据冲突 | 先补事实及定向验证；实质疑点仍在则定向独立检查，不凭自信降为低风险 |
 
-是否进入计划、发生阶段转换或计划收尾，本身不决定独立复核。已有计划或用户明确要求独立复核时仍须遵循；新风险策略不能替旧计划的既有门禁自动降级。可逆性评估实际外部后果，不能只看代码能否回滚。执行中影响扩大时立即重新评估。
+按实际变化及其后果判断风险，不因文件位于安全模块、补一个诊断字段、发现下一处错误或完成一次复测，就新设准入和完成双重检查。阶段转换或收尾本身也不决定独立复核。已有计划或用户明确要求的门禁仍须遵循，新风险策略不能自动降级；可逆性评估实际外部后果。执行中影响扩大时重新评估。
 
-需要独立复核且范围/授权已明确时，自动启动未参与实施或测试编写的只读 subagent 或等价复核者，不等待用户逐项安排。输入只给计划/阶段、受审 revision 与实际范围、必要证据、验证命令、完成条件、安全边界；使用新上下文，不倾倒全量聊天。
+需要独立复核且范围/授权已明确时，自动启动未参与实施或测试编写的只读 subagent 或等价复核者，不结束任务等用户再次说“复核吧”。同一授权、已审设计范围和不变量内的增量可合并检查，普通决定的文档同步由当前 AI 自查；高影响实施前门禁仍须及时满足。新增接受路径、权限、外部影响或关键假设变化时，先补事实与范围并满足适用准入，不能积压到最终复核追认。
+
+调试时沿已知处理链提前准备必要的固定失败分类和值域，并明确输出对象/渠道、留存与清理方式，避免逐字段反复改动。只采集当前失败路径已取得的必要诊断，不为补齐信息继续执行失败后的认证步骤，不默认保存原始材料或异常全文。适用策略允许、无有效独立失败且验证充分时，既定诊断边界内不改变接受条件、控制流、响应契约或外部操作的增量由当前 AI 自验；新增隐私暴露、输出范围或共享影响则按具体风险检查。“只是诊断”及最终仍拒绝都不足以证明安全边界未变。
+
+输入只给计划/阶段、受审 revision 与实际范围、差异、风险、可访问证据、验证命令、完成条件和授权边界；简述已有结论未覆盖的变化，合并检查给出已审基线以来的累计差异。没有新变化或证据缺口时引用有效结论，不因一次操作另开复核。用不继承完整聊天的上下文派发，必要历史按证据入口补读；若宿主只能继承历史，不把该能力局限冒充盲测或另起复制全部历史的交接文档。
 
 独立失败、入口不可用、超时或证据冲突保持阻塞，不由实施者自批，不靠改分类/换一条安全操作放行。授权范围内可补证据和修复，未解除前不越门；等价替代者仍须满足相同独立性与证据要求。独立复核不能代替外部授权；已有授权有效时不重复索取，新的公开暴露/凭证/破坏性/隐私/合规或产品取舍按实际边界确认。
 
@@ -33,7 +37,7 @@
 
 摘要没有 `复核策略` 字段时，保留原独立门禁：固定 `阶段路线图`、`当前阶段`、`阶段准入摘要`、`最新独立准入复核`、`独立复核记录` 标题；摘要字段是 `准入状态、Step 0、样本矩阵、验证方式、失败/回滚边界、当前阻塞项、最新独立准入复核`。最新表含日期、阶段、结论、证据、复核者，当前阶段最新结论须明确通过并达到待实施标准，历史追加记录保持一致。标题不带阶段编号；地图提供阶段身份。
 
-不自动改旧计划。采用下面的新策略时显式更新当前阶段结构，保留旧独立历史；必须先解除旧有效独立失败及历史冲突，再进入新策略。旧 CLI 可能拒绝新计划的严格准入，应显式更新选用的 CLI，不能把旧检查结果当新能力。
+新会话或安装了新版 skill 不改变项目已保存的策略。接手时只核对当前计划/阶段；未采用风险分流时，核对原独立约定、有效失败和当前证据，有迁移授权并满足原门禁后，一次显式更新下述当前阶段结构、保留旧独立历史。已有授权不重复索取，未获迁移授权不自动修改；旧有效独立失败与历史冲突必须先解除，小切片通过不解除完整阶段阻塞。后续会话复用落档策略，不重复迁移、不批量重写历史计划。旧 CLI 不支持新策略时明确能力缺口，更新另按授权，不把旧检查当新能力。
 
 ### 新计划风险策略
 
@@ -68,7 +72,11 @@
 
 自验失败由实施 AI 自主修复、复验。独立失败后的重审聚焦原阻塞、修复差异及受影响回归，引用仍有效的证据；不因一处修复无理由重跑整套历史，也不把共享调用变化当成无影响。相同未修正阻塞不重复送审。
 
-每个必要复核点默认一名主复核者，仅对具体且独立的专项风险增加协作者。适用时合并同范围行为后测与完成复核：检查者未参与实现/测试编写，先给任务输入，完成后再给预期对照；行为判断和机械测试分别记录。受审范围冻结后，等待期间可做无依赖的已授权工作；相关变化需通知复核者，不以未完成结果推进依赖项。使用有界等待，避免密集轮询；并行工时不能相加冒充关键路径时长。
+每个必要复核点默认一名主复核者，仅对具体且独立的专项风险增加协作者，不把文档生产助手全部算作独立复核。适用时合并同范围行为后测与完成复核：检查者未参与实现/测试编写，先给任务输入，完成后再给预期对照；行为判断和机械测试分别记录。受审范围冻结后，等待期间可做无依赖的已授权工作；相关变化需通知复核者，不以未完成结果推进依赖项。使用有界等待，避免密集轮询；并行工时不能相加冒充关键路径时长。
+
+送审时用简短说明区分当前交付、后续事项和通过后的记录同步。独立者依据当前已确认范围、实际证据及原失败原因先给出结论，不要求“本次通过记录已存在”才能完成本次判断。旧有效失败仍须由适格独立者明确判断是否解除；范围调整不自动消除失败，也不让未准入的后续事项自动阻断当前交付。
+
+执行者只准确转写独立结论、追加历史并同步地图，不预填通过或自行改判。涉及未来事项时按 planning 核对承接及当前安全边界；资料不足则具体指出哪个当前完成条件缺什么证据，不以“尚未落档本次结论”替代缺陷说明。
 
 验证后仅追加状态/证据或修正文档链接时，做适用文档检查即可；契约、源、依赖或环境又变则补受影响验证。区分仓库源与安装版本、旧缺陷与新回归、当前范围与其他并行任务失败；如实报告全仓失败，不能用局部通过掩盖，也不擅自接管无关任务。