speclite-goal-orchestrator-epic-story-code-review-runner

Speclite Goal Orchestrator Epic Story Code Review Runner（Epic Story 开发与代码审查执行器）

Overview（概述）

本 Skill 是 Epic 粒度 Story 开发与 CR 闭环的全局编排层。它只负责目标拆解、strict serial 调度、Flow Gate、CR v2 状态机、收敛控制、状态同步和最终本地提交，不替代被编排 Skill 的内部能力。

同一时间只能推进一个 Story、一个外层 sub-agent、一个状态迁移。所有 current decision 必须来自结构化 frontmatter，不得解析“通过”“不通过”“Approved”等 prose 关键词。

Activation Boundary（激活边界）

仅在用户要求以 Epic 或明确 Story 集合为范围，执行 development → review → evaluate → fix/verify → closeout 的 strict-serial 闭环，并要求 fresh outer sub-agent、goal records 或最终本地提交时使用本 Skill。

以下情况不要使用本 Skill：

• 只开发单个 Story 且不要求完整 CR 闭环；
• 只运行一次 reviewer、evaluator、fixer 或 finalizer；
• 用户只询问状态，未授权开发、状态推进或提交；
• 用户明确要求并行推进多个 Story；
• 任务属于 Story Review，应使用对应 SR runner。

Core Capabilities（核心能力）

• 严格串行编排：每次只推进一个 Story 和一个外层状态迁移。
• 结构化 CR v2 路由：按 exact schema、verdict、scope hash 和 round binding 路由。
• 有界收敛：按 finding fingerprint、quorum、churn 与 stop-loss 机械收敛。
• 可恢复执行：根据 current structured artifact 和 goal records 决定唯一下一状态，不重复已完成步骤。
• 安全收口：校验 evidence freshness、TODO 映射、tracker 原子同步与本地提交边界。

Contract（共享契约）

执行前必须完整读取 {skills-root}/speclite-code-review-contract/references/cr-contract.md。独立的 speclite-code-review-contract package 是 CR01–06 与 runner 的唯一规范性共享契约 owner，定义 identity、路径、scope manifest、artifact schema、verdict、finding fingerprint、layer quorum、round binding、state machine、freshness 和 TODO/rules governance。

共享契约不可读或关键字段无法解析时 HALT。

Inputs（输入）

• epicId：目标 Epic，例如 8。
• storyScope：Epic 全部 Story 或用户明确指定的子集。
• projectRoot：目标项目根目录。
• modelPolicy：默认使用当前环境配置；如用户指定模型则遵从，并如实记录实际模型。
• commitPolicy：默认中文 Conventional Commit、本地提交、不 push。
• confirmationPolicy：explicit | preauthorized；默认 explicit，只能由用户请求或已确认授权范围切换。

无法识别 Epic、Story 列表、project root 或授权范围时 HALT 并询问，不得猜测。

Runtime Activation（运行时激活）

1. 运行 speclite resolve config --project-root {projectRoot}。
2. 读取 merged planning_artifacts、implementation_artifacts 和 workflow tracker 配置。
3. 将当前 Skill 目录父目录解析为 {skills-root}。
4. 读取 {skills-root}/speclite-code-review-contract/references/cr-contract.md。
5. 运行一次 speclite resolve cr-directory --story-id {storyId} --review-series {reviewSeries} --project-root {projectRoot}，冻结 crDir 并传给 CR01–06；continuation=block 时 HALT。
6. 解析失败、关键路径为空或 Story identity 冲突时 HALT；config.toml.example 和历史默认目录不能作为 fallback。