| name | speclite-checkpoint-preview |
| description | 执行 SpecLite Checkpoint Preview workflow，帮助人工检查一次变更的关键差异与风险。用于用户要求 checkpoint、human review、walk me through this change、检查变更或预览当前改动。核心能力：配置驱动激活、发现相关产物、按步骤编排、输出可审阅摘要。 |
| allowed-tools | Read, Write, Bash, Grep, Glob, WebSearch |
| metadata | {"version":"1.0.0","author":"fancyliu","catalog":"speclite"} |
[技能说明]
Checkpoint Preview 是 Speclite 实施与交付推进工作流 Skill，用于在目标项目中按配置语言、输出语言和工作流步骤完成对应制品或交付动作。
源入口说明：LLM-assisted human-in-the-loop review. Make sense of a change, focus attention where it matters, test. Use when the user says "checkpoint", "human review", or "walk me through this change".
[核心能力]
- 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。
- 质量校验与交接：执行清单、报告、状态同步或 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/generate-trail.md、references/steps/step-01-orientation.md、references/steps/step-02-walkthrough.md、references/steps/step-03-detail-pass.md、references/steps/step-04-testing.md 等 reference 文件。
2. 执行工作流前，确认 {skill-root}、{project-root}、{speclite-runtime-root}、{skill-name} 四个路径变量均已明确。
3. 若 workflow 指向 step 文件，必须一次只读取当前 step，完整执行后再进入下一步；遇到菜单或用户确认点时 HALT 等待。
4. 生成或更新产物时，按源 workflow 的模板、清单、状态字段和输出位置要求执行，不得因为迁移而改变核心需求。
5. 收尾前运行 checklist 或质量检查，解析 workflow.on_complete，并在输出文档末尾追加本 Skill 的生成标注。
[注意事项]
- 名称、目录与 YAML name 字段保持 kebab-case 一致：speclite-checkpoint-preview。
- references/workflow-details.md 和配套 reference 文件均为有效执行规约，不是背景资料。
- 如工作流需要模板，必须从 assets/ 中读取，不得临时省略模板结构。
- 如工作流需要项目配置，必须读取目标项目运行时配置。
- config.toml.example 仅作字段结构参考，不作为 runtime fallback。
- 当前运行规约不得依赖旧运行目录、旧 YAML 配置或旧命令命名空间。
- 输出文档末尾必须追加 *本文档由 speclite-checkpoint-preview Skill 自动生成* 标注。
[生成信息]
本 Skill 由 speclite-skill-creator 自动生成。
