artifact-chain-assistant 0.9.0 → 0.9.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-chain-assistant",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, hooks, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "artifact-chain-assistant",
   "displayName": "Artifact Chain Assistant",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/.kimi-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-chain-assistant",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.9.2
+
+### Changed
+
+- Runtime compatibility and generated plugin manifests are synchronized with
+  `artifact-graph@0.9.2`.
+
+## 0.9.1
+
+### Changed
+
+- Runtime compatibility and generated plugin manifests are synchronized with
+  `artifact-graph@0.9.1`.
+- Revised the `scenario-script` skill documentation and scenario templates across all host
+  adapters, and completed release compliance cleanup of the public surface.
+
 ## 0.9.0
 
 ### Added

package/INSTALL.md

@@ -13,7 +13,7 @@ instructions.
 ## Prerequisites
 
 - Node.js `>=22.0.0`.
-- `artifact-graph` 0.9.0 installed in the target project.
+- `artifact-graph` 0.9.2 installed in the target project.
 - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
   have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
   profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -25,24 +25,24 @@ instructions.
 
 | Plugin | Verified Runtime | Install |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.0 | `artifact-graph` 0.9.0 | `pnpm add -D artifact-graph@0.9.0` |
+| `artifact-chain-assistant` 0.9.2 | `artifact-graph` 0.9.2 | `pnpm add -D artifact-graph@0.9.2` |
 
 ### Install The Runtime
 
 The default installation path uses the npm registry with a precise version:
 
 ```bash
-pnpm add -D artifact-graph@0.9.0
+pnpm add -D artifact-graph@0.9.2
 ```
 
 If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
 
 ```bash
-pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.0
+pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.2
 ```
 
 > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
-> `artifact-graph@^0.9.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
+> `artifact-graph@^0.9.2`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
 > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
 
 With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -69,7 +69,7 @@ allowBuilds:
 
 The plugin's `doctor` command validates the installed runtime version before running any
 diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
-command (`pnpm add -D artifact-graph@0.9.0`) and exits non-zero.
+command (`pnpm add -D artifact-graph@0.9.2`) and exits non-zero.
 
 ### CLI Resolution Order
 
@@ -144,7 +144,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
 
 > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
 > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
-> must publish and enable `artifact-chain-assistant` 0.9.0 before the install commands above will
+> must publish and enable `artifact-chain-assistant` 0.9.2 before the install commands above will
 > succeed.
 
 ### Kimi Code
@@ -218,7 +218,7 @@ The plugin should not move these files into the plugin repository.
 
 For a first-time setup, the end-to-end sequence is:
 
-1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.0` (see Prerequisites above).
+1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.2` (see Prerequisites above).
 2. **Install the plugin** — follow the Codex or Claude Code section above.
 3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
    below). The skill will:
@@ -1016,7 +1016,7 @@ with append-only behavior; it does not overwrite local rules.
 ### Recovery Steps
 
 ```bash
-# 1. Install dependencies from lockfile (gets artifact-graph@0.9.0)
+# 1. Install dependencies from lockfile (gets artifact-graph@0.9.2)
 pnpm install --frozen-lockfile
 
 # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1083,7 +1083,7 @@ pnpm exec artifact-graph hooks install-git --hook all
 ### Enterprise Mirror
 
 If the corporate environment cannot access the public npm registry or GitHub, mirror both
-`artifact-graph@0.9.0` and the plugin marketplace repository on an internal registry. The mirror
+`artifact-graph@0.9.2` and the plugin marketplace repository on an internal registry. The mirror
 does not change the state ownership model: Git-tracked files remain authoritative, local caches
 remain derived.
 

package/README.md

@@ -149,13 +149,13 @@ override, compact query, fallback behavior, and `PLUGIN_ROOT` discovery, see
 
 | Plugin | Runtime | Install |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.0 | `artifact-graph` 0.9.0 | `pnpm add -D artifact-graph@0.9.0` |
