scenario-script

目的

为场景剧本制品提供编写、审阅和修复的统一入口。根据用户意图路由到对应的子流程，实现场景剧本从起草到终态的完整闭环。

路由决策树

根据用户意图选择进入点：

路由到 author

• 用户要求"编写""起草""新建""创建"场景剧本
• 用户提供了业务目标或需求描述，需要从零产出制品
• 项目尚无对应场景剧本，需要初始化

路由到 review

• 用户要求"审阅""检查""审查""评估"已有场景剧本
• 用户提供了场景剧本文件路径或 ID
• author 流程完成后的质量验收

路由到 repair

• review 产生了 findings 需要修复
• 用户明确要求"修复""修正""改进"某个场景剧本
• 前一轮 review 输出了 repair_entry 建议

流程闭环规则

一旦进入子流程，该流程必须自行完成闭环。上层规划器不得另拆 review/repair 步骤：

1. author 流程：inspect → compose → validate → review。若 review 产生 findings，进入 repair → re-review 循环，直至终态 verdict（pass/warning/BLOCKED/NEEDS_INPUT）。
2. review 流程：inspect → review。若存在可修 findings 且非只读模式，进入 repair → re-review 循环直至终态；若只读审阅或用户明确禁止修改，输出 findings 与 repair_entry 后终止，并明确受用户约束。
3. repair 流程：基于 review 的 findings 修复 → re-review 确认终态（或 BLOCKED/NEEDS_INPUT）。

输出契约

默认入口输出

路由结果必须包含：

• target_flow：author | review | repair
• reason：路由理由（一句话）
• artifact_id：目标制品 ID（若已知）
• artifact_path：目标制品路径（若已知）

子流程输出

各子流程遵循各自的输出契约，详见：

• author/SKILL.md：author 输出契约
• review/SKILL.md：review 输出契约（含 machine-readable verdict/findings）
• repair/SKILL.md：repair 输出契约（含 re-review 终态）

通用质量维度

场景剧本是结构化的发现级场景：时序上先于、并驱动 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} 类编号只做文档级追溯，不得承诺其成边。
• 语体：写可构造的状态、具体的动作、可观察的事实；不写口号、不写宣传、不写设计理由。场景正文不得出现机器私有路径：用项目相对路径或占位符表达。检查和验证细则见 references/inspect.md 与 references/validate.md；去 AI 味行文规则见 references/writing-style.md；项目无模板时的默认格式见 references/compose.md 与 references/default-template.md。

技能协作边界

• 本技能族只处理场景剧本制品，不处理 PRD 功能特性、设计文档或其他类型
• author 闭环包含 review 步骤，不依赖上层规划器拆出 review
• repair 必须基于 review 的 findings 执行，不凭空修改
• 修复后必须 re-review 确认终态，不跳过终态验证
• 所有项目专属配置（路径、字段、ID pattern、status、章节结构）从目标项目派生，不硬编码