artifact-chain-assistant 0.9.0 → 0.9.2

package/adapters/claude/skills/scenario-script/author/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/skills/scenario-script/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/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/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/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
 ```

package/adapters/claude/skills/scenario-script/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/skills/scenario-script/repair/SKILL.md

@@ -35,22 +35,41 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
 
 #### 结构修复（SS-F-001 至 SS-F-003）
 - 按项目配置、模板和同类制品补充或修正结构
-- 修正 ID 使其匹配项目 idPatterns 中的对应 pattern
+- 修正 ID 与节点编号使其匹配项目 idPatterns 中的对应 pattern（主场景 H2、变体 H3，`^S-\d+[a-z]?$`）
 - 修正 status 为项目定义的合法枚举值
 
-#### 场景质量修复（SS-F-004 至 SS-F-008）
-- 补充缺失的角色与目标描述
-- 补充前置条件
-- 为无编号的主路径步骤添加编号，替换模糊词为可测试描述
-- 补充异常路径覆盖
-- 替换可观察结果中的模糊词为可验证条件
-
-#### 制品链修复（SS-F-009 至 SS-F-010）
-- 移除不可达的关联制品引用，或创建缺失的制品
-- 修复 validate 报告的具体警告
-
-#### 追溯修复（SS-F-011）
-- 建立或修复与需求/功能特性制品的追溯关联
+#### 字段块与追溯修复（SS-F-004、SS-F-009 至 SS-F-011、SS-F-015）
+- 补齐缺失的 `关联功能`/`关联决策` 机器锚点；`场景代码` 缺失时补稳定 slug
+- 移除不可达的关联制品引用（引用了图中不存在的 ID 属错误，必删或更正），或在 `suggested_fix` 中提请人工创建缺失制品
+- 修复 validate 报告的具体警告；`ORPHAN_SCENARIO` 在发现级场景下属预期 warning，不强制消灭
+- 双向一致：关联功能存在时，在功能制品 frontmatter `scenarios` 中回列本场景；删除编造的关联 ID
+- 功能制品暂缺、场景尚未挂接是发现级暂态：不自动创建功能制品、不编造 ID 顶替；按项目模板约定保留省略或标注写法，并在 evidence 中如实说明；是否补齐挂接属人工决策
+- 正文出现本机绝对路径（SS-F-015）时改为项目相对路径或占位符
+- 决策 ID 形式注意：只有 `D-XXX-数字` 形式能成边；`ADR-\d{4}` 类编号保留为文档级追溯，不得当作图边修复目标
+
+#### Given/When/Then 修复（SS-F-005 至 SS-F-007）
+- 把 Given 改写成可构造的具体前置状态
+- 把 When 改写成编号步骤的具体动作
+- 把 Then 中的口号和模糊词换成可观察、可验证的事实（输出、退出码、状态、记录）
+
+#### 变体修复（SS-F-008）
+- 为缺失的关键分支、边界、异常补变体节点，只写与主场景的差异，并同样声明字段块
+
+#### 风格修复（SS-F-012 至 SS-F-014、SS-F-016 至 SS-F-017）
+- 按密度原则处理风格发现：单发命中不修，短段落内反复堆叠或脱离具体内容才修
+- 风格修复只改表述，不改变场景的事实内容（前置状态、动作、预期结果保持原样）；
+  语体保持结构化验收场景，行文规则见 `../references/writing-style.md`
+- 词汇可懂性修复（SS-F-016，细则见 `../references/writing-style.md` 的"词汇可懂性纪律"节）：
+  把内部动词和生造词改写成可观察事实，或为首次出现的业务/机器术语用独立句补大白话
+  定义（不用"概念（解释）"式括注）；混入正文的技能 slug 移回字段块（入口编号），
+  正文改用"入口技能""该命令"指代
+- 写作惯性修复（SS-F-017，细则见 `../references/writing-style.md` 的"写作惯性约束"节）：
+  只改表达——统一称呼、去口语、拆并列、删插入语、把连续否定改成正向状态划边界——
+  不改变任何行为断言的事实内容
+- 无据断言（SS-F-013）不得靠"写得模糊"蒙混：使 Given/Then 与关联功能/决策制品对齐，
+  或在 `suggested_fix` 中提请人工裁决差异
+- 可读性修复（SS-F-014）优先改写节点标题与场景代码，不新增章节
+- 修复后重查：`关联功能` 仍只引用图中已存在的 ID；关联功能存在时双向回列仍一致；暂缺挂接未被误修成编造引用
 
 ### 3. 修复后验证
 
@@ -91,7 +110,7 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
 ## 修复边界
 
 - **可自动修复**：项目规则明确且不改变业务语义的结构、格式和表述问题
-- **需人工决策**：场景质量内容补充（角色目标、异常路径覆盖）、关联制品是否应创建、status 变更
+- **需人工决策**：验收口径内容补充（Given 前置状态、Then 预期结果、变体覆盖范围）、关联制品是否应创建（含发现级暂态下是否补齐功能挂接）、status 变更
 - **不自动修改**：代码文件、需求制品、设计文档
 
 ## 质量要求
@@ -99,7 +118,7 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
 - 每个修复动作映射到协议字段：已处理 finding 写入 `repair.findings_addressed`，实际改动文件写入 `repair.files_modified`，跳过原因与命令结果写入 `evidence`
 - 修复不得改变场景的业务语义，只修正结构和格式问题
 - re-review 必须运行实际的 validate 命令，不靠叙述确认
-- 不得泄漏项目私有实现细节和绝对路径
+- 不得泄漏项目私有实现细节；修复后正文仍不得含本机绝对路径
 
 ## Profile 与 Worker Contract
 

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

@@ -0,0 +1,88 @@
+# scenario-script compose
+
+内部工序，不作为 catalog 入口。
+
+## 目的
+
+基于 inspect 结果编写场景剧本制品的 frontmatter 和正文。
+
+## 步骤
+
+### 1. 确定制品 ID
+
+- 从项目 `idPatterns` 中场景类型对应的 pattern 派生合法 ID
+- 检查与已有制品 ID 不冲突
+- ID 应简短且具有业务语义
+
+### 2. 编写 frontmatter
+
+从 inspect 输出的项目模板、配置和同类制品派生 frontmatter。不得自行增加项目未采用的字段或状态。
+
+### 3. 编写正文结构
+
+项目有模板时服从项目模板；项目无模板时使用 `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. 文件放置
+
+- 文件名按项目制品命名模式（从已有制品扫描结果派生）
+- 路径按项目中场景剧本注册类型的 paths 配置
+- 文件名与 ID 保持可追溯对应
+
+## 输出
+
+compose 输出供 validate 和 review 消费：
+- 完整的制品文件内容
+- 制品 ID 和路径

package/adapters/claude/skills/scenario-script/repair/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 味行文规则、密度原则）。