artifact-chain-assistant 0.9.0 → 0.9.2

package/adapters/claude/skills/scenario-script/review/references/writing-style.md

@@ -0,0 +1,74 @@
+# 场景剧本行文规则（去 AI 味）
+
+内部参考，不作为 catalog 入口。编写、审阅、修复场景剧本正文时以本文件为统一的行文约束。
+
+## 密度原则
+
+单独出现不算问题，短段落内反复堆叠、脱离具体内容、空转才是问题。按出现次数机械
+替换会把正常表达误改成翻译腔。风格类发现必须附密度判断。
+
+## 规则
+
+- 删空洞词：显著、有效、充分、极大、赋能、抓手、全方位、无缝、落地（滥用时）。
+- 不用"首先/其次/再次/最后"排队；不用"不仅…而且…"凑对仗；禁三连排比和四字短语堆砌。
+- 句子长短交错、多用短句；具体名词+具体动词；数字只在真实时写。
+- 禁"总而言之/综上所述/值得注意的是/换句话说"；破折号不当万能连接词；不喊口号、
+  不拟人煽情。
+
+## 词汇可懂性纪律
+
+根因说明：术语表中文名 ≠ 用户语言。项目术语表服务的是"机器标识 ↔ 中文名"的对齐
+一致性，其中的中文名（以及设计文档、ADR 里的工程师词汇）不得未经翻译直接进入
+场景正文。
+
+- 用户视角测试：场景正文每句话必须能回答"用户看到什么、做到什么"。系统内部动作
+  动词（物化、收束、密封、栅栏、编排、物化最终裁决这类）不得直接用于用户视角叙述；
+  要么改写成可观察事实（"系统给出最终结论""任务如实停住"），要么首次出现时跟一句
+  大白话解释。
+- 术语双轨制：项目术语表是"机器标识 ↔ 中文名"的对照表，服务文档一致性，不是用户
+  语言的免解释通行证。业务/机器术语在场景中首次出现，用一句独立的话给出大白话定义
+  （示例："项目委托包是把口头要求写成的正式委托单，后续验收以它为准"），不用
+  "概念（大白话解释）"式括注；读者已懂的词连定义都不用写；之后可沿用中文名，机器
+  标识放反引号。
+- slug 最小露面：技能名、命令这类 slug 只在字段块（入口编号）出现，正文用"入口技能"
+  "该命令"指代。
+- 评审检查法：评审者对每个生造词/内部黑话做"外行三问"——是什么、谁在做、我看到
+  什么；答不上来的词判发现。
+
+## 写作惯性约束（BDD 正文）
+
+以下八条针对 Given/When/Then 正文的写作惯性，与"规则"节同级执行；违反即判发现
+（`SS-F-017`），finding 的 `message` 须含问题句字面引用。
+
+- 视角锁定：全篇单一称呼，不在"用户/你"之间切换。
+- 语体一致：既然用了 Given/When/Then 框架，全篇保持书面简洁体，不插口语；判断
+  标准——一句话放进微信聊天不违和，就不该出现在 BDD 用例里。
+- 不做括号翻译：禁止"术语A（术语A的大白话解释）"写法；概念首次出现时用一句独立的
+  话定义，读者已懂的词连定义都不用写。机器标识、枚举值首次出现给中文名的写法保留，
+  例如"无变更接受（`NOOP_ACCEPTED`）"——这是术语表纪律，不算括号翻译。
+- 一句一事：不在一句内用顿号、逗号并列三个及以上同级概念，改用列表。
+- 信任读者推理：不写正反各说一遍的双保险，不写"这属于XX阶段"式的元分类。
+- Then 写正向状态：最多用一条否定句划边界，禁止连续两条"没有发生XX"。
+- 不提前道歉、不预防性解释：禁用"需要注意的是""值得一提"这类插入语（"规则"节已禁
+  "值得注意的是""换句话说"，本节把预防性解释整体列入）。
+- 完稿自检：检查语体、人称各只剩一个值。
+
+## 结构化场景约束
+
+- Given 写可构造的状态：路径、记录、配置、环境条件，不写"系统运行正常"这类空话。
+- When 写具体动作：命令、点击、输入，步骤编号，每步一个动作。
+- Then 写可观察的事实：输出文本、退出码、状态、记录。每条都能被检查真伪，
+  不写口号，不写"用户体验良好""流程顺畅"这类不可验证表述。
+- 不写设计理由、不写宣传、不写观点。
+- 不写本机绝对路径：路径用项目相对形式或占位符（如 `<project-root>`），
+  不出现 `<用户主目录>/xxx`、`~/xxx` 这类机器私有路径。
+- 机标识（文件名、命令、枚举值）保持英文原样并放反引号；术语表之外的概念用日常
+  说法，不生造术语。
+
+## 交付前快速检查
+
+- 有没有空洞词或口号？删。
+- 有没有排队连接词或对仗凑句？改成正常叙述。
+- 每句的名词和动词是否具体？数字是否真实？
+- Then 的每条结果是否能被检查真伪？不能就改写成可观察事实。
+- 语体、人称是否各只剩一个值？Then 是否写正向状态（否定句至多一条划边界）？