+| `artifact-chain-assistant` 0.9.2 | `artifact-graph` 0.9.2 | `pnpm add -D artifact-graph@0.9.2` |
 
 ## Install
 
 ```bash
 # Runtime (required)
-npm install --save-dev artifact-graph@0.9.0
+npm install --save-dev artifact-graph@0.9.2
 ```
 
 ```bash
@@ -177,7 +177,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
 
 > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
 > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
-> must publish and enable `artifact-chain-assistant` 0.9.0 before the install commands above will
+> must publish and enable `artifact-chain-assistant` 0.9.2 before the install commands above will
 > succeed.
 
 ```text
@@ -193,7 +193,7 @@ For the full installation guide, quick start, Agent prompts, and clone onboardin
 
 ## Quick Start
 
-1. Install plugin 0.9.0 (above) and runtime: `pnpm add -D artifact-graph@0.9.0`.
+1. Install plugin 0.9.2 (above) and runtime: `pnpm add -D artifact-graph@0.9.2`.
 2. Run `artifact-graph doctor --root . --format json` to verify the runtime.
 3. For first-time setup, use the bootstrap skill.
 4. For daily work, use the maintainer skill.

package/README.zh-CN.md

@@ -197,13 +197,13 @@ catalog 还包含 `artifact.generate`，用于从模板和 profile 配置生成
 
 | 插件 | 运行时 | 安装 |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.0 | `artifact-graph` 0.9.0 | `pnpm add -D artifact-graph@0.9.0` |
+| `artifact-chain-assistant` 0.9.2 | `artifact-graph` 0.9.2 | `pnpm add -D artifact-graph@0.9.2` |
 
 ## 安装
 
 ```bash
 # 运行时（必需）
-npm install --save-dev artifact-graph@0.9.0
+npm install --save-dev artifact-graph@0.9.2
 ```
 
 ```bash
@@ -225,7 +225,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
 
 > **市场说明**：`ifoohoo/artifact-skill-set` 是外部独立市场，插件载荷仍由
 > `ifoohoo/artifact-chain-assistant` 发布。市场条目必须先发布并启用
-> `artifact-chain-assistant` 0.9.0，上述安装命令才能生效。
+> `artifact-chain-assistant` 0.9.2，上述安装命令才能生效。
 
 ```text
 # Kimi Code 插件（交互式，user 作用域）
@@ -240,7 +240,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
 
 ## 快速开始
 
-1. 安装插件 0.9.0（见上文）和运行时：`pnpm add -D artifact-graph@0.9.0`。
+1. 安装插件 0.9.2（见上文）和运行时：`pnpm add -D artifact-graph@0.9.2`。
 2. 运行 `artifact-graph doctor --root . --format json` 验证运行时。
 3. 首次搭建，进入 bootstrap 技能。
 4. 日常工作，进入 maintainer 技能。

package/adapters/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-chain-assistant",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, hooks, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/adapters/claude/INSTALL.md

@@ -16,7 +16,7 @@ instructions.
 ## Prerequisites
 
 - Node.js `>=22.0.0`.
-- `artifact-graph` 0.9.0 installed in the target project.
+- `artifact-graph` 0.9.2 installed in the target project.
 - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
   have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
   profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -28,24 +28,24 @@ instructions.
 
 | Plugin | Verified Runtime | Install |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.0 | `artifact-graph` 0.9.0 | `pnpm add -D artifact-graph@0.9.0` |
+| `artifact-chain-assistant` 0.9.2 | `artifact-graph` 0.9.2 | `pnpm add -D artifact-graph@0.9.2` |
 
 ### Install The Runtime
 
 The default installation path uses the npm registry with a precise version:
 
 ```bash
-pnpm add -D artifact-graph@0.9.0
+pnpm add -D artifact-graph@0.9.2
 ```
 
 If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
 
 ```bash
-pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.0
+pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.2
 ```
 
 > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
