speclite-implementation-readiness-check
执行 SpecLite Check Implementation Readiness workflow,验证 PRD、UX、Architecture 与 Epics 是否可进入实现。用于用户要求 check implementation readiness、readiness gate、实施就绪检查或运行 IR。核心能力:配置驱动激活、读取规划产物、按步骤审计、输出 readiness 报告。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 4
- Forks
- 0
01 前言 Front Matter
- name
- speclite-implementation-readiness-check
- metadata
- { "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
- description
- 执行 SpecLite Check Implementation Readiness workflow,验证 PRD、UX、Architecture 与 Epics 是否可进入实现。用于用户要求 check implementation readiness、readiness gate、实施就绪检查或运行 IR。核心能力:配置驱动激活、读取规划产物、按步骤审计、输出 readiness 报告。
- allowed-tools
- Read, Write, Bash, Grep, Glob, WebSearch
02 资源文件 12
- 资产文件assets/readiness-report-template.md95 B
- 参考文档CHANGELOG.md351 B
- 其他config.toml.example917 B
- 其他customize.toml1.6 KB
- 参考文档references/steps/step-01-document-discovery.md8.7 KB
- 参考文档references/steps/step-02-prd-analysis.md4.4 KB
- 参考文档references/steps/step-03-epic-coverage-validation.md4.0 KB
- 参考文档references/steps/step-04-ux-alignment.md3.9 KB
- 参考文档references/steps/step-05-epic-quality-review.md6.6 KB
- 参考文档references/steps/step-06-final-assessment.md3.5 KB
- 参考文档references/workflow-details.md5.2 KB
- 参考文档SKILL.en.md4.8 KB
03 SKILL.md 正文
[技能说明] Check Implementation Readiness 是 Speclite 方案与架构准备工作流 Skill,用于在目标项目中按配置语言、输出语言和工作流步骤完成对应制品或交付动作。
源入口说明:Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".
[核心能力]
- UX 单一路径发现:通过 Planning root resolver evidence 优先消费 {planning_artifacts}/ux/ux-design-specification.md,仅在其缺失时只读消费 exact legacy fallback,并记录 resolvedRoot、resolutionMode、actualConsumedPath。
- Whole/sharded 单一发现契约:PRD、Epics、Architecture 只通过 speclite resolve artifact-documents 的 consumedPaths 消费;block 必须保持 zero artifact write 与 zero progress mutation,selection 只作用于当前 invocation。
- Readiness 输出与历史发现:新报告固定写入 {solutioning_artifacts}/implementation-readiness-report/grill-consistency/implementation-readiness-report-{yyyy-MM-dd}.md;既有 Planning root readiness reports 与 {planning_artifacts}/ir-grill/ 仅作为历史 evidence 原位发现,不迁移、重命名或删除。
- 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/steps/step-01-document-discovery.md、references/steps/step-02-prd-analysis.md、references/steps/step-03-epic-coverage-validation.md、references/steps/step-04-ux-alignment.md、references/steps/step-05-epic-quality-review.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-implementation-readiness-check。
- references/workflow-details.md 和配套 reference 文件均为有效执行规约,不是背景资料。
- 模板或示例骨架位于 assets/readiness-report-template.md。
- 如工作流需要项目配置,必须读取目标项目运行时配置。
- config.toml.example 仅作字段结构参考,不作为 runtime fallback。
- 当前运行规约不得依赖旧运行目录、旧 YAML 配置或旧命令命名空间。
- 输出文档末尾必须追加 *本文档由 speclite-implementation-readiness-check Skill 自动生成* 标注。
[生成信息] 本 Skill 由 speclite-skill-creator 自动生成。
04 同仓库更多 Skills
speclite-dev-story
暂无简介
speclite-code-review-01-reviewer
Fixture-owned installed skill entry for the minimal artifact loop.
speclite-skill-lint
只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。
speclite-skill-creator
创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。
speclite-html-ppt-generator
生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。
speclite-docs-intro-ppt-creator
生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。