@prd-improve/cli 1.1.1 → 1.6.0

package/dist/schema/prd.js

@@ -1,14 +1,18 @@
 import { z } from "zod";
-import { metaSchema, backgroundAndGoalsSchema, userRoleSchema, inScopeItemSchema, outOfScopeItemSchema, entitySchema, mainFlowStepSchema, statePermissionSchema, businessRuleSchema, scenarioSchema, edgeCaseSchema, uiPageSchema, dataAndApiSchema, acceptanceCriterionSchema, openQuestionSchema, slugPattern, } from "./modules.js";
+import { metaSchema, backgroundAndGoalsSchema, userRoleSchema, inScopeItemSchema, outOfScopeItemSchema, entitySchema, mainFlowStepSchema, statePermissionSchema, businessRuleSchema, scenarioSchema, edgeCaseSchema, uiPageSchema, dataAndApiSchema, acceptanceCriterionSchema, openQuestionSchema, asBuiltDeviationSchema, slugPattern, } from "./modules.js";
 /**
- * 当前 schema 版本(v1.1 起 yaml meta 必带 team / project / feature 三 slug)。
- * 仍接受 v0.1 以支持 `prd migrate-yaml` 升级前的存量 yaml(spec §3.2 backward compat)。
+ * 当前 schema 版本(v0.3 起支持 lifecycle shipped 枚举 + open_questions resolution + as_built 模块)。
+ * 仍接受 v0.1 / v0.2 以支持存量 yaml 向后兼容(spec §3.2 backward compat)。
+ * v0.2 起强制 meta.team / project / feature 三 slug;v0.1 豁免。
  */
-export const SCHEMA_VERSION_CURRENT = "v0.2";
+export const SCHEMA_VERSION_CURRENT = "v0.3";
+export const SCHEMA_VERSION_V02 = "v0.2";
 export const SCHEMA_VERSION_LEGACY = "v0.1";
+/** validate / runner 共用的版本白名单单一真相源(v1.21 I1:根治字面 drift)。 */
+export const SCHEMA_VERSIONS_ACCEPTED = [SCHEMA_VERSION_LEGACY, SCHEMA_VERSION_V02, SCHEMA_VERSION_CURRENT];
 export const PrdSchema = z
     .object({
-    schema_version: z.enum([SCHEMA_VERSION_LEGACY, SCHEMA_VERSION_CURRENT]),
+    schema_version: z.enum(SCHEMA_VERSIONS_ACCEPTED),
     meta: metaSchema,
     background_and_goals: backgroundAndGoalsSchema,
     users_and_roles: z.array(userRoleSchema),
@@ -24,11 +28,36 @@ export const PrdSchema = z
     data_and_api: dataAndApiSchema,
     acceptance_criteria: z.array(acceptanceCriterionSchema),
     open_questions: z.array(openQuestionSchema),
+    as_built: z.array(asBuiltDeviationSchema).optional(),
 })
     .strict()
     .superRefine((doc, ctx) => {
-    // v0.1 keeps the legacy free-form meta(向后兼容);v0.2 起强制 slug.
-    if (doc.schema_version !== SCHEMA_VERSION_CURRENT)
+    const ver = doc.schema_version;
+    // === 1. v0.3-only 字段/枚举值降级门(v0.1 / v0.2 文件带 v0.3 内容 → 引导 migrate) ===
+    if (ver !== SCHEMA_VERSION_CURRENT) {
+        const offend = (path) => ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path,
+            message: `该字段/值属于 schema v0.3,当前文件是 ${ver}。请先运行 prd migrate-yaml 升级`,
+        });
+        if (doc.as_built !== undefined)
+            offend(["as_built"]);
+        const lc = doc.meta.lifecycle;
+        if (lc.shipped_at !== undefined)
+            offend(["meta", "lifecycle", "shipped_at"]);
+        if (lc.landed_commit !== undefined)
+            offend(["meta", "lifecycle", "landed_commit"]);
+        if (lc.status === "shipped")
+            offend(["meta", "lifecycle", "status"]);
+        doc.open_questions.forEach((q, i) => {
+            if (q.resolution !== undefined)
+                offend(["open_questions", i, "resolution"]);
+            if (q.resolved_at !== undefined)
+                offend(["open_questions", i, "resolved_at"]);
+        });
+    }
+    // === 2. slug 三件套强制(v0.2 与 v0.3 同强度;v0.1 legacy 豁免) ===
+    if (ver === SCHEMA_VERSION_LEGACY)
         return;
     const meta = doc.meta;
     // team 必填 + 必须是 slug
@@ -61,5 +90,20 @@ export const PrdSchema = z
             message: "meta.feature 必须 kebab-case slug:首字母 a-z,只含 a-z 0-9 -,长度 2-64",
         });
     }
