plan-governance-cli 1.1.1 → 1.1.2

package/README.md

@@ -111,7 +111,6 @@ plan-governance-cli init \
 .git/
 docs/PLAN_MAP.md
 docs/plans/api-compat-migration.md
-CLAUDE.md
 AGENTS.md
 ```
 
@@ -119,12 +118,11 @@ AGENTS.md
 
 如果目标目录还不是 Git 仓库，初始化流程会先执行 `git init`；已有 `.git/` 时会跳过，不重复初始化。
 
-`--update-agent-rules` 会创建或更新 `CLAUDE.md` 和 `AGENTS.md` 中带标记的计划治理章节，只写稳定执行规则，不写具体计划内容。具体计划仍以 `docs/PLAN_MAP.md` 和 `docs/plans/*.md` 为准。
+`--update-agent-rules` 会创建或更新 `AGENTS.md` 中带标记的计划治理章节，只写稳定执行规则，不写具体计划内容。具体计划仍以 `docs/PLAN_MAP.md` 和 `docs/plans/*.md` 为准。
 
-如果只需要更新单个入口，也可以使用：
+也可以使用含义更直接的别名：
 
 ```bash
---update-claude-md
 --update-agents-md
 ```
 
@@ -144,7 +142,7 @@ plan-governance-cli init \
   --update-agent-rules-only
 ```
 
-如果只更新单个入口，可以使用 `--update-claude-md-only` 或 `--update-agents-md-only`。
+`--update-agents-md-only` 与上述兼容别名作用相同，也只更新 `AGENTS.md`。
 
 如果要升级已有项目的辅助文件，刷新检查脚本并更新代理规则，但不覆盖 `docs/`，运行：
 
@@ -157,7 +155,7 @@ plan-governance-cli init \
 `--upgrade-existing` 会：
 
 - 按兼容模式覆盖更新项目中的 `scripts/check_plan_governance.py`
-- 创建或更新 `CLAUDE.md` 和 `AGENTS.md` 中带标记的计划治理章节
+- 创建或更新 `AGENTS.md` 中带标记的计划治理章节，既有其他代理入口保持原样
 - 保留已有 `docs/PLAN_MAP.md` 和 `docs/plans/*.md`
 - 提示缺失的治理文档
 
@@ -209,13 +207,20 @@ plan-governance-cli graph code impact --repo modelpad --file Sources/ModelPadCor
 
 [验证规范](resources/skill/references/verification.md)统一维护单次复核、任务复用、证据复用、修复自验与用户验收；其他会话从同一 skill 读取。需要独立复核且授权明确时自动安排只读 subagent，复用已有同范围任务/结果，等待异常先核准任务 ID 和状态，且复核者不得再委派复核；不为普通小改逐次派发。技术完成待用户验收的适用功能计划仍保持实施中。
 
-1.0.1 起支持可选的最近记录窗口：
+恢复已有计划时可读取派生工作集：
+
+```bash
+plan-governance-cli workset . --json
+plan-governance-cli workset . --json --strict-readiness
+```
+
+工作集返回活跃计划、阶段、阻塞、下一动作、并行提示和最近证据，不写计划或自动执行动作；严格模式让活跃计划的机械准入缺陷返回非零。需要缩小恢复上下文时使用最近记录窗口：
 
 ```bash
 plan-governance-cli workset . --json --evidence-limit 3
 ```
 
-每个计划保留末尾三条记录，并给出省略数量和原文位置；默认完整输出和门禁判断保持。窗口用于恢复阅读，必要时去掉参数回查完整记录，详见 [CLI 参考](resources/skill/references/cli.md#当前工作集)。已发布的 1.0.0 尚不支持此参数。
+每个计划保留末尾三条记录，并给出省略数量和原文位置；默认完整输出和门禁判断保持。窗口用于恢复阅读，必要时去掉参数回查完整记录，详见 [CLI 参考](resources/skill/references/cli.md#当前工作集)。
 
 ## 按需读取规则
 
@@ -230,10 +235,10 @@ plan-governance-cli guide cli             # CLI 操作
 
 SKILL 保留任务边界、自主执行原则和按需入口，三份 references 按需读取并随 manifest/setup/npm 分发。已有项目只刷新受管入口，不迁移旧计划、不改用户块外内容。选择同一版本的规范来源，安装副本与仓库同版本号也可能有不同内容。
 
-也可以不全局安装，直接使用锁定版本：
+也可以不全局安装，直接使用当前公开版本：
 
 ```bash
-npx --yes --package plan-governance-cli@1.0.1 plan-governance-cli check . --strict-readiness
+npx --yes --package plan-governance-cli@latest plan-governance-cli check . --strict-readiness
 ```
 
 npm 包内部仍使用版本化的 Python 检查器，但用户不需要直接调用或复制该脚本。旧项目已有本地脚本时仍可保留作为兼容或回滚路径。
@@ -252,11 +257,10 @@ npm 包内部仍使用版本化的 Python 检查器，但用户不需要直接
 
 ```bash
 plan-governance-cli setup --target codex --dry-run
-plan-governance-cli setup --target claude --dry-run
-plan-governance-cli setup --target all
+plan-governance-cli setup --target codex --force
 ```
 
-`setup` 只同步 npm 包 manifest 指定的 skill、代理元数据和模板文件；默认先用 `--dry-run` 查看差异，目标文件有本地修改时不会静默覆盖。检查器、初始化器和 hook runtime 由 npm 包内部调用，不复制到项目或 skill 目录。当前版本不自动安装 hook 配置。
+`setup` 只向 Codex 同步 npm 包 manifest 指定的 skill、代理元数据和模板文件，必须恰好指定一次 `--target codex`。旧版或重复 target、混合 help、缺失 target 都会在写入前失败；目标之外的用户目录不会被读取、修改或删除。默认先用 `--dry-run` 查看差异，目标文件有本地修改时不会静默覆盖。检查器、初始化器和 hook runtime 由 npm 包内部调用，不复制到项目或 skill 目录；项目初始化器只维护 `AGENTS.md`，当前实现不自动安装 hook 配置。
 
 初始化项目时使用包内初始化器：
 
@@ -268,7 +272,7 @@ plan-governance-cli init --root . --plan api-compat-migration --title "API 兼
 
 ## Hook runtime
 
-本仓库提供只读 hook runtime，供 Codex、Claude Code 或其他 Agent 的项目级 hooks 手动接入。脚本只输出短提示和检查结果，不修改治理文档，不更新 `最后更新`，不安装或修改全局配置。
+本仓库提供只读 hook runtime，供 Codex 项目级 hooks 手动接入。脚本只输出短提示和检查结果，不修改治理文档，不更新 `最后更新`，不安装或修改全局配置。
 
 ```bash
 plan-governance-cli hook --event session-start
@@ -366,7 +370,7 @@ python3 -m pytest
 | `设计中` | 正在明确范围、契约和门禁 |
 | `待实施` | 当前阶段门禁已通过，但尚未开始 |
 | `实施中` | 当前阶段正在修改代码或文档 |
-| `已完成` | 实现、测试、证据和文档已同步 |
+| `已完成` | 实现、测试、证据、文档及适用用户验收均已完成 |
 | `已替代` | 被另一个计划取代 |
 | `已合并` | 并入另一个计划 |
 | `已废弃` | 明确不再推进 |
@@ -377,6 +381,8 @@ python3 -m pytest
 
 新旧计划统一采用单次复核行为：普通改动自验，高风险或高影响独立检查一次后由实施者修复自验，原发现保留。旧 `风险分流` 标签和缺省六列格式只作为兼容记录形式，不恢复多次独立门禁；固定字段、历史保护和严格检查语义以[阶段门规范](resources/skill/references/verification.md#step-0-与阶段门)为准。
 
+派发独立复核时显式传入推理强度，不依赖全局 subagent 默认值：安全、权限、隐私、资金、数据完整性等高风险复核使用 `high`，其他独立复核使用 `medium`。该分层只影响本次复核的思考强度，不改变是否复核或单次复核规则。
+
 使用 `check --strict-readiness` 做准入/CI/发布机械检查；默认检查兼容告警，机械通过不代替真实风险判断、业务验收或用户接受。
 
 ## Codex 使用方式

package/bin/plan-governance-cli.mjs

@@ -79,11 +79,23 @@ function loadManifest() {
 }
 
 function parseSetupArgs(args) {
+  if (args.length === 1 && ["-h", "--help"].includes(args[0])) {
+    console.log("用法：plan-governance-cli setup --target codex [--destination DIR] [--dry-run] [--force]");
+    return null;
+  }
+
   const options = { target: null, destination: null, dryRun: false, force: false };
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg === "--target") {
-      options.target = args[++index];
+      if (options.target !== null) {
+        throw new Error("setup 的 --target 只能指定一次");
+      }
+      const value = args[++index];
+      if (!value || value.startsWith("-")) {
+        throw new Error("setup 的 --target 缺少值");
+      }
+      options.target = value;
     } else if (arg === "--destination") {
       options.destination = args[++index];
     } else if (arg === "--dry-run") {
@@ -91,18 +103,14 @@ function parseSetupArgs(args) {
     } else if (arg === "--force") {
       options.force = true;
     } else if (arg === "-h" || arg === "--help") {
-      console.log("用法：plan-governance-cli setup --target codex|claude|all [--destination DIR] [--dry-run] [--force]");
-      return null;
+      throw new Error("setup 的 --help 必须单独使用");
     } else {
       throw new Error(`setup 不支持参数：${arg}`);
     }
   }
 
-  if (!options.target || !["codex", "claude", "all"].includes(options.target)) {
-    throw new Error("setup 必须指定 --target codex、claude 或 all");
-  }
-  if (options.destination && options.target === "all") {
-    throw new Error("--destination 只能与单个 setup target 一起使用");
+  if (options.target !== "codex") {
+    throw new Error("setup 仅支持 --target codex");
   }
   return options;
 }
@@ -112,12 +120,11 @@ function expandTarget(target) {
   return target.replace(/^~(?=\/|$)/, home);
 }
 
-function targetRoots(manifest, options) {
-  const names = options.target === "all" ? ["codex", "claude"] : [options.target];
-  return names.map((name) => ({
-    name,
-    root: resolve(options.destination ? options.destination : expandTarget(manifest.skill.targets[name])),
-  }));
+function targetRoot(manifest, options) {
+  return {
+    name: "codex",
+    root: resolve(options.destination ? options.destination : expandTarget(manifest.skill.targets.codex)),
+  };
 }
 
 function resourceFiles(manifest) {
@@ -148,17 +155,16 @@ function setup(args) {
 
   const plans = [];
   try {
-    for (const target of targetRoots(manifest, options)) {
-      for (const file of files) {
-        accessSync(file.source, constants.R_OK);
-        const destination = resolve(target.root, file.relative);
-        const existing = existsSync(destination) ? readFileSync(destination, "utf8") : null;
-        const sourceContent = readFileSync(file.source, "utf8");
-        if (existing !== null && existing !== sourceContent && !options.force) {
-          throw new Error(`目标文件存在本地差异，未覆盖：${destination}（如确认覆盖请加 --force）`);
-        }
-        plans.push({ target: target.name, destination, existing, sourceContent });
+    const target = targetRoot(manifest, options);
+    for (const file of files) {
+      accessSync(file.source, constants.R_OK);
+      const destination = resolve(target.root, file.relative);
+      const existing = existsSync(destination) ? readFileSync(destination, "utf8") : null;
+      const sourceContent = readFileSync(file.source, "utf8");
+      if (existing !== null && existing !== sourceContent && !options.force) {
+        throw new Error(`目标文件存在本地差异，未覆盖：${destination}（如确认覆盖请加 --force）`);
       }
+      plans.push({ target: target.name, destination, existing, sourceContent });
     }
   } catch (error) {
     return fail(error.message);

package/package.json

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

package/resources/manifest.json

@@ -2,8 +2,7 @@
   "manifestVersion": 1,
   "skill": {
     "targets": {
-      "codex": "~/.agents/skills/plan-governance",
-      "claude": "~/.claude/skills/plan-governance"
+      "codex": "~/.agents/skills/plan-governance"
     },
     "files": [
       "resources/skill/SKILL.md",

package/resources/skill/SKILL.md

@@ -13,7 +13,7 @@ description: 维护已有项目计划，或为需要跨阶段、跨会话协调
 
 首次接手读取地图、当前相关计划及必要契约；恢复只核对当前阶段、实际差异和最近证据。只实施已授权且准入的范围；实质边界变化时调整受影响计划，日常进展随工作同步。事实源与格式见 planning。
 
-按 verification 验证：普通改动自验，高风险或高影响的同一交付范围独立检查一次，修复由实施者自验；旧策略名和旧记录格式不改变此行为。适用检查通过后完成交付；未解决问题如实保留。交付说明完成结果、必要证据和剩余事项，明确约定的用户体验验收继续有效。
+按 verification 验证：普通改动自验，高风险或高影响的同一交付范围独立检查一次，修复由实施者自验；派发独立复核时显式传入推理强度，高风险用 `high`，其余用 `medium`。旧策略名和旧记录格式不改变此行为。适用检查通过后完成交付；未解决问题如实保留。交付说明完成结果、必要证据和剩余事项，明确约定的用户体验验收继续有效。
 
 ## 按需读取
 

package/resources/skill/references/cli.md

@@ -18,7 +18,7 @@
 
 ## 分发与资源
 
-SKILL、三个 references、agents 元数据与 assets 由同一 npm 包的 manifest 分发。`plan-governance-cli setup --target codex|claude|all --dry-run` 查看同步差异；实际覆盖需既有用户授权并按 setup 冲突提示处理，不自动清理用户目录残留。项目升级不迁移旧计划，受管块外内容必须保持。
+SKILL、三个 references、agents 元数据与 assets 由同一 npm 包的 manifest 分发。`plan-governance-cli setup --target codex --dry-run` 查看 Codex 同步差异；实际覆盖需既有用户授权并按 setup 冲突提示处理，不自动清理目标之外的用户目录。setup 只支持 Codex 单目标同步；项目初始化器只维护 `AGENTS.md`。项目升级不迁移旧计划，受管块外内容必须保持。
 
 仅更新计划格式不等于更新项目入口。已有项目在任务交接、没有进行中的实施或复核时更新受管入口；升级不批量回写历史，旧策略名和六列格式按 verification 解释为统一单次行为。安装副本与仓库开发规则有差异时说明本次选用来源，不能因版本号相同就混读正文。
 
@@ -54,7 +54,7 @@ plan-governance-cli init \
   --update-agent-rules-only
 ```
 
-升级已有项目的辅助文件，刷新 `scripts/check_plan_governance.py`、`CLAUDE.md` 和 `AGENTS.md`，但不覆盖 `docs/`：
+升级已有项目的辅助文件，刷新 `scripts/check_plan_governance.py` 和 `AGENTS.md`，但不覆盖 `docs/` 或其他代理入口：
 
 ```bash
 plan-governance-cli init \

package/resources/skill/references/verification.md

@@ -22,7 +22,7 @@
 
 同一交付范围只检查一次，通常在实现和自验收敛后、交付或高影响外部动作前；需要设计准入时将这一次前置，后续实施与完成自验。已审范围内的增量和修复合并处理，确有新增高风险范围才另行判断，不把每个修复拆成新范围；后续独立通过不能清除这一次检查留下的发现。
 
-授权明确时自动安排一名未参与实现或测试编写的只读复核者，提供范围、差异、风险和证据入口，并要求其自行完成、不得再委派复核。派发前复用已有同范围任务或结果；等待失败先核对准确任务 ID 与实际状态，只有确认原任务不存在或不可恢复才补发。冻结受审范围并告知变化。独立者给出发现后，实施者修复并验证原问题及受影响回归，不再送审，未解决则保持未完成。检查不可用/超时直接记录状态，不能伪填已完成结论；业务缺陷描述中的“超时”不代表检查未完成。复核不代替外部授权。
+授权明确时自动安排一名未参与实现或测试编写的只读复核者，提供范围、差异、风险和证据入口，并要求其自行完成、不得再委派复核。创建复核 subagent 时必须显式传入推理强度，不依赖全局默认：涉及安全、权限、隐私、资金、数据完整性或同类高风险后果时用 `high`，其他独立复核用 `medium`；推理强度不改变是否复核、复核次数或完成判定。派发前复用已有同范围任务或结果；等待失败先核对准确任务 ID 与实际状态，只有确认原任务不存在或不可恢复才补发。冻结受审范围并告知变化。独立者给出发现后，实施者修复并验证原问题及受影响回归，不再送审，未解决则保持未完成。检查不可用/超时直接记录状态，不能伪填已完成结论；业务缺陷描述中的“超时”不代表检查未完成。复核不代替外部授权。
 
 ## Step 0 与阶段门
 

package/scripts/init_plan_governance.py

@@ -19,8 +19,6 @@ VALID_STATUSES = {
     "已废弃",
 }
 
-CLAUDE_SECTION_BEGIN = "<!-- plan-governance:start -->"
-CLAUDE_SECTION_END = "<!-- plan-governance:end -->"
 AGENTS_SECTION_BEGIN = "<!-- plan-governance:start -->"
 AGENTS_SECTION_END = "<!-- plan-governance:end -->"
 
@@ -72,10 +70,6 @@ def managed_section(begin, end):
     return f"{begin}\n{agent_rules_body()}{end}\n"
 
 
-def claude_md_section():
-    return managed_section(CLAUDE_SECTION_BEGIN, CLAUDE_SECTION_END)
-
-
 def agents_md_section():
     return managed_section(AGENTS_SECTION_BEGIN, AGENTS_SECTION_END)
 
@@ -105,16 +99,6 @@ def update_managed_file(root, filename, section, begin, end):
     return target
 
 
-def update_claude_md(root):
-    return update_managed_file(
-        root,
-        "CLAUDE.md",
-        claude_md_section(),
-        CLAUDE_SECTION_BEGIN,
-        CLAUDE_SECTION_END,
-    )
-
-
 def update_agents_md(root):
     return update_managed_file(
         root,
@@ -126,7 +110,7 @@ def update_agents_md(root):
 
 
 def update_agent_rules(root):
-    return [update_claude_md(root), update_agents_md(root)]
+    return [update_agents_md(root)]
 
 
 def plan_map_content(plan_slug, title, status, phase):
@@ -303,19 +287,16 @@ def parse_args(argv):
     parser.add_argument("--status", default="设计中", choices=sorted(VALID_STATUSES), help="初始状态。")
     parser.add_argument("--phase", default="阶段 0", help="当前阶段名称。")
     parser.add_argument("--copy-checker", action="store_true", help="复制检查脚本到目标仓库 scripts/。")
-    parser.add_argument("--update-claude-md", action="store_true", help="创建或更新目标仓库 CLAUDE.md 中的计划治理规则。")
     parser.add_argument("--update-agents-md", action="store_true", help="创建或更新目标仓库 AGENTS.md 中的计划治理规则。")
-    parser.add_argument("--update-agent-rules", action="store_true", help="同时创建或更新 CLAUDE.md 和 AGENTS.md 中的计划治理规则。")
-    parser.add_argument("--update-claude-md-only", action="store_true", help="只创建或更新 CLAUDE.md，不初始化或覆盖 docs/。")
+    parser.add_argument("--update-agent-rules", action="store_true", help="创建或更新目标仓库 AGENTS.md 中的计划治理规则。")
     parser.add_argument("--update-agents-md-only", action="store_true", help="只创建或更新 AGENTS.md，不初始化或覆盖 docs/。")
-    parser.add_argument("--update-agent-rules-only", action="store_true", help="只创建或更新 CLAUDE.md 和 AGENTS.md，不初始化或覆盖 docs/。")
+    parser.add_argument("--update-agent-rules-only", action="store_true", help="只创建或更新 AGENTS.md，不初始化或覆盖 docs/。")
     parser.add_argument("--upgrade-existing", action="store_true", help="升级已有项目的辅助文件：刷新检查脚本和代理规则，不覆盖 docs/。")
     parser.add_argument("--migrate-plan-map-last-updated", action="store_true", help="将旧五列表 PLAN_MAP.md 迁移为包含最后更新的六列表。")
     parser.add_argument("--last-updated-date", default=date.today().isoformat(), help="迁移 PLAN_MAP.md 时填入的最后更新日期，默认今天。")
     parser.add_argument("--force", action="store_true", help="允许覆盖已存在的治理文件。")
     args = parser.parse_args(argv)
     only_modes = [
-        args.update_claude_md_only,
         args.update_agents_md_only,
         args.update_agent_rules_only,
         args.upgrade_existing,
@@ -332,12 +313,6 @@ def main(argv=None):
     args = parse_args(argv or sys.argv[1:])
     root = Path(args.root).expanduser().resolve()
 
-    if args.update_claude_md_only:
-        target = update_claude_md(root)
-        print(f"已写入：{target}")
-        print("CLAUDE.md 已更新；未修改 docs/。")
-        return 0
-
     if args.update_agents_md_only:
         target = update_agents_md(root)
         print(f"已写入：{target}")
@@ -390,11 +365,8 @@ def main(argv=None):
         created.append(copy_checker(root, args.force))
     if args.update_agent_rules:
         created.extend(update_agent_rules(root))
-    else:
-        if args.update_claude_md:
-            created.append(update_claude_md(root))
-        if args.update_agents_md:
-            created.append(update_agents_md(root))
+    elif args.update_agents_md:
+        created.append(update_agents_md(root))
 
     for path in created:
         print(f"已写入：{path}")