Rune-Spec/openspec/changes/configurable-pipeline/specs/flow-commands/spec.md

ADDED Requirements

Requirement: 三明治流程结构

系统 MUST 采用三明治结构：discuss（固定，流水线之前）→ pipeline（可配置的线性阶段序列）→ finish（固定，流水线之后，终端收尾）。discuss 和 finish MUST NOT 在 pipeline stages 中定义——它们是框架级固定命令。

Scenario: 完整流程顺序

• WHEN 用户执行一个变更的完整流程
• THEN 流程顺序为：先可选执行 discuss，再按序执行 pipeline 中每个 stage，最后执行 finish 归档

Scenario: discuss 不可作为 stage id

• WHEN 用户尝试在 stages 中定义 id 为 discuss 的阶段
• THEN 配置校验失败（被保留字规则拦截）

Scenario: finish 不可作为 stage id

• WHEN 用户尝试在 stages 中定义 id 为 finish 的阶段
• THEN 配置校验失败（被保留字规则拦截）

Requirement: discuss 命令

系统 MUST 提供 rune discuss <change> 命令。该命令 MUST 输出讨论模式提示词文本。该命令 MUST NOT 检查任何前置条件（无门禁）。该命令 MUST NOT 要求产出任何文档。该命令的行为与当前 0.1.x 实现（输出探索模式 prompt）保持一致。

Scenario: 输出讨论提示词

• WHEN 用户执行 rune discuss my-feature
• THEN 命令输出讨论模式提示词文本，退出码为 0

Scenario: discuss 无前置门禁

• WHEN 变更目录为空（无任何 stage 文档），用户执行 rune discuss my-feature
• THEN 命令正常输出提示词，不报任何前置条件错误

Requirement: 动态 Stage 命令注册

系统 MUST 为配置中的每个 pipeline stage 注册对应的 CLI 命令 rune <stage-id> <change>。命令名由 stage id 决定，运行时从配置动态生成，MUST NOT 硬编码任何特定 stage。

Scenario: 从配置注册命令

• WHEN 配置定义 stages 为 [requirements, design, plan, task, build]
• THEN CLI 注册 5 个命令：rune requirements、rune design、rune plan、rune task、rune build

Scenario: 自定义 stage 注册命令

• WHEN 配置定义 stages 包含 { id: "code-review", prompt: "..." }
• THEN CLI 注册 rune code-review <change> 命令

Scenario: 执行 stage 命令输出提示词

• WHEN 用户执行 rune plan my-feature，且前置阶段全完成
• THEN 命令输出 plan 阶段的 prompt 文本，退出码为 0

Requirement: Stage 命令软门禁

rune <stage-id> <change> MUST 在输出提示词前检查该 stage 的所有前置 stage 是否完全完成（fully done）。若任一前置 stage 未完全完成，命令 MUST 拒绝输出提示词，报错指出第一个未完成的前置 stage，并退出码非零。

Scenario: 前置全完成则放行

• WHEN 流水线为 [A, B, C]，A 和 B 完全完成，用户执行 rune C my-feature
• THEN 命令输出 C 的提示词

Scenario: 前置有未完成则拒绝

• WHEN 流水线为 [A, B, C]，A 完全完成但 B 未完成，用户执行 rune C my-feature
• THEN 命令拒绝输出提示词，报错指出 B 阶段未完成，退出码非零

Scenario: 第一个 stage 无前置门禁

• WHEN 流水线为 [A, B, C]，变更目录为空，用户执行 rune A my-feature（第一个 stage）
• THEN 命令输出 A 的提示词，不报前置条件错误

Requirement: finish 命令硬门禁

rune finish <change> MUST 在执行归档操作前检查所有 pipeline stage 是否完全完成。若任一 stage 未完全完成，命令 MUST 拒绝归档，报错列出所有未完成的 stage 及其原因（文档缺失或 validate 失败），退出码非零。所有 stage 完全完成时，命令 MUST 执行归档操作（移动变更目录到 archive/）。

Scenario: 全完成则归档

• WHEN 流水线为 [A, B, C]，所有 stage 完全完成，用户执行 rune finish my-feature
• THEN 命令将变更目录移动到 archive/，退出码为 0

Scenario: 有未完成则拒绝归档

• WHEN 流水线为 [A, B, C]，A 和 C 完全完成但 B 文档缺失，用户执行 rune finish my-feature
• THEN 命令拒绝归档，报错指出 B 阶段文档缺失，退出码非零

Scenario: validate 失败则拒绝归档

• WHEN 所有 stage 文档存在，但 build 阶段的 validate 返回 falsy，用户执行 rune finish my-feature
• THEN 命令拒绝归档，报错指出 build 阶段 validate 未通过（含失败原因），退出码非零

Scenario: finish 列出所有未完成项

• WHEN 流水线为 [A, B, C]，A 缺文档且 B validate 失败，用户执行 rune finish my-feature
• THEN 报错同时列出 A（文档缺失）和 B（validate 失败），不只是第一个

Requirement: status 命令

系统 MUST 提供 rune status <change> 命令，输出变更的流水线进度。输出 MUST 包含每个 stage 的状态（文档是否存在、validate 是否通过、是否完全完成）和整体进度（当前阶段索引、是否全部完成）。该命令 MUST NOT 有任何门禁——纯只读审计。

Scenario: 显示全部阶段状态

• WHEN 流水线为 [A, B, C]，A 完全完成，B 文档存在但 validate 失败，C 文档不存在
• THEN status 输出显示：A done、B 文档存在但 validate 失败、C 文档缺失，当前进度为 B

Scenario: 全新变更状态

• WHEN 变更目录为空，用户执行 rune status my-feature
• THEN status 输出显示所有阶段未完成，当前进度为第一个阶段

Scenario: 全完成状态

• WHEN 所有阶段完全完成，用户执行 rune status my-feature
• THEN status 输出显示所有阶段 done，可执行 finish 归档

Requirement: 变更目录约定

所有 stage 文档 MUST 位于变更目录内（如 changes/<change-name>/）。discuss 不产出文档。finish 执行后变更目录 MUST 被移动到 archive/<change-name>/。

Scenario: stage 文档路径

• WHEN stage id 为 design，变更名为 my-feature
• THEN 文档路径为 changes/my-feature/design.md

Scenario: finish 后目录移动

• WHEN finish 成功执行
• THEN changes/my-feature/ 目录移动到 archive/my-feature/