| name | speclite-sprint-planning |
| description | 执行 SpecLite Sprint Planning workflow，把 Epic/Story 规划成 sprint 跟踪状态。用于用户要求 sprint planning、生成 sprint plan、创建 sprint-status.yaml 或计划开发批次。核心能力：配置驱动激活、读取规划产物、生成状态文件、给出下一步建议。 |
| allowed-tools | Read, Write, Bash, Grep, Glob, WebSearch |
| metadata | {"version":"1.0.1","author":"fancyliu","catalog":"speclite"} |
[技能说明]
Sprint Planning 是 Speclite 实施与交付推进工作流 Skill，用于在目标项目中按配置语言、输出语言和工作流步骤完成对应制品或交付动作。
源入口说明：Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"
[核心能力]
- Speclite 激活解析：解析三层 customize（base→team→user）、workflow.persistent_facts 和 workflow.on_complete，并通过 speclite resolve config --project-root {project-root} 加载 merged runtime config。
- 源制品发现与上下文加载：按 workflow 规约读取项目制品、配置字段、历史上下文和必要数据文件，保持源流程的输入发现语义。
- 步骤化工作流执行：按 references/workflow-details.md 与拆分后的 reference/step 文件逐步执行，遵守顺序、HALT 条件、菜单等待和状态推进规则。
- 模板化输出生成：使用 assets 中的模板或示例骨架生成文档、报告、规格或交付产物，输出语言服从 document_output_language。
- Story 位置标准化：生成的 sprint-status 默认把 story_location 指向 {implementation_artifacts}/stories，使 Story 生产方与消费方路径一致。
- 质量校验与交接：执行清单、报告、状态同步或 completion handoff，并在退出前解析和执行 workflow.on_complete。
- 迁移一致性约束：当前运行规约只依赖 Speclite runtime，不读取旧运行目录、旧配置文件或旧命令命名空间。
[约定]
裸路径相对于 {skill-root} 解析；{project-root} 是目标项目工作目录；{speclite-runtime-root} 是 {project-root}/_speclite；{skill-name} 是目录 basename。
[激活流程]
触发后先解析 workflow，执行 activation_steps_prepend，加载 persistent_facts，运行 speclite resolve config --project-root {project-root}，按 communication_language 与用户沟通，并执行 activation_steps_append。配置文件缺失或关键字段为空时必须 HALT；config.toml.example 只说明字段结构，不作为 runtime fallback。
customization 必须通过 `speclite resolve customization --skill {skill-root} --project-root {project-root}` 读取 merged JSON；`workflow.on_complete` 使用 `speclite resolve customization --skill {skill-root} --project-root {project-root} --key workflow.on_complete` 解析。默认 activation 不手写 TOML merge，不使用 `--human` 作为 machine input。
[执行流程]
1. 先完整阅读 references/workflow-details.md；该文件是从源入口转换后的权威工作流规约。随后按需读取 references/workflow-details.md、references/checklist.md。
2. 执行工作流前，确认 {skill-root}、{project-root}、{speclite-runtime-root}、{skill-name} 四个路径变量均已明确。
3. 若 workflow 指向 step 文件，必须一次只读取当前 step，完整执行后再进入下一步；遇到菜单或用户确认点时 HALT 等待。
4. 生成 sprint-status 时，默认 story_location 与 story_location_absolute 指向 {implementation_artifacts}/stories，不得回退到 {implementation_artifacts} 根目录。
5. 生成或更新产物时，按源 workflow 的模板、清单、状态字段和输出位置要求执行，不得因为迁移而改变核心需求。
6. 收尾前运行 checklist 或质量检查，解析 workflow.on_complete，并在输出文档末尾追加本 Skill 的生成标注。
[注意事项]
- 名称、目录与 YAML name 字段保持 kebab-case 一致：speclite-sprint-planning。
- references/workflow-details.md 和配套 reference 文件均为有效执行规约，不是背景资料。
- 模板或示例骨架位于 assets/sprint-status-template.yaml。
- 如工作流需要项目配置，必须读取目标项目运行时配置。
- config.toml.example 仅作字段结构参考，不作为 runtime fallback。
- 当前运行规约不得依赖旧运行目录、旧 YAML 配置或旧命令命名空间。
- 输出文档末尾必须追加 *本文档由 speclite-sprint-planning Skill 自动生成* 标注。
[生成信息]
本 Skill 由 speclite-skill-creator 自动生成。