package/adapters/claude/templates/core/scenario/review-checklist.md

@@ -1,29 +1,43 @@
 # Scenario 审查清单
 
 <!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+<!-- 场景剧本是结构化的发现级场景：先于/驱动 PRD 与功能特性，功能是场景的派生物；
+     表达形式是结构化的（字段块 + Given/When/Then） -->
 
 ## 结构完整性
 
 - [ ] `id` 字段存在且符合项目 ID 模式（如 `S-{nn}`）
 - [ ] `title` 字段存在且描述场景本质
 - [ ] `status` 字段存在且为有效值
-- [ ] 角色与目标清晰定义
+- [ ] 节点标题符合解析锚点形式：主场景 H2、变体 H3，编号匹配 `^S-\d+[a-z]?$`，冒号形式与项目模板一致
 
-## 流程质量
+## 字段块完整性
 
-- [ ] 主流程使用 Given/When/Then 格式
-- [ ] 至少覆盖一个备选流程
-- [ ] 前置条件可验证
-- [ ] 系统响应具体可测试
+- [ ] 每个节点都有 `**关联功能**` 与 `**关联决策**`（机器锚点、必需）
+- [ ] 每个节点都有 `**场景代码**` 稳定 slug（推荐）
+- [ ] 项目扩展字段（如入口编号）符合项目模板
 
-## 追溯性
+## Given/When/Then 可验证性
 
-- [ ] 关联至少一个功能特性
-- [ ] 关联的功能特性 ID 存在
-- [ ] 场景可追溯到功能需求
+- [ ] Given 是可构造的具体前置状态，不是泛泛背景描述
+- [ ] When 是编号步骤的具体动作
+- [ ] Then 是可观察、可验证的结果（输出、退出码、状态、记录），无口号、无模糊词
 
-## 可执行性
+## 变体覆盖
 