-> `artifact-graph@^0.9.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
+> `artifact-graph@^0.9.2`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
 > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
 
 With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -72,7 +72,7 @@ allowBuilds:
 
 The plugin's `doctor` command validates the installed runtime version before running any
 diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
-command (`pnpm add -D artifact-graph@0.9.0`) and exits non-zero.
+command (`pnpm add -D artifact-graph@0.9.2`) and exits non-zero.
 
 ### CLI Resolution Order
 
@@ -147,7 +147,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
 
 > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
 > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
-> must publish and enable `artifact-chain-assistant` 0.9.0 before the install commands above will
+> must publish and enable `artifact-chain-assistant` 0.9.2 before the install commands above will
 > succeed.
 
 ### Kimi Code
@@ -221,7 +221,7 @@ The plugin should not move these files into the plugin repository.
 
 For a first-time setup, the end-to-end sequence is:
 
-1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.0` (see Prerequisites above).
+1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.2` (see Prerequisites above).
 2. **Install the plugin** — follow the Codex or Claude Code section above.
 3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
    below). The skill will:
@@ -1019,7 +1019,7 @@ with append-only behavior; it does not overwrite local rules.
 ### Recovery Steps
 
 ```bash
-# 1. Install dependencies from lockfile (gets artifact-graph@0.9.0)
+# 1. Install dependencies from lockfile (gets artifact-graph@0.9.2)
 pnpm install --frozen-lockfile
 
 # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1086,7 +1086,7 @@ pnpm exec artifact-graph hooks install-git --hook all
 ### Enterprise Mirror
 
 If the corporate environment cannot access the public npm registry or GitHub, mirror both
-`artifact-graph@0.9.0` and the plugin marketplace repository on an internal registry. The mirror
+`artifact-graph@0.9.2` and the plugin marketplace repository on an internal registry. The mirror
 does not change the state ownership model: Git-tracked files remain authoritative, local caches
 remain derived.
 

package/adapters/claude/agent-methods/catalog.yaml

@@ -1,7 +1,7 @@
 schemaVersion: 1
 catalog:
   id: artifact-chain-assistant
-  version: "0.9.0"
+  version: "0.9.2"
 entries:
   - ref: artifact.prd-feature.default
     provider:

package/adapters/claude/compatibility.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": "1.0",
-  "pluginVersion": "0.9.0",
+  "pluginVersion": "0.9.2",
   "artifactGraph": {
-    "verifiedVersion": "0.9.0",
-    "installSpec": "artifact-graph@0.9.0",
-    "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.0"
+    "verifiedVersion": "0.9.2",
+    "installSpec": "artifact-graph@0.9.2",
+    "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.2"
   }
 }

