## ADDED Requirements ### Requirement: 流水线配置格式 流水线 MUST 在配置文件中通过 `stages` 有序数组定义。每个 stage MUST 包含 `id`(字符串)和 `prompt`(字符串),MAY 包含 `validate`(JS 函数体字符串)。stages 数组的顺序即为阶段执行顺序。 #### Scenario: 最小合法配置 - **WHEN** 配置文件包含 `stages: [{ id: "plan", prompt: "..." }]` - **THEN** 配置加载成功,流水线包含 1 个阶段 #### Scenario: 含 validate 的完整配置 - **WHEN** 配置文件包含 `stages: [{ id: "build", prompt: "...", validate: "return true;" }]` - **THEN** 配置加载成功,build 阶段关联了 validate 函数 #### Scenario: 缺少 id 的 stage - **WHEN** 配置文件中某个 stage 缺少 `id` 字段 - **THEN** 配置加载失败,报错指出哪个 stage 缺少 id #### Scenario: 缺少 prompt 的 stage - **WHEN** 配置文件中某个 stage 缺少 `prompt` 字段 - **THEN** 配置加载失败,报错指出哪个 stage 缺少 prompt ### Requirement: Stage ID 命名规则 Stage id MUST 匹配 `^[a-z][a-z-]*$`(小写字母开头,后续只允许小写字母和短横线)。Stage id MUST 在同一流水线内唯一。Stage id MUST NOT 使用保留字:`discuss`、`finish`、`status`、`archive`、`init`。 #### Scenario: 合法 id - **WHEN** stage id 为 `code-review` - **THEN** 配置校验通过 #### Scenario: 包含大写字母的 id - **WHEN** stage id 为 `CodeReview` - **THEN** 配置校验失败,报错指出 id 必须为 `[a-z][a-z-]*` 格式 #### Scenario: 包含数字的 id - **WHEN** stage id 为 `stage1` - **THEN** 配置校验失败,报错指出 id 只允许小写字母和短横线 #### Scenario: 重复 id - **WHEN** 流水线包含两个 id 为 `plan` 的 stage - **THEN** 配置校验失败,报错指出 stage id 不可重复 #### Scenario: 保留字 id - **WHEN** stage id 为 `finish` - **THEN** 配置校验失败,报错指出 `finish` 是保留字不可用作 stage id ### Requirement: Stage 文档约定 每个 pipeline stage 产出且仅产出一个文档,文件名由 stage id 派生:`.md`。文档 MUST 位于变更目录内(如 `changes/my-feature/plan.md`)。Stage id 到文件名的映射 MUST NOT 可配置——统一规则不可覆盖。 #### Scenario: 文档文件名派生 - **WHEN** stage id 为 `design` - **THEN** 该阶段的产出文档路径为 `/design.md` #### Scenario: 含短横线的 id 文件名 - **WHEN** stage id 为 `code-review` - **THEN** 该阶段的产出文档路径为 `/code-review.md` ### Requirement: 默认流水线 当用户执行 `rune init` 或配置中未定义 `stages` 时,系统 MUST 提供默认流水线,包含 5 个阶段,按序为:`requirements`、`design`、`plan`、`task`、`build`。每个默认阶段 MUST 包含对应的默认 prompt。 #### Scenario: init 生成默认流水线 - **WHEN** 用户执行 `rune init` - **THEN** 生成的配置文件包含 5 个阶段:requirements、design、plan、task、build,各含默认 prompt #### Scenario: 配置中无 stages 时回退默认 - **WHEN** 配置文件加载后 stages 为空或未定义 - **THEN** 系统使用默认 5 阶段流水线 ### Requirement: 流水线线性有序 流水线 MUST 是线性有序序列——不支持分支、条件跳过或并行阶段。阶段的执行顺序由配置数组顺序决定。Stage N 的前置条件是 Stage 0 至 Stage N-1 全部完成。 #### Scenario: 阶段顺序由数组决定 - **WHEN** 配置定义 stages 为 `[A, B, C]` - **THEN** 执行顺序固定为 A→B→C,B 的前置是 A 完成,C 的前置是 A 和 B 完成 ### Requirement: 配置 schema 校验 配置加载时 MUST 执行以下校验,任一失败则拒绝加载并给出明确错误信息:stage id 格式、唯一性、保留字检查;pipeline 至少 1 个 stage;validate(若有)是可构造为函数的合法 JS 字符串。 #### Scenario: validate 语法错误 - **WHEN** 某个 stage 的 validate 值为 `return {{{` - **THEN** 配置加载失败,报错指出该 stage 的 validate 不是合法 JS #### Scenario: 空流水线 - **WHEN** 配置文件中 stages 为空数组 - **THEN** 配置加载失败,报错指出流水线至少需要 1 个阶段