-- [ ] 场景可以手动或自动执行
-- [ ] 验收标准与流程步骤一致
-- [ ] 备选流程覆盖关键异常路径
+- [ ] 关键分支、边界、异常有变体节点覆盖
+- [ ] 变体复用主场景语境、只写差异，且同样声明字段块
+
+## 追溯一致
+
+- [ ] `关联功能`/`关联决策` 只引用制品图中已存在的 ID，无编造关联（引用不存在的 ID 是错误）
+- [ ] 关联功能存在时，功能制品 frontmatter 的 `scenarios` 字段回列本场景（双向一致）
+- [ ] 尚无功能制品时，`关联功能` 行按项目模板约定省略或标注（发现级暂态，记 info/warning，不判 fail）
+- [ ] `ORPHAN_SCENARIO` warning（无功能关联、不阻断）在发现级场景下属预期，可按 warning 接受
+- [ ] 场景→决策边只对 `D-XXX-数字` 形式成边；`ADR-\d{4}` 类编号只做文档级追溯，未当作图边
+
+## 行文
+
+- [ ] 无空洞词、排队连接词、三连排比、四字堆砌等 AI 腔（按密度原则判断）
+- [ ] Then 写可观察事实，不写口号；数字只在真实时写
+- [ ] 正文无本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`），路径为项目相对形式或占位符

package/adapters/claude/templates/core/scenario/starter.md

@@ -2,53 +2,70 @@
 id: {SCENARIO_ID}
 title: {标题}
 status: draft
-related_features: []
+scenarios: []
 ---
 
 # {SCENARIO_ID}: {标题}
 
 <!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 场景剧本是结构化的发现级场景：时序上先于/驱动 PRD 与功能特性，功能特性是
+     场景的派生物；表达形式是结构化的（字段块 + Given/When/Then）。一个文件可含
+     多个场景节点。 -->
 
-## 角色与目标
+## S-{nn}：{场景名}
 
-**角色**：{用户角色}
-**目标**：{用户要完成的任务}
+**场景代码**: {稳定交叉引用 slug，kebab-case}
+**关联决策**: {决策 ID 列表}
+**关联功能**: {功能 ID 列表；尚无功能制品时省略本行，或按项目模板标注"尚无功能制品"}
 
-## 前置条件
+### Given
 
-{列出执行此场景前必须满足的条件}
+- {可构造的具体前置状态：文件、记录、配置、环境条件}
 
-## 主流程
+### When
 
-```gherkin
-Given {前置状态}
-When {用户操作}
-Then {系统响应}
-```
+1. {用户或外部动作，编号步骤}
 
-## 备选流程
+### Then
 
-### 备选 1：{备选流程名称}
+- {可观察、可验证的结果：输出文本、退出码、状态、记录}
 
-```gherkin
-Given {前置状态}
-When {异常操作}
-Then {错误处理或备选路径}
-```
+---
+
+### S-{nn}a：{变体名}
+
+**场景代码**: {变体稳定 slug}
+**关联决策**: {决策 ID 列表}
+**关联功能**: {功能 ID 列表}
+
+### Given
+
+- {与主场景不同的前置状态}
 
-## 验收标准
+### When
 
-1. {场景验收标准 1}
-2. {场景验收标准 2}
+1. {与主场景不同的动作步骤}
 
-## 关联制品
+### Then
 
-- 功能特性：{related_features}
-- 设计文档：{related_designs}
+- {该分支下可观察、可验证的结果}
 
-## 测试脚本
+## 使用说明（放入项目前删除本节）
 
-{如果适用，关联自动化测试脚本路径}
+- 节点标题是制品图的解析锚点：主场景 H2、变体 H3（字母后缀），编号匹配
+  `^S-\d+[a-z]?$`（允许前导零），冒号半/全角以项目配置与既有制品为准。
+- 字段块中 `关联功能`/`关联决策` 是机器锚点、必需，只引用制品图中已存在的 ID；
+  `场景代码` 是稳定交叉引用 slug、推荐。字段集允许项目模板扩展（如入口编号）。
+- 场景先于功能制品时（发现级场景）：`关联功能` 行省略，或按项目模板标注——写法
+  示例：`**关联功能**: 尚无功能制品（发现级场景，功能制品建立后补挂接）`。此时
+  CLI 的 `ORPHAN_SCENARIO` warning（不阻断、exit 0）属预期，不强制消灭。
+- 追溯一致：关联功能存在时，功能制品 frontmatter 的 `scenarios` 字段必须回列本场景；
+  暂缺不判 fail，不编造 ID。
+- 场景→决策边只对 `D-XXX-数字` 形式的决策 ID 成边（CLI 硬编码）；`ADR-\d{4}` 类
+  编号只做文档级追溯。
+- 关键分支、边界、异常写成变体节点，复用主场景语境、只写差异。
+- 正文不得出现本机绝对路径（如 `<用户主目录>/xxx`、`~/xxx`）：路径用项目相对形式或占位符。
+- frontmatter 字段集以项目模板与配置为准；上表仅为插件 starter 默认。
 
 ## 变更日志
 

package/adapters/codex/.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/adapters/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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. 实现状态检查