package/adapters/claude/family-apis/catalog.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "catalog": {
     "id": "artifact-chain-assistant",
-    "version": "0.9.0"
+    "version": "0.9.2"
   },
   "families": [
     {

package/adapters/claude/skills/scenario-script/SKILL.md

@@ -58,14 +58,14 @@ description: Use when a user wants to write, review, or repair a scenario-script
 
 ## 通用质量维度
 
-场景剧本的质量维度是通用的，但具体字段、ID 格式、status 枚举、章节结构必须从目标项目的 artifact-graph.config.yaml、同类制品、项目模板和治理文档中派生：
-
-- **角色与目标**：场景涉及的角色及其目标
-- **前置条件**：场景执行前必须满足的条件
-- **主路径**：正常流程步骤
-- **异常路径**：异常或边界情况的处理
-- **可观察结果**：场景完成后的可验证结果
-- **需求追溯**：与需求/功能特性制品的关联
+场景剧本是结构化的发现级场景：时序上先于、并驱动 PRD 与功能特性——场景是需求发现的载体，功能特性是场景的派生物；表达形式是结构化的（字段块 + Given/When/Then），作为实现与验收的依据。一个文件可含多个场景节点。具体字段、ID 格式、status 枚举、章节结构必须从目标项目的 artifact-graph.config.yaml、同类制品、项目模板和治理文档中派生：
+
+- **节点结构**：主场景 `## S-NN：<名>`（H2），变体 `### S-NNa：<名>`（H3，字母后缀）；编号匹配 `^S-\d+[a-z]?$`，允许前导零；冒号半/全角由项目模板统一。节点标题是制品图的解析锚点（CLI 按 `^#{2,3}\s+(S-\d+[a-z]?)\s*[:：]` 识别节点，H2/H3 均可），不得随意变更形式。
+- **字段块完整性**：节点标题下是加粗字段块——`**关联功能**` 与 `**关联决策**` 是机器锚点、必需（CLI 从含"关联功能/关联决策"字样的行内提取 ID 成边）；`**场景代码**` 是稳定交叉引用 slug、推荐。字段集允许项目模板扩展（如入口编号），技能族只强制上述三项。
+- **Given/When/Then 可验证性**：`### Given` 写可构造的具体前置状态；`### When` 写用户或外部动作，编号步骤；`### Then` 写可观察、可验证的结果（输出、退出码、状态、记录）。小节标题形式从项目模板派生。
+- **变体覆盖**：关键分支、边界、异常写成紧随主场景的变体节点，复用主场景语境、只写差异，每个变体同样声明字段块。
+- **追溯一致（暂缺不判 fail）**：场景允许先于功能制品存在——发现级场景尚未挂接功能时，按项目模板约定处理 `关联功能` 行（省略或标注"尚无功能制品"），如实报告，不编造 ID，不判 fail；关联功能存在时，`关联功能` 只引用图中已存在的功能 ID，且功能制品 frontmatter 的 `scenarios` 字段必须回列本场景（双向一致，CLI 校验强制）。CLI 的 `ORPHAN_SCENARIO` 是对无功能关联场景的 warning、不阻断（exit 0）：发现级场景下该警告属预期，review 可按 warning 接受，不强制消灭。注意：场景→决策边只对 `D-XXX-数字` 形式的决策 ID 成边（CLI 硬编码），`ADR-\d{4}` 类编号只做文档级追溯，不得承诺其成边。
+- **语体**：写可构造的状态、具体的动作、可观察的事实；不写口号、不写宣传、不写设计理由。场景正文不得出现本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`）：用项目相对路径或占位符表达。去 AI 味行文规则见 `references/writing-style.md`；项目无模板时的默认格式见 `references/compose.md` 与 `references/default-template.md`。
 
 ## 技能协作边界
 

package/adapters/claude/skills/scenario-script/author/SKILL.md

@@ -28,19 +28,28 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
 - 读取 `artifact-graph.config.yaml` 确认项目配置、制品类型注册和路径
 - 从配置中派生已有制品扫描路径，确认 ID 空间和命名模式
 - 读取目标项目的模板、artifacts/README、治理文档，派生场景剧本的字段、status 枚举和章节结构
-- 检查关联的需求/功能特性制品是否存在
+- 盘点图中已有功能特性/决策制品，确定可挂接的关联对象：场景剧本先于/驱动 PRD 与功能特性，允许先于功能制品存在；待关联制品暂缺时不阻塞，如实记录盘点结果，不编造 ID
 
 ### 2. compose（参见 references/compose.md）
 
 基于 inspect 结果编写场景剧本。frontmatter 和正文结构从项目模板和已有制品派生，不硬编码字段名或章节。
 
-场景剧本应覆盖通用质量维度：
-- 角色与目标
-- 前置条件
-- 主路径（正常流程步骤）
-- 异常路径（边界与错误处理）
-- 可观察结果（可验证的终态）
-- 需求追溯（与需求/功能特性的关联）
+场景剧本是结构化的发现级场景（先于/驱动 PRD 与功能特性，功能是场景的派生物），应覆盖通用质量维度：
+- 字段块完整：`**场景代码**`（稳定 slug）、`**关联决策**`、`**关联功能**`（后两项为机器锚点、必需；字段集允许项目模板扩展）
+- Given：可构造的具体前置状态
+- When：用户或外部动作的编号步骤
+- Then：可观察、可验证的结果（输出、退出码、状态、记录）
+- 变体：关键分支、边界、异常写成变体节点，只写与主场景的差异，同样声明字段块
+- 追溯：关联功能存在时只引用图中已存在的 ID，功能制品 frontmatter `scenarios` 回列本场景；场景先于功能制品时按项目模板约定省略或标注 `关联功能` 行，暂缺不判 fail，不编造 ID
+- 正文不出现本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`）：用项目相对路径或占位符
+
+行文遵循 `../references/writing-style.md` 的去 AI 味规则。
+
+词汇可懂性是强制约束（细则见 `../references/writing-style.md` 的"词汇可懂性纪律"节）：
+- 正文每句话必须通过"外行三问"：是什么、谁在做、我看到什么；答不上来的词必须改写或补解释
+- 系统内部动词（物化、收束、密封、栅栏、编排等）不得裸用于用户视角叙述，改写成可观察事实（"系统给出最终结论""任务如实停住"）
+- 业务/机器术语首次出现必须有大白话解释或括注（示例：技术尝试（同一任务换一个全新进程再跑一次）），之后可沿用中文名、机器标识放反引号
+- 技能 slug 只在字段块（入口编号）出现，正文用"入口技能""该命令"指代
 
 ### 3. validate（参见 references/validate.md）
 
@@ -71,23 +80,23 @@ validation:
 related:
   artifacts: [<关联制品类型、ID 及存在状态>]
 quality_dimensions:
-  role_and_goals: present | missing
-  preconditions: present | missing
-  main_path: present | missing
-  exception_paths: present | missing
-  observable_results: present | missing
-  traceability: present | missing
+  field_block: present | missing
+  given_when_then: present | missing
+  variant_coverage: present | missing
+  # 关联功能暂缺（发现级暂态）记 pending 而非 inconsistent
+  traceability: consistent | inconsistent | pending
 ```
 
 ## 质量要求
 
-- 场景步骤必须可执行、可验证
-- 主路径和异常路径必须覆盖关键业务分支
-- 按项目规则建立必要的需求或其他上游制品追溯；项目未要求时不擅自增加关联
-- 前置条件必须明确列出依赖和假设
-- 可观察结果必须是可验证的，不使用模糊词
+- 字段块三项齐全：`关联决策`、`关联功能` 为机器锚点、必需；`场景代码` 为稳定 slug、推荐
+- Given 写可构造的具体前置状态；When 用编号步骤写具体动作；Then 写可观察、可验证的结果（输出、退出码、状态、记录），不写口号
+- 关键分支、边界、异常写成变体节点，并同样声明字段块
+- `关联功能` 只引用图中已存在的 ID，不编造关联 ID；功能制品存在时其 frontmatter `scenarios` 回列本场景，保持双向一致；功能制品暂缺时按项目模板约定省略或标注 `关联功能` 行，暂缺不判 fail
+- 行文遵循 `../references/writing-style.md` 的去 AI 味规则
+- 词汇可懂性为强制项（细则见 `../references/writing-style.md` 的"词汇可懂性纪律"节）：正文通过"外行三问"（是什么、谁在做、我看到什么）；系统内部动词不裸用于用户视角叙述；业务/机器术语首次出现有大白话解释或括注；技能 slug 只在字段块（入口编号）出现
 - 所有项目专属字段和结构从目标项目派生，不硬编码
-- 不得泄漏项目私有实现细节和绝对路径
+- 不得泄漏项目私有实现细节；正文不得出现本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`），用项目相对路径或占位符
 
 ## Profile 与 Worker Contract
 

package/adapters/claude/skills/scenario-script/author/references/compose.md

@@ -20,15 +20,60 @@
 
 ### 3. 编写正文结构
 
-正文应覆盖角色与目标、前置条件、主路径、异常路径、可观察结果和必要追溯等通用质量维度；具体章节名和布局从项目模板与已有制品派生。
-
-### 4. 场景步骤编写规则
-
-每个主路径和异常路径步骤必须：
-- 使用编号列表
-- 以动词开头
-- 包含可验证的条件（不使用"足够""合理""尽快"等模糊词）
-- 每个异常路径描述触发条件和预期处理方式
+项目有模板时服从项目模板；项目无模板时使用 `references/default-template.md` 的默认骨架。
+默认骨架的要点：
+
+- 场景节点标题：主场景 `## S-NN：<名>`（H2），变体 `### S-NNa：<名>`（H3，字母后缀）。
+  编号匹配 `^S-\d+[a-z]?$`，允许前导零；冒号半/全角由项目模板统一。标题层级、编号
+  形式、冒号形式以项目配置与既有制品为准——节点标题是制品图的解析锚点（CLI 按
+  `^#{2,3}\s+(S-\d+[a-z]?)\s*[:：]` 识别），不得随意变更形式。一个文件可含多个节点。
+- 字段块：节点标题下逐行写加粗字段——`**场景代码**: <稳定 slug>`（推荐）、
+  `**关联决策**: <ID 列表>`、`**关联功能**: <ID 列表>`。`关联决策`/`关联功能` 是机器
+  锚点、必需：CLI 从含"关联功能/关联决策"字样的行内提取 ID 成边，只引用制品图中
+  已存在的 ID。字段集允许项目模板扩展（如 `**入口编号**`），技能族只强制上述三项。
+  标签后只写制品 ID，标签名以项目 `relationFields` 配置为准。
+- 场景先于功能制品时（发现级场景）：`**关联功能**` 行按项目模板约定处理——省略该行，
+  或按项目模板标注"尚无功能制品"；如实写明现状，不编造功能 ID 顶替。此时 CLI 报的
+  `ORPHAN_SCENARIO` warning（不阻断、exit 0）属预期，不强制消灭。功能制品后续建立后，
+  再补挂接并在功能制品 frontmatter `scenarios` 中回列本场景。
+- `### Given`：前置条件，可构造的具体状态（文件存在与否、数据记录、环境条件），
+  逐条列出；不写泛泛背景。
+- `### When`：用户或外部动作，编号步骤；每步一个具体动作。
+- `### Then`：可观察、可验证的结果：输出文本、退出码、状态、记录。逐条列出，
+  每条都能被检查真伪；不写口号、不写"用户体验良好"之类不可验证表述。
+- 小节标题形式（Given/When/Then 的具体写法）从项目模板派生。
+- 变体场景：分支、边界、异常写成紧随主场景的变体 `### S-NNa：<名>`，复用主场景
+  语境，只写与主场景不同的 Given/When/Then。每个变体同样声明字段块。
+
+### 4. 语言风格（结构化验收场景语体）
+
+场景剧本的语体是结构化验收场景：写可构造的状态、具体的动作、可观察的事实。
+不写宣传，不写设计理由，不写口号。
+
+去 AI 味行文规则（空洞词、排队连接词、排比堆砌等）统一维护在
+`references/writing-style.md`，编写与审阅都以该文件为准。场景层面的约束：
+
+- Given 写可构造的状态：路径、记录、配置，不写"系统运行正常"这类空话。
+- When 写具体动作：命令、点击、输入，步骤编号。
+- Then 写可观察事实：输出、退出码、状态、记录；数字只在真实时写。
+- 不写设计理由、不写宣传、不写观点。
+- 写作惯性约束（视角锁定、语体一致、一句一事、Then 写正向状态等八条）统一维护在
+  `references/writing-style.md` 的"写作惯性约束"节，与去 AI 味行文规则同级执行。
+- 禁本机绝对路径：正文中的路径一律用项目相对路径（如 `artifacts/scenarios/...`）或
+  占位符（如 `<project-root>`），不得出现 `<用户主目录>/xxx`、`~/xxx` 这类机器私有路径。
+
+**交付前快速检查**：
+
+- 有没有空洞词、排队连接词或排比堆砌？删（清单见 `references/writing-style.md`）。
+- 词汇可懂性：正文能否通过"外行三问"、内部动词有无裸用、术语首现有无解释、slug 是否
+  只在字段块（检查法见 `references/writing-style.md` 的"词汇可懂性纪律"节）？
+- Then 里有没有不可验证的表述？换成可观察事实。
+- 正文有没有本机绝对路径？换成项目相对路径或占位符。
+- `关联功能`/`关联决策` 是否只引用图中已存在的 ID？有没有编造关联？
+- 关联功能存在时，功能制品 frontmatter 的 `scenarios` 是否回列了本场景（双向一致）？
+  尚未挂接功能时，`关联功能` 行是否按项目模板约定省略或标注，且如实报告？
+- 每个节点的字段块是否齐全（场景代码/关联决策/关联功能；发现级场景下关联功能行可
+  按约定省略）？
 
 ### 5. 文件放置
 

package/adapters/claude/skills/scenario-script/author/references/default-template.md

@@ -0,0 +1,64 @@
+---
+id: S-<nn>
+title: <场景文件标题>
+status: <项目状态枚举>
+---
+
+## S-<nn>：<场景名>
+
+**场景代码**: <稳定交叉引用 slug，kebab-case>
+**关联决策**: <决策 ID 列表>
+**关联功能**: <功能 ID 列表；尚无功能制品时省略本行，或按项目模板标注"尚无功能制品">
+
+### Given
+
+- <可构造的具体前置状态：文件、记录、配置、环境条件>
+
+### When
+
+1. <用户或外部动作，编号步骤>
+
+### Then
+
+- <可观察、可验证的结果：输出文本、退出码、状态、记录>
+
+---
+
+### S-<nna>：<变体名>
+
+**场景代码**: <变体稳定 slug>
+**关联决策**: <决策 ID 列表>
+**关联功能**: <功能 ID 列表>
+
+### Given
+
+- <与主场景不同的前置状态>
+
+### When
+
+1. <与主场景不同的动作步骤>
+
+### Then
+
+- <该分支下可观察、可验证的结果>
+
+## 使用说明（放入项目前删除本节）
+
+- 节点标题是制品图的解析锚点：主场景 H2、变体 H3，编号匹配 `^S-\d+[a-z]?$`（允许
+  前导零），冒号半/全角以项目 `artifact-graph.config.yaml` 与既有制品为准（CLI 按
+  `^#{2,3}\s+(S-\d+[a-z]?)\s*[:：]` 识别节点）。
+- 字段块中 `关联功能`/`关联决策` 是机器锚点、必需：CLI 从含"关联功能/关联决策"字样
+  的行内提取 ID 成边，只引用制品图中已存在的 ID。`场景代码` 是稳定交叉引用 slug、
+  推荐。字段集允许项目模板扩展（如 `**入口编号**`）。
+- 场景先于功能制品时（发现级场景）：`关联功能` 行按项目模板约定省略，或标注
+  "尚无功能制品"；如实写明，不编造功能 ID。此时 CLI 的 `ORPHAN_SCENARIO` warning
+  （不阻断、exit 0）属预期，不强制消灭；功能制品建立后再补挂接与回列。
+- 追溯一致：关联功能存在时，功能制品 frontmatter 的 `scenarios` 字段必须回列本场景
+  （双向一致，CLI 校验强制）；暂缺不判 fail。
+- 场景→决策边只对 `D-XXX-数字` 形式的决策 ID 成边（CLI 硬编码）；`ADR-\d{4}` 类
+  编号只做文档级追溯，不产生图边。
+- 关键分支、边界、异常写成变体节点（H3、字母后缀），复用主场景语境、只写差异。
+- 正文不得出现本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`）：路径用项目相对形式或占位符
+  （如 `<project-root>`）。
+- 语言风格规则见 `compose.md` 第 4 节与 `writing-style.md`（结构化验收场景语体、
+  去 AI 味行文规则、密度原则）。

package/adapters/claude/skills/scenario-script/author/references/inspect.md

@@ -52,15 +52,19 @@ artifact-graph query --from <ID>
 - 已有制品 status 分布
 - 制品文件命名模式
 
-### 4. 关联制品可达性
+### 4. 关联制品盘点
 
-对目标制品的关联制品 ID：
+场景剧本是结构化的发现级场景：时序上先于/驱动 PRD 与功能特性，允许先于功能制品
+存在。本步骤盘点图中已有功能特性/决策制品，确定可挂接的关联对象：
 
 ```bash
 artifact-graph query --from <RELATED_ID>
 ```
 
-记录每个关联 ID 的存在状态；状态取值沿用目标项目的表达。
+记录每个候选关联 ID 的存在状态；状态取值沿用目标项目的表达。待关联制品暂缺时
+不阻塞：如实记录盘点结果（哪些可挂接、哪些暂缺），供 compose 按项目模板约定省略
+或标注 `关联功能` 行；不编造 ID。同时记录候选功能制品 frontmatter 的 `scenarios`
+字段现状，供 compose 在关联功能存在时建立双向回列。
 
 ### 5. 实现状态检查
 

package/adapters/claude/skills/scenario-script/author/references/validate.md

@@ -15,8 +15,9 @@ artifact-graph validate --root . --warning-only
 ```
 
 检查：
-- 无新增孤立制品警告
-- 无新增关联引用警告
+- 无新增孤立制品错误；`ORPHAN_SCENARIO`（场景无功能关联）是 warning、不阻断
+  （exit 0），发现级场景尚未挂接功能时该警告属预期，如实记录即可，不强制消灭
+- 无新增关联引用警告（引用了图中不存在的 ID 必须处理）
 - 新制品已正确参与图遍历
 
 ### 2. 项目规范完整性
@@ -39,9 +40,20 @@ artifact-graph query --from <ID>
 
 ### 5. 场景质量基本检查
 
-- 能定位角色与目标、前置条件、主路径和可观察结果（章节名服从项目模板）
-- 关键异常路径得到覆盖
-- 步骤与结果可验证，不依赖模糊表述
+- 每个节点字段块齐全：`关联功能`/`关联决策`（机器锚点、必需）、`场景代码`（推荐）；
+  项目扩展字段符合项目模板
+- 能定位 Given/When/Then（小节标题形式服从项目模板）
+- Given 是可构造的具体前置状态；When 是编号步骤的具体动作
+- Then 是可观察、可验证的结果（输出、退出码、状态、记录），无口号、无模糊词
+- 关键分支、边界、异常有变体节点覆盖，变体同样声明字段块
+- 语体为结构化验收场景：无宣传收束、无空洞词；按密度原则判断，不误伤正常表达
+  （行文规则见 `writing-style.md`）
+- 词汇可懂性：正文通过"外行三问"，内部动词未裸用，术语首现有解释，slug 只在字段块
+  （检查法见 `writing-style.md` 的"词汇可懂性纪律"节）
+- 正文无本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`）：路径用项目相对形式或占位符
+- 追溯一致：`关联功能` 只引用图中已存在的 ID，无编造关联；关联功能存在时，功能制品
+  frontmatter 的 `scenarios` 回列本场景；功能制品暂缺时 `关联功能` 行按项目模板约定
+  省略或标注，属可接受的发现级暂态，不判 fail
 
 ## 输出
 
@@ -63,10 +75,10 @@ validation:
       - id: <关联 ID>
         exists: true | false
 quality_dimensions:
-  role_and_goals: present | missing
-  preconditions: present | missing
-  main_path: present | missing
-  exception_paths: present | missing
-  observable_results: present | missing
-  traceability: present | missing
+  field_block: present | missing
+  given_when_then: present | missing
+  variant_coverage: present | missing
+  # 关联功能暂缺（发现级暂态）记 pending 而非 inconsistent
+  traceability: consistent | inconsistent | pending
+  style: present | missing
 ```