+    // === v1.23 S1:交付字段矛盾态门(shipped_at/landed_commit 是 shipped 的伴生字段) ===
+    if (ver === SCHEMA_VERSION_CURRENT) {
+        const lc = doc.meta?.lifecycle;
+        if (lc && lc.status !== "shipped") {
+            for (const f of ["shipped_at", "landed_commit"]) {
+                if (typeof lc[f] === "string" && lc[f].trim() !== "") {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        path: ["meta", "lifecycle", f],
+                        message: `lifecycle.status 为 ${lc.status ?? "(missing)"} 时不应存在 ${f}(交付字段仅伴随 shipped;reopen 会自动清除)`,
+                    });
+                }
+            }
+        }
+    }
 });
 //# sourceMappingURL=prd.js.map

package/dist/schema/prd.js.map

@@ -1 +1 @@
-{"version":3,"file":"prd.js","sourceRoot":"","sources":["../../src/schema/prd.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prd.js","sourceRoot":"","sources":["../../src/schema/prd.ts"],"names":[],"mappings":"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"}

package/dist/skill/prd-improve-forge/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: prd-improve-forge
-description: Use when the user wants to write, refine, or structure a PRD for a specific feature — turning vague ideas, meeting notes, chat snippets, or legacy docs into a complete, edge-case-specified requirements spec. Unlike generic PRD helpers, it drives multi-round boundary questioning (P0/P1/P2 priorities) through feature-type checklists and produces a structured YAML spec, not free-form Markdown. Triggers on phrases like '写 PRD'、'整理需求'、'规范化需求'、'把 X 整理成 PRD'、'梳理功能边界'、'会议纪要整理成需求'、'聊天记录整理成 PRD'、'把这个想法变成规格'、'帮我做需求规格化' or English equivalents. Also handles refresh mode — updating an existing PRD against a new or changed PRD version — triggered by '同步新版 PRD'、'重新 sync'、'基于新版 PRD 更新'、'PRD 改了'、'PRD 升级了'、'feature 升级'、'对齐 PRD'、'incorporate PRD changes' or equivalents. DO NOT trigger for: (a) general product strategy / OKR / roadmap discussion with no specific feature scope; (b) writing code, implementation, architecture, or technical design docs; (c) editing a single field of an already-finalized PRD; (d) high-level vision documents or pitch decks; (e) a near-total rewrite of an existing PRD (start a fresh PRD instead).
+description: Use when the user wants to write, refine, or structure a PRD for a specific feature — turning vague ideas, meeting notes, chat snippets, or legacy docs into a complete, edge-case-specified requirements spec. Unlike generic PRD helpers, it drives multi-round boundary questioning (P0/P1/P2 priorities) through feature-type checklists and produces a structured YAML spec, not free-form Markdown. Triggers on phrases like '写 PRD'、'整理需求'、'规范化需求'、'把 X 整理成 PRD'、'梳理功能边界'、'会议纪要整理成需求'、'聊天记录整理成 PRD'、'把这个想法变成规格'、'帮我做需求规格化' or English equivalents. Also handles refresh mode — updating an existing PRD against a new or changed PRD version — triggered by '同步新版 PRD'、'重新 sync'、'基于新版 PRD 更新'、'PRD 改了'、'PRD 升级了'、'feature 升级'、'对齐 PRD'、'incorporate PRD changes' or equivalents. Also handles closeout mode — closing out a delivered feature's PRD (backfilling open-question resolutions, recording as-built deviations, marking it shipped) — triggered by '收尾'、'交付收口'、'closeout'、'上线了把 PRD 收口'、'把这个 feature 收口'、'标记 shipped' or English equivalents ('close out the PRD', 'mark it shipped', 'post-delivery wrap-up'). DO NOT trigger for: (a) general product strategy / OKR / roadmap discussion with no specific feature scope; (b) writing code, implementation, architecture, or technical design docs; (c) editing a single field of an already-finalized PRD; (d) high-level vision documents or pitch decks; (e) a near-total rewrite of an existing PRD (start a fresh PRD instead).
 ---
 
 # PRD Improve Forge
 
 把一个功能从**模糊想法**推进到**可开发、可测试、可追溯**的结构化 PRD。
-产出文件符合 PRD Improve schema v0.2,可直接被 `prd validate` / `prd freeze` / `prd context` 等 CLI 命令消费。
+产出文件符合 PRD Improve schema v0.3,可直接被 `prd validate` / `prd freeze` / `prd context` 等 CLI 命令消费。
 
 ## 适用与不适用
 
@@ -30,6 +30,8 @@ description: Use when the user wants to write, refine, or structure a PRD for a
 
 按以下顺序判定:
 
+0. **触发词 ∈ closeout 集合 + `working/prd.yaml` 存在且 frozen/ 下 ≥1 版** → closeout 模式 → 跳第 8 步
+   （working 不存在或从未 frozen → 告知用户「该 feature 还没有可收口的 PRD」,转白板/正常流程）
 1. **触发词 ∈ refresh 集合 + `working/prd.yaml` 存在** → refresh 模式 → 跳第 7 步
 2. **触发词 ∈ refresh 集合 + `working/prd.yaml` 不存在** →
    询问用户「未找到现有 yaml,确认要走白板模式从 0 生成吗?」
@@ -55,7 +57,9 @@ description: Use when the user wants to write, refine, or structure a PRD for a
 | 单字段修订(只改 owner / 改 AC-7) | 直接 edit yaml 或用 `prd` CLI |
 | 现有 yaml 不存在 | fallback 白板 + 明确告知 |
 
-#### 1.2 (白板模式)识别功能主类型
+**closeout 触发词集合**:"收尾" / "交付收口" / "closeout" / "上线了把 PRD 收口" / "把 X 收口" / "标记 shipped" / "close out" / "mark shipped" / "post-delivery wrap-up"
+
+#### 1.2a (白板模式)识别功能主类型
 
 从用户输入中提取特征,判定功能类型并决定加载哪份 checklist:
 
@@ -68,12 +72,47 @@ description: Use when the user wants to write, refine, or structure a PRD for a
 
 若识别不出或跨多类型 → 仅依赖模板自身的 [必填] 字段驱动追问,并在 open_questions 加一条"功能类型不明,可能需要定制 checklist"。
 
+#### 1.2b (白板模式)识别正交维度
+
+在 1.2a 之外,再扫描一遍「横切关注点」信号,**可命中 0-N 个维度**,与功能类型独立叠加:
+
+| 信号关键词 / 场景 | 维度 | checklist 文件 |
+|---|---|---|
+| 外部 API / 第三方 / 调另一(微)服务 / SDK / webhook / 回调 / 消息队列 / 异步任务 / 超时 / 重试 / 降级 / 兜底 / 离线 / 网络异常 | 集成接缝 | `checklists/dimensions/integration-seam.md` |
+| 计数器 / 次数 / 重试上限 / 配额 / 额度 / 剩余次数 / 状态切换 / 开关 / 生命周期 / 状态机 / 流转 / 耗尽 / 达上限 / 锁定 / 冷却 / 倒计时 | 状态机·计数器 | `checklists/dimensions/state-machine-counter.md` |
+
+- 维度与功能类型**正交**:一个 batch-import 也可能同时命中集成接缝,两类清单叠加加载。
+- 与 1.2a 不同,**维度识别不出就不挂载**(不兜底、不强加 open_question),宁缺毋滥。
+- 命中多个维度时,各自的「精选 P0」按 §1.2b 表自上而下顺序追加。
+
+#### 1.3 (白板模式)体量分流:全量 vs 轻模式
+
+判定本次是否走**轻模式**(只问核心段,跳过结构性模块):
+
+**轻模式判据**(任两项命中即建议,由用户一票确认/否决):
+- 预计验收标准 ≤ 8 条
+- 单页交互或无 UI
+- 不引入新实体(纯行为 / 展示 / 文案改动)
+- 用户明示「小功能 / 快速过 / 别整太重」
+
+命中 → 向用户确认:「这个 feature 体量不大,建议走轻模式:只问核心边界(目标 / 范围 / 验收 / 待定问题),跳过实体、状态机、业务规则等结构段,需要时随时补。可以吗?」
+
+**轻模式执行差异**(全量模式不变):
+- **第 3 步追问**:只走 P0,1-2 轮、≤ 10 题封顶;checklist 仍加载但只取 P0 行
+  - 命中的正交维度仍贡献其「精选 P0」(轻模式最不该跳的高 ROI 边界),但纳入 ≤10 题总封顶统一计数(精选 P0 优先于 feature-type 的非 Top 行)
+- **第 4 步填充**:核心段 = `meta / background_and_goals / users_and_roles(可单条)/ in_scope / out_of_scope / acceptance_criteria / open_questions`;其余 7 模块(`entities / main_flow / state_permissions / business_rules / scenarios / edge_cases / ui_interaction`)写**显式空数组** `[]`,`data_and_api` 四子数组留空。在第一个空模块上方加一行注释 `# lite 模式略过,需要时可后补`(只加一次,不逐模块重复)
+- **命中维度的硬约束落点**:第 3 步精选 P0 若问出硬约束(计数器上限 / 接缝失败行为 / 超时阈值等),落到 `acceptance_criteria`(可验收条款)或 `open_questions`(未定项),**不因 business_rules / edge_cases / data_and_api 在轻模式为空而丢弃**;若注入后 AC 将 > 8 条(即下方「中途升级」同一阈值)→ 转全量补 business_rules / edge_cases
+- **收尾知会**:明示「轻模式产物,prd validate 可过(out_of_scope 为空仅 warning);后续 feature 长大可随时全量补段」
+
+**中途升级**:问询中发现判据失效(冒出新实体 / 验收膨胀到 >8)→ 明示转全量,补问对应结构段。轻模式与 1.2a 末「类型不明」分支正交,可叠加。
+
 ### 第 2 步:强制加载资源
 
 **必须读完以下三份文件再开始追问:**
 
 1. `templates/prd.yaml` — 骨架结构、字段定义、标记约定
 2. `checklists/<type>.md` — 该类型功能的边界追问清单
+   - 命中的每个正交维度:额外加载 `checklists/dimensions/<dim>.md`(相对路径同 feature-type 清单)
 3. `examples/import-history-prds.prd.yaml` — 金标准范例(仅参考结构,**不照抄具体值**)
 
 **资源定位协议(跨平台路径自适应,按顺序尝试):**
@@ -115,10 +154,13 @@ description: Use when the user wants to write, refine, or structure a PRD for a
 - 有选项的题给选项(`A / B / C / D / 其他`),不要开放题
 - 每轮结束做"已确认的关键决策"摘要,让用户确认或修正
 - 用户说"够了"或"直接生成"即停止,未答问题进 `open_questions`
+- **正交维度的精选 P0 注入**:dimension 清单挂载时,**只把它的「精选 P0」(≤3 题)注入当轮追问**;其余 P0/P1/P2 降为「可选补问」——仅当用户对该维度深入、或精选 P0 回答暴露更多边界时才展开。feature-type 清单仍走全量 P0。
+- **多维度重叠去重**:多维度命中时各取精选 P0 顺序追加;若与 feature-type 的 P0 语义重叠,保留 feature-type 版本,维度版跳过避免重复问。
+- **AC priority 按测试赋值**:收集到验收标准时,按规则 9 的 launch-blocker 测试逐条定 must / should / could,**不要默认 must**;可顺带问「这条不达标会不会拦住上线?」帮 PM 自己分级。
 
 **追问数量与优先级**(优先级冲突时按以下顺序让步):
 
-1. **P0 必须问完**(checklist 中所有 P0,通常 5-10 题,跨 1-2 轮) — 不可裁剪,P0 未答完不进 P1
+1. **P0 必须问完**(feature-type checklist 中所有 P0,通常 5-10 题,跨 1-2 轮) — 不可裁剪,P0 未答完不进 P1;**正交维度只注入其精选 P0(≤3),见上「正交维度的精选 P0 注入」,不适用本条**
 2. **P1 按预算挑选**(剩余轮次内挑 6-10 题最相关的) — 用户表现配合就多问,显疲态就跳过
 3. **P2 仅当用户积极时问**(2-3 题点缀)— 用户说"够了"立即停止,P2 未答的全进 `open_questions` 标 `non_blocking`
 
@@ -137,6 +179,7 @@ description: Use when the user wants to write, refine, or structure a PRD for a
 - **可删**:完成填写后的 `[必填] / [选填] / [PM 填] / [CLI 管] / [机器读]` 任务标记注释(这些是给写作者看的脚手架,定稿后无信息量)
 - 长文本用 YAML block style `|`(如 `background`、大段 `rule`)
 - ID 前缀严格遵守:EN / S / R / SC / E / UI / AC / Q / DC / API / PC / SEC
+- **填完 `acceptance_criteria` 做规则 9 的 calibration 复盘**:自算 must / should / could 分布,must 占压倒比例时逐条用 launch-blocker 测试复核并向 PM 提降级建议(不擅改)。
 
 **具体决策值必须来自用户**。用户没说的,放进 `open_questions`,不要代为决策。
 
@@ -158,9 +201,10 @@ description: Use when the user wants to write, refine, or structure a PRD for a
 生成完毕后告诉用户:
 
 1. 文件路径
-2. 模块规模(各段填了多少条)
+2. 模块规模(各段填了多少条);**AC priority 分布(N must / M should / K could)**——若 must 占压倒比例且未复盘,提示 PM 按 launch-blocker 测试(规则 9)再过一遍
 3. blocking 级 open_questions 的数量和清单
 4. 建议下一步:回答 blocking → `prd validate` → `prd freeze`
+5. 若下游走 superpowers 执行链:freeze 后用 `prd export <slug> --out docs/specs/YYYY-MM-DD-<slug>-design.md` 生成 spec 骨架(需求段自动填好,只需续写方案评估 / 架构 / 验证清单等工程段),续写完进 writing-plans;之后需求若变更,先改 prd.yaml 再 `prd export <slug> --out <同路径> --force` 重导(会覆盖,注意保留人工续写段)
 
 ### 第 7 步:refresh 工作流
 
@@ -256,7 +300,60 @@ AI 在 7.4 完成后,**必须输出**:
 
 ---
 
-## 硬规则(8 条,违反即为 Skill 执行错误)
+### 第 8 步:closeout 工作流(交付收尾)
+
+#### 8.0 前置检查
+- `.prd/features/<slug>/working/prd.yaml` 存在且 frozen/ 下 ≥1 版,否则转出
+- schema_version 是 v0.3?不是 → 先引导 `prd migrate-yaml <slug>`(v0.2→v0.3 是离线纯版本号变更)
+- 定位落地 merge commit:问用户;用户不确定时从 `git log --oneline --merges -10` 提候选给用户挑
+
+#### 8.1 决议提取(证据源分级降级,不依赖特定工作流习惯)
+为每条 open_question 起草 resolution 草稿,注明来源指针。证据源按优先级:
+1. dev-log(若用户有该习惯)— 最优,含决策叙事
+2. git 考古 — commit message + frozen 版至落地 commit 的代码 diff
+3. 当前会话上下文 — closeout 紧跟实施时
+4. 全部缺位 → 退化为纯逐条问询:AI 只当记录员,逐条念 Q 问用户
+起草不出的标"未找到决议"。as-built 核对(8.3)同此分级。
+- **跨 feature 核查**:检查该 Q 是否已被**后续 feature** 解决(线索:同仓后续 PRD 的 resolution/正文、dev-log 中后续批次记录)——单 feature 证据流程不保证发现,批量收口时由编排者在各 agent prompt 里显式喂线索
+
+#### 8.2 PM 逐条拍板(复用 7.5 范式)
+每条 Q:**采纳草稿 / 改写 / 显式 carry-over(填 deferred_to)**。
+拍板后逐条执行 `prd resolve <slug> <qid> --text "<决议>"`(已决)或 `prd resolve <slug> <qid> --defer "<去向>"`(carry-over)。CLI 自动写 resolved_at、保注释、长文本块标量;改判已决的加 `--force`。**不要手编 yaml**(CLI 不可用时才降级行级编辑,注意块标量缩进与防重跑)。
+- 无论哪种,拍板即写 `resolved_at: "<今天 YYYY-MM-DD>"`(CLI 门禁的收口痕迹要求)
+- 判定口径:resolution 非空 ⇒ 已决(起草期残留的 deferred_to 占位可保留,CLI 按此口径忽略);resolution 空 + deferred_to 非空 ⇒ carry-over
+- carry-over 必须是 PM 显式决定,不可拿起草期 deferred_to 占位充数
+
+#### 8.3 as-built 偏差核对
+AI 先按 8.1 证据源自查偏差候选(实施与 AC/R 条款不一致处),逐条过用户,确认后写顶层 `as_built` 区:
+
+    as_built:
+      - id: "AB-1"
+        deviates_from: "AC-3"        # 被偏离的条款 ID(引用校验会查存在性)
+        actual: "一句话竣工实况"
+        evidence: "dev-log/2026-06-09-xxx.md"   # 建议仓库相对路径(可移植)
+
+PRD 正文条款**不改**(设计决策史保留)——as_built 是竣工误差表,不是校对版。
+
+#### 8.4 CHANGELOG
+working/CHANGELOG.md 不存在 → 先创建(`# Changelog` + `## [Unreleased]` 骨架)。
+往 [Unreleased] 写 closeout 条目:决议数 / carry-over 数 / 偏差数 / landed commit。
+
+#### 8.5 执行 + 收尾
+1. 写盘 working/prd.yaml(8.2/8.3 的全部改动)
+2. 跑 `prd closeout <slug> --commit <hash> --auto`
+3. 转告收口报告:竣工版号 / N 决议 / M carry-over / K 偏差 / CHANGELOG 状态
+失败时转告 stderr(CLI 已含回滚与恢复提示),不要自行重试改盘。
+
+#### 8.6 refresh 联动(shipped 之后再迭代)
+refresh 一个已 shipped 的 feature 时:working 的 `lifecycle.status` 回 `"draft"`、删除 `shipped_at` / `landed_commit` 两行(上一轮交付事实由 frozen 链 + manifest 承载,不丢)。这是 `prd freeze` shipped 守卫指引的路;CLI 的 `prd refresh` 命令是索引报告,不修改 yaml。
+
+#### 8.7 批量收口变体(N feature 一轮)
+
+N 个 feature 同时收口时:每 feature 派一个 8.1 证据提取 agent 并行起草(prompt 附跨 feature 线索)→ 全表一轮拍板(按 feature 分组列决议草稿带证据指针,用户一次过)→ 逐 feature 执行 8.3-8.5。实测 9 feature 30 条决议 1 轮交互即可完成。
+
+---
+
+## 硬规则(9 条,违反即为 Skill 执行错误)
 
 ### 规则 1:不照抄范例的具体占位值
 
@@ -278,11 +375,13 @@ template 标 `[CLI 管]` 的字段由 CLI 维护,AI 不得手填具体运行值
 
 | 字段 | 生成时填什么 |
 |---|---|
-| `schema_version` | `"v0.2"` |
+| `schema_version` | `"v0.3"` |
 | `meta.team` | (PM 提供的 team slug,kebab-case,如 `prd-improve`) |
 | `meta.lifecycle.version` | `"working"` |
 | `meta.lifecycle.status` | `"draft"` |
 | `meta.lifecycle.updated_at` | `""` (留空,CLI 首次写入时填充) |
+| `meta.lifecycle.shipped_at` / `landed_commit` | **不填**(closeout 收口时由 CLI 写入) |
+| `open_questions[].resolution` / `resolved_at` | 白板期**不填**(closeout 模式 8.2 拍板时写) |
 
 其他 `[CLI 管]` 字段一律 `""` 或 `[]`。
 
@@ -447,6 +546,33 @@ refresh 模式下,**因 PRD 删除 / 修改 + refers_to 引用关系**而产生
 
 **与 7.5「批量接受」的边界**:批量接受只限**同一类同一字段**的变化(如"批量接受 12 处自动考核相关字段的删除"),**不跨字段联动**;refers_to 反向图中的"被引用字段"必须单独逐条决策。
 
+### 规则 9:AC priority 分级纪律(防 must 通胀)
+
+每条验收标准的 `priority` 很容易被习惯性填成 `must`,导致 **must 通胀**——当几乎所有 AC 都是 must,MoSCoW 优先级信号失效,`prd context` 的 Must Build 清单按 priority 过滤等于没过滤,排期 / 砍范围时无从取舍。
+
+**launch-blocker 测试(逐条赋值的判定锚点):**
+
+- `must` = 不达标就**不能发版 / 要回滚**(launch-blocker)
+- `should` = **能发版**,但是已知且可接受的缺口
+- `could` = 锦上添花,可以悄悄砍掉
+
+**坏例子**(真实 dogfood):
+```
+81 AC = 68 must / 13 should / 0 could(84% must)
+→ 几乎全是 must,排期取舍时无从下手,MoSCoW 等于没分级
+```
+
+**好例子**:逐条过 launch-blocker 测试,真正阻塞上线的才留 must,其余降 should / could(范例 `examples/import-history-prds.prd.yaml` 的 6 must / 3 should / 1 could 即此测试的产物,不是凑出来的配比)。
+
+**calibration 复盘(草拟完全部 AC 后做一次):**
+1. 自算 must / should / could 三数。
+2. 当 must 占压倒比例(可参照范例 ~60% 作软触发线,**非门槛**)时,逐条用 launch-blocker 测试复核 must 项,把「失败也照样能发版」的挑出来。
+3. 向 PM 提降级建议,**由 PM 拍板,AI 不擅自改 priority**(沿用硬规则总则:具体决策值来自用户)。
+
+**不设硬配额**:AC 条数 ≠ 工作量,数字配额可被「拆 1 条 must 成 2 条 should」规避;**launch-blocker 测试本身才是锚点**,~60% 只是触发复盘的软参考,不作 pass/fail 门槛。
+
+**轴区分**:must / should / could(这条该不该**发**)与第 3 步追问的 P0 / P1 / P2(这个问题该不该**问**)是正交两轴——一条 P0 问题(必须问)的答案,既可能落成 must AC 也可能落成 should AC。别把「P0 问题」机械等同「must AC」(这正是通胀的隐性推手)。
+
 ---
 
 ## 未回答问题的去向
@@ -588,13 +714,22 @@ refresh 模式下,**因 PRD 删除 / 修改 + refers_to 引用关系**而产生
 | **ChatGPT / Custom GPT** | SKILL.md 作为 system prompt;三个子目录上传为 knowledge |
 | **Codex / Antigravity** | SKILL.md 内容放 system prompt / rules;子目录放项目根 |
 
-**核心工作流不变**:识别模式 + 类型 → 加载资源 → (长材料先摘要) → 分轮追问 / refresh diff → 严格遵守 8 条硬规则 → 输出到 `.prd/features/<slug>/working/prd.yaml`(白板)或就地更新 + CHANGELOG append(refresh)。
+**核心工作流不变**:识别模式 + 类型 → 加载资源 → (长材料先摘要) → 分轮追问 / refresh diff → 严格遵守 9 条硬规则 → 输出到 `.prd/features/<slug>/working/prd.yaml`(白板)或就地更新 + CHANGELOG append(refresh),或决议回填 + `prd closeout`(closeout)。
 
 ---
 
 ## 版本与维护
 
-**当前版本:** SKILL.md v0.2 · 对应 schema_version v0.2(refresh mode added 2026-05-12)
+**当前版本:** SKILL.md v0.10 · 对应 schema_version v0.3(resolve command + batch closeout 2026-06-12 + v0.6 正交维度层 + v0.7 priority 分级纪律 + v0.8 source_materials 可移植性 + v0.9 data_and_api.applies_to 注释准确化 + v0.10 轻模式×维度落点指引)
+
+**变更历史:**
+- v0.10 — 轻模式 × 命中维度的硬约束落点指引:精选 P0 问出的硬约束落 acceptance_criteria / open_questions(不因结构段轻模式为空而丢弃),撑不进 AC 即触发中途升级;两份 dimension 清单挂载协议同步补轻模式落点。修协议冲突
+- v0.9 — data_and_api.applies_to 注释逐行准确化:data/api/security 明确 EN-* only + 校验失败提示;performance 明确不做引用校验
+- v0.8 — source_materials.url 注释提示可移植路径(仓库相对 / PRD 章节锚点,避免本机绝对路径)+ 范例演示;推广 v1.21 as_built.evidence 同款提示
+- v0.7 — 加规则 9(AC priority 分级纪律):launch-blocker 测试 + calibration 复盘,防 must 通胀;template priority 注释收紧
+- v0.6 — 加正交维度层(1.2b 维度识别 + integration-seam/state-machine-counter 两份 dimension + 精选 P0 注入协议)
+- v0.5 — 加轻模式体量分流(1.3) + 第 6 步 superpowers 执行链 handoff(prd export)
+- v0.4 — resolve command + batch closeout 2026-06-12
 
 **支持的 checklist 类型:**
 - [x] `batch-import` (批量导入)
@@ -602,9 +737,14 @@ refresh 模式下,**因 PRD 删除 / 修改 + refers_to 引用关系**而产生
 - [ ] `permission` (权限,规划中)
 - [ ] `notification` (通知,规划中)
 
+**支持的 dimension 维度(正交,与上面类型叠加):**
+- [x] `integration-seam`(集成接缝)
+- [x] `state-machine-counter`(状态机·计数器)
+
 **何时需要更新本 Skill:**
 
-1. **新功能类型出现** → 添加新 checklist 文件,本 SKILL.md 第 1 步的识别表加一行
+1. **新功能类型出现** → 添加新 checklist 文件,本 SKILL.md §1.2a/§1.2b 的识别表加一行
+   - **先判它是「功能类型」还是「正交维度」**:功能类型 = 与其他类型**互斥**,答「这个 feature *是* 什么」(批量导入、审批流)→ 放 `checklists/` 根 + §1.2a 表;正交维度 = 可与任意类型**叠加**,答「这个 feature *涉及* 什么横切关注点」(有外部依赖、有计数器)→ 放 `checklists/dimensions/` + §1.2b 表 + 必带「精选 P0」(≤3)。
 2. **模板 schema 升级** → 同步升级 schema_version,检查所有 checklist 引用的字段是否还存在
 3. **反复踩同一个坑** → 在"硬规则"段新增一条并给坏例子 / 好例子
 4. **触发不准** → 修改 frontmatter 的 description,连续观察 2 周

package/dist/skill/prd-improve-forge/checklists/batch-import.md

@@ -147,6 +147,7 @@
 
 → 答案落到 `acceptance_criteria` / `data_and_api.security_constraints`
 
+- 判定每条 AC 的 priority 时套用 SKILL.md 规则 9 的 launch-blocker 测试(不达标就不能发版=must),别默认全填 must。
 - **[P0]** 怎么判断一次任务"成功"?需要达到多少成功率阈值?
 - **[P1]** 开发需要哪些日志 / 指标来排查问题?
 - **[P1]** 测试需要哪些固定数据样例来做回归?
@@ -192,4 +193,4 @@
 3. 如果某 P1 问题频繁被用户答不上来,升级为 P0
 4. 如果某类功能(如"跨系统同步")与批量导入差异过大,拆出独立 checklist(如 `checklists/cross-system-sync.md`)
 
-当前版本:v0.1 · 本清单与 `templates/prd.yaml` (schema_version v0.2) 对齐
+当前版本:v0.1 · 本清单与 `templates/prd.yaml` (schema_version v0.3) 对齐

package/dist/skill/prd-improve-forge/checklists/dimensions/integration-seam.md

@@ -0,0 +1,131 @@
+# 集成接缝 · 边界追问维度清单(正交维度)
+
+> 本清单是「正交维度」,与功能类型清单(如 batch-import)叠加使用——一个功能可同时是某类型 + 命中本维度。
+> 由 PRD Skill 在检测到「外部依赖 / 网络接缝」信号时自动加载。
+> **挂载协议:只把「精选 P0(≤3 条,单条可含 2-3 个子问)」注入当轮追问;其余 P0/P1/P2 为可选补问。**
+> 所有答案最终落到 prd.yaml 对应模块,Skill 不要凭空生成答案。
+> **轻模式例外**:精选 P0 的硬约束落点改为 `acceptance_criteria` / `open_questions`(对应结构段在轻模式为空)。
+> 追问执行协议(每轮 ≤3-5 题、P0 先、有选项给选项、答不上转 open_questions)沿用 batch-import.md 的「使用原则」段;本维度额外只注入精选 P0。
+
+---
+
+## 触发加载条件
+
+当功能描述中出现以下特征之一,Skill 应加载本维度清单:
+
+- 关键词:外部 API / 第三方 / 调另一个(微)服务 / SDK / webhook / 回调 / 消息队列 / MQ / 异步任务 / 超时 / 重试 / 降级 / 兜底 / 离线 / 网络异常 / 不可达。
+- 功能依赖一个**不由本模块掌控的运行时**(支付网关、短信、AI 推理、对象存储、地图、推送、登录第三方)。
+- 跨进程 / 跨服务 / 跨网络的读写。
+- 有「在线/离线」「连通/不可达」状态切换。
+- 典型功能:接入支付、AI 能力调用(带超时)、第三方登录、消息推送、文件传对象存储、跨服务数据同步、离线表单提交。
+
+---
+
+## Q 清单(按 prd.yaml 模块归类)
+
+### 1. 接缝清单与契约
+
+→ `entities` / `data_and_api.api_constraints`
+
+- **[P0]** 本功能依赖哪些外部接缝?逐个列出(服务名 / 用途 / 同步 or 异步)。
+- **[P0]** 每个接缝的「成功响应」长什么样?字段契约是否固定?
+- **[P1]** 契约由谁拥有 / 可能怎么变?是否版本化?
+- **[P2]** 是否有 mock / sandbox 环境供测试?
+
+### 2. 失败模式枚举
+
+→ `edge_cases` / `scenarios`
+
+- **[P0]** 每个接缝可能怎么失败?(超时 / 5xx / 4xx / 限流 429 / 部分成功 / 返回体畸形或字段缺失 / 连接失败)
+- **[P0]** 每种失败本功能怎么表现?(报错 / 重试 / 降级 / 静默 / 入队补偿)
+- **[P1]** 「返回 200 但 body 语义是失败」怎么识别?
+- **[P1]** 区分「可恢复 / 不可恢复」失败的依据?
+
+### 3. 超时·重试·幂等
+
+→ `business_rules` / `data_and_api.performance_constraints`
+
+- **[P0]** 每个接缝的超时阈值?(秒)
+- **[P0]** 失败是否重试?重试次数 / 退避策略?(与状态机·计数器维度的计数器联动)
+- **[P0]** 重试 / 重复提交是否幂等?幂等键是什么?
+- **[P1]** 重试期间用户看到什么?
+
+### 4. 降级与兜底
+
+→ `business_rules` / `scenarios`
+
+- **[P0]** 接缝不可用时本功能能否降级运行?降级形态?(只读 / 缓存 / 本地暂存 / 排队后补 / 直接拒绝)
+- **[P1]** 降级态如何恢复?自动重连还是用户手动?
+- **[P1]** 降级期间产生的数据如何与恢复后对账?
+
+### 5. 跨状态组合枚举
+
+→ `edge_cases` / `ui_interaction`
+
+- **[P0]** 把「连通性状态 × 业务错误类型」做成组合表,逐格定义展示与行为——防文案与按钮/行为打架、防某组合是死代码(反面教材:离线 × 识别失败 → 标题「识别失败」但只有「保存本地」按钮)。
+- **[P1]** 每个组合的文案 / 可用操作 / 默认动作是否自洽?
+- **[P2]** 有没有「理论上不可能但代码里能进」的组合?(死分支审计)
+
+### 6. 接缝处鉴权与安全
+
+→ `data_and_api.security_constraints`
+
+- **[P0]** 接缝鉴权方式?token / 密钥怎么存、谁能访问?
+- **[P0]** token / 凭证过期时本功能怎么处理?(自动刷新 / 报错 / 重新授权)
+- **[P1]** 接缝传输的数据是否含敏感字段?加密 / 脱敏?
+- **[P2]** 第三方回调如何验签防伪造?
+
+### 7. 可观测与排查
+
+→ `acceptance_criteria` / `data_and_api.performance_constraints`
+
+- **[P0]** 接缝调用失败时,排查需要哪些日志 / trace?(请求 ID / 接缝名 / 耗时 / 错误码)
+- **[P1]** 接缝健康度有无监控 / 报警?(失败率 / P99 延迟阈值)
+- **[P2]** 是否需要熔断 / 限流保护本功能不被拖垮?
+
+---
+
+## 精选 P0(Top 3 必问)
+
+挂载时只把这 3 条注入当轮追问;其余 P0 / P1 / P2 为可选补问。
+
+1. **逐接缝答**:每个外部接缝失败时(超时 / 报错 / 不可达),本功能怎么表现——报错、重试、还是降级兜底?(别笼统说「会处理」)
+2. 超时阈值、重试次数与退避、幂等键——三件各定多少?
+3. 「连通性 × 错误类型」组合表——逐格定义展示与行为,排查有没有文案-行为打架或死分支。
+
+---
+
+## 常见答案池
+
+| 主题 | 常见选项 |
+|---|---|
+| 失败处理 | 报错中断 / 自动重试 / 降级兜底 / 本地暂存补偿 / 静默忽略 |
+| 降级形态 | 只读缓存 / 本地暂存排队 / 切手动 / 直接拒绝 + 提示 |
+| 重试策略 | 不重试 / 固定次数 / 指数退避 / 用户手动重试 |
+| 幂等键 | 业务唯一键 / 客户端生成 UUID / 服务端去重窗口 / 不保证 |
+| 凭证过期 | 自动刷新 / 报错重新授权 / 静默失败 |
+
+---
+
+## Top 5 最易被漏掉的问题
+
+本维度按挂载协议默认只注入「精选 P0(≤3)」;**一旦本维度被追问深入**(精选 P0 暴露出更多边界),这 5 个是最不该漏的补问点。届时用户答不上来转入 `open_questions`(精选 P0 相关项 `severity: blocking`,其余 `non_blocking`):
+
+1. **「返回 200 但语义失败」**——只判 HTTP 码会漏。
+2. **跨状态组合的死分支 / 文案打架**——离线 × 错误态这类(真实反面教材)。
+3. **幂等**——重试 / 重复点击造成重复副作用。
+4. **凭证过期路径**——happy path 之外几乎总被忘。
+5. **降级态恢复后的数据对账**——暂存数据怎么回流。
+
+---
+
+## 本清单的演化约定
+
+发现新场景或遗漏时:
+
+1. 先写入本文件对应分类,并标 P0 / P1 / P2
+2. 若有新选项,同步更新「常见答案池」
+3. 如果某 P1 问题频繁被用户答不上来,升级为 P0
+4. 本清单是「正交维度」——如果发现某类集成场景(如「消息队列专项」)与通用接缝差异过大,拆出独立维度清单(如 `checklists/dimensions/message-queue.md`)
+
+当前版本:v0.1 · dimension(正交维度)· 与 templates/prd.yaml (schema_version v0.3) 对齐