메뉴
执行 SpecLite Checkpoint Preview workflow，帮助人工检查一次变更的关键差异与风险。用于用户要求 checkpoint、human review、walk me through this change、检查变更或预览当前改动。核心能力：配置驱动激活、发现相关产物、按步骤编排、输出可审阅摘要。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
检查 SpecLite canonical source 变更后的派生一致性。用于用户要求 canonical source check、检查 assets/source/speclite、canonical 变更闭环、更新 skill/hook/agent 后验收或扫描 sdlc/core/total 数量。核心能力：对齐 root counts、module-help.csv、hook source、baseline 常量、fixtures、docs 和 packaging manifest。
分析当前 SpecLite workflow 状态并回答使用问题或推荐下一步 skill。用于用户询问 help、next skill、下一步、我现在该做什么或需要流程定位。核心能力：读取 catalog、配置、产物与项目知识，给出有证据的路由建议。
Analyze brownfield backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'tech stack audit', 'backend stack', 'brownfield tech stack', 'code-fact based stack', '技术栈分析', '后端技术栈', '项目技术栈清单', '基于代码事实', '输出到目录', or asks to generate a stack inventory from an existing backend repository. Capable of ecosystem-neutral repository discovery, dependency/version evidence classification, runtime configuration extraction, uncertainty tagging, and evidence-linked Markdown generation.
Analyze brownfield Java and Spring Boot backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'Java tech stack', 'Spring Boot stack', 'Maven dependency audit', 'Java 后端技术栈', 'SpringBoot 技术栈', 'Spring Boot 技术栈', 'Maven 依赖分析', '基于代码事实', or asks to generate a Java backend stack inventory. Capable of Maven/Gradle module discovery, effective dependency and BOM version resolution, Spring ecosystem detection, runtime configuration extraction, and evidence-linked Markdown generation.
Analyze brownfield Node.js backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'Node.js tech stack', 'NestJS stack', 'Express stack', 'package lock audit', 'Node 后端技术栈', 'Node.js 技术栈', 'NestJS 技术栈', 'npm 依赖分析', '基于代码事实', or asks to generate a Node backend stack inventory. Capable of package-manager detection, lockfile version resolution, Node runtime evidence extraction, framework detection, and evidence-linked Markdown generation.
Analyze brownfield Python backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'Python tech stack', 'FastAPI stack', 'Django stack', 'requirements audit', 'Python 后端技术栈', 'FastAPI 技术栈', 'Django 技术栈', 'Python 依赖分析', '基于代码事实', or asks to generate a Python backend stack inventory. Capable of Python packaging detection, lockfile/requirements version resolution, runtime evidence extraction, ASGI/WSGI framework detection, and evidence-linked Markdown generation.
| 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 自动生成。