plan-governance-cli 3.0.0 → 3.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plan-governance-cli",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "统一入口的计划治理检查 CLI",
   "repository": {
     "type": "git",

package/resources/skill/SKILL.md

@@ -13,7 +13,7 @@ description: 维护已有项目计划，或为需要跨阶段、跨会话协调
 
 多计划/多会话并行时，从当前任务确定本会话的已登记计划 ID，在 check/workset/hook 中显式传入同一组 `--plan ID`；不使用全项目可变焦点，不把其他计划的阻塞算作自己的门禁。必要前置、证据引用和共享写入约束仍按 cli 读取；写入前重读相关事实并协调共享文件。焦点不明确时先读轻量索引，多个候选不能自动接管。
 
-首次接手读取地图、当前相关计划及必要契约；恢复只核对当前阶段、实际差异和最近证据。只实施已授权且准入的范围；实质边界变化时调整受影响计划，日常进展随工作同步。事实源与格式见 planning。
+首次接手读取地图、当前相关计划及必要契约；恢复只核对当前阶段、实际差异和最近证据。只实施已授权且准入的范围；实质边界变化时调整受影响计划，日常进展随工作同步。地图更新当前摘要，过程记录追加到专项计划或证据文档；写地图时读取 planning 的记录与格式约束。
 
 按 verification 验证：所有风险级别默认由实施者自验，仅在用户明确要求时安排独立复核；派发时显式传入推理强度，高风险用 `high`，其余用 `medium`。旧策略名和旧记录格式不改变此行为。适用检查通过后完成交付；未解决问题如实保留。交付说明完成结果、必要证据和剩余事项，明确约定的用户体验验收继续有效。
 

package/resources/skill/assets/PLAN_MAP.template.md

@@ -1,18 +1,8 @@
 # PLAN_MAP
 
-## 治理范围
-
-本文件只跟踪跨阶段、影响公共契约、依赖真实反馈，或会与其他计划发生关系的计划。普通一次性任务不要加入这里。
+当前计划状态与证据入口。
 
-## 文档权责
-
-- `PLAN_MAP.md` 的 `状态` 是计划级生命周期，`当前阶段` 是阶段身份指针。
-- 阶段 N 完成后，阶段 N+1 默认保持 `设计中`；专项计划自己的准入复核通过后才能进入 `待实施`。
-- 阶段准入摘要、样本矩阵和独立复核记录只写入专项计划，不复制到本索引。
-- 专项计划记录本次行为差异和验收；现行契约优先引用已有 Schema/OpenAPI，无合适来源且需长期维护时才按需建立 `docs/specs/*.md`。同一事实不重复维护。
-- 专项计划可在当前阶段声明阶段证据和追加式实施/验证记录；完成快照默认保持旧 JSON 兼容格式，发布/合规场景再显式使用 purpose 关系。
-- `--drift`/`--pre-commit` 的关闭窗口只在已完成计划自身也发生变更时覆盖该计划自身和显式阶段证据，不复用已完成计划的完整影响范围。
-- 计划索引固定分为 `未完成`、`已完成`、`已废弃` 三张表；`已替代`、`已合并`等不再推进的终态归入 `已废弃` 表，但保留真实状态值。
+[未完成](#未完成) · [已完成](#已完成) · [已废弃](#已废弃) · [当前阻塞项](#当前阻塞项)
 
 ## 计划索引
 
@@ -34,8 +24,27 @@
 
 允许状态：`候选`、`设计中`、`待实施`、`实施中`、`已完成`、`已替代`、`已合并`、`已废弃`。
 
+## 治理范围
+
+本文件只跟踪跨阶段、影响公共契约、依赖真实反馈，或会与其他计划发生关系的计划。普通一次性任务不要加入这里。
+
+## 文档权责
+
+- `PLAN_MAP.md` 的 `状态` 是计划级生命周期，`当前阶段` 是阶段身份指针。
+- 阶段 N 完成后，阶段 N+1 默认保持 `设计中`；专项计划自己的准入复核通过后才能进入 `待实施`。
+- 地图只更新当前摘要和有效证据入口；实施、部署、测试和反馈详情写入所属计划或报告，不在页首、索引或单元格内追加日志。
+- 阶段准入摘要、样本矩阵和复核记录只写入专项计划，不复制到本索引。
+- 专项计划记录本次行为差异和验收；现行契约优先引用已有 Schema/OpenAPI，无合适来源且需长期维护时才按需建立 `docs/specs/*.md`。同一事实不重复维护。
+- 专项计划可在当前阶段声明阶段证据和追加式实施/验证记录；完成快照默认保持旧 JSON 兼容格式，发布/合规场景再显式使用 purpose 关系。
+- `--drift`/`--pre-commit` 的关闭窗口只在已完成计划自身也发生变更时覆盖该计划自身和显式阶段证据，不复用已完成计划的完整影响范围。
+- 计划索引固定分为 `未完成`、`已完成`、`已废弃` 三张表；`已替代`、`已合并`等不再推进的终态归入 `已废弃` 表，但保留真实状态值。
+
+记录、归属与历史整理按所选 skill 的 planning 参考执行；表格须保持“分类标题 → 表头 → 分隔行 → 连续数据行”，不在表头前或表外追加数据行。历史页仅按需建立，不作为日常日志或第二份状态索引。
+
 ## 推荐顺序
 
+只列仍需推进的事项及下一步依据，完成过程留在所属计划。
+
 1. `example-plan`
 
 ## 依赖关系
@@ -58,6 +67,8 @@
 
 ## 完成证据
 
+只保留结论及有效证据入口；完整历史见所属计划。
+
 | 计划 | 阶段 | 证据 |
 |---|---|---|
 | - | - | - |

package/resources/skill/references/planning.md

@@ -40,6 +40,18 @@
 
 同一事实保留一个权威来源，其他文档引用。决策或结果改变后，同步地图及实际受影响的索引/引用；同一组已收敛变化可合并同步，不为每次保存增加流程。用 `rg` 定向检查相关计划名、关键字段和链接，不重扫无关历史。
 
+## 地图记录与文档归属
+
+`PLAN_MAP.md` 是当前状态入口。同步地图是更新对应摘要和链接，不是在页首、表格之间或证据单元格中不断追加进展。总路线图、优先级计划和其他索引也只维护顺序、状态摘要及专项链接。
+
+- **阅读顺序**：正文以唯一一级标题开头，随后可放简短用途说明和导航，再进入 `## 计划索引`；治理说明、推荐顺序、关系、阻塞及证据章节放在索引之后。索引内只保留三张分类表，不穿插日期日志、部署步骤或验收报告。
+- **当前摘要**：每行说明当前阶段结果、仍有效的阻塞或待验收边界，并链接支持该状态的有效证据。通常一句摘要及一至三个入口足够；证据多时链接专项计划的汇总章节，不逐次累加发布、构建和测试链接。更新时替换过期摘要，不能让“待验证”和“已通过”在当前视图中无区分地并存。
+- **过程留存**：实施、部署、测试和反馈详情写到所属计划的追加式记录或相关证据文档。历史记录保留当时的日期、范围、结论和失败；后续变化追加澄清，并更新当前摘要。地图的完成证据区只做结论入口，不复制整份报告；推荐顺序只列仍需推进的事项。
+- **阻塞收敛**：地图的当前阻塞区保留仍有效的问题、影响和解除条件。已解决项的发现、修复与验证保存在所属计划后，可从当前阻塞区移除；不能靠删行、压缩摘要或归档解除真实问题。会影响后续工作的延后项仍须可定位。
+- **归属登记**：新增或发现与当前工作有关的 spec、报告或草案，先在所属计划补链接；确属独立且需要持续协调的未完成工作，再登记计划并归入未完成。普通一次性记录可由现有文档入口引用，不为每个附件另建计划。不仅凭无入链认定孤儿，也不能仅凭未完成表为空宣称所有工作已完成。
+
+存量整理按本次涉及范围进行，不因规则更新自动搬迁所有旧文档。地图中已有的长篇历史优先归入所属计划或已有报告；确需整体保留跨计划历史时，可使用项目已有历史页或按需创建 `docs/PLAN_MAP_HISTORY.md`，注明归档日期、来源、当前状态入口并保留往返链接。历史页不继续追加日常进展，也不成为第二份计划索引。归档前核对未完成事项、未解决发现、阶段关系与依赖是否仍在现行入口可达；移动后修复相对链接及旧锚点的入链，不能只把旧问题藏到历史页。
+
 ## 草案和历史文档处理
 
 历史草案、旧计划与临时分析保留为背景，不承载新规范。新事实写入当前计划或适用契约；用户明确指定的文档位置优先。已替代内容通过链接说明关系，避免重复改写历史。
@@ -77,3 +89,9 @@
 |---|---|---|---|---|---|
 
 `最后更新` 使用 YYYY-MM-DD，在状态、阶段、依赖、范围、阻塞或验证结果变化时同步；不从文件时间或 Git 推断。`check --stale-days [N]` 可提示活跃计划停滞，默认 10 天，不自动改变状态。
+
+### 索引写入自查
+
+每张分类表依次为分类标题、六列表头、分隔行、连续数据行。表头前不得出现数据行；不以空行或说明段落截断数据区后继续追加无表头行。单元格内容避免使用原始竖线，防止渲染器与现有简单分列解析器将其误作新列。状态改变时移动原行，不保留旧分类副本；空分类只留表头与分隔行，不加虚构计划或占位数据行。
+
+写入后自查正文顺序、三表归类与唯一性、表格连续性、摘要是否已更新、证据及归档链接是否可达，并查看实际 Markdown 结构或渲染。现有 `check` 能检查部分身份、字段与一致性，但不会完整检查页面顺序、孤立表格行、日志堆积、所有链接或文档归属；退出 0 不能替代上述检查。这些记录约束适用于本次新建或更新内容，未触及的存量问题按实际范围记录，不用全仓整理阻塞无关任务。