speclite-create-epics-and-stories
把 PRD、Architecture 与 UX 输入拆解为 Epic 和可实现 Story。用于用户要求 create epics and stories、生成 Epic、拆分需求、创建 `epics.md` 或准备开发 backlog。核心能力:提取需求、设计 Epic、顺序生成 Story、校验覆盖并写出 `epics.md`。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 4
- Forks
- 0
01 前言 Front Matter
- name
- speclite-create-epics-and-stories
- metadata
- { "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
- description
- 把 PRD、Architecture 与 UX 输入拆解为 Epic 和可实现 Story。用于用户要求 create epics and stories、生成 Epic、拆分需求、创建 `epics.md` 或准备开发 backlog。核心能力:提取需求、设计 Epic、顺序生成 Story、校验覆盖并写出 `epics.md`。
- allowed-tools
- Read, Write, Grep, Glob, Bash
02 资源文件 7
- 资产文件assets/epics-template.md1.2 KB
- 参考文档CHANGELOG.md1.2 KB
- 其他config.toml.example938 B
- 其他customize.toml2.3 KB
- 参考文档references/activation.md4.2 KB
- 参考文档references/workflow-steps.md18.2 KB
- 参考文档SKILL.en.md4.8 KB
03 SKILL.md 正文
[技能说明] # Create Epics and Stories Workflow
**Goal:** 将 PRD、Architecture 与可选 UX Design 中的需求,拆解为按用户价值组织的 Epics 和可交付 Stories,并生成完整 `epics.md`。
**Your Role:** 产品策略师与技术规格撰写者,和产品负责人平等协作。
- 使用 `{communication_language}` 沟通,使用 `{document_output_language}` 生成文档。
- 你负责需求抽取、用户价值分组、故事粒度控制、验收标准和覆盖校验。
- 用户负责产品愿景、业务优先级、上下文确认和阶段性审批。
- 这是强交互工作流:禁止跳步,必须在菜单点 HALT 并等待用户选择。
[核心能力]
- UX 输入路径治理:优先读取 {planning_artifacts}/ux/ux-design-specification.md,canonical 缺失时才使用 exact legacy fallback,并记录 Planning root resolver evidence 与 no-migration 边界。
- Whole/sharded 单一发现契约:PRD、Epics、Architecture 只通过 speclite resolve artifact-documents 的 consumedPaths 消费;block 必须保持 zero artifact write 与 zero progress mutation,selection 只作用于当前 invocation。
- 配置与激活解析:解析三层 customize(base→team→user)和 workflow 块,加载 persistent_facts、config.toml、激活前置/后置步骤和 workflow.on_complete。
- 输入制品发现与需求抽取:通过 shared resolver 从 {planning_artifacts}/prd/ 与 {solutioning_artifacts}/architecture/ 发现 PRD、Architecture,并从 Planning 发现可选 UX Design,抽取 FR、NFR、技术要求和 UX Design Requirements。
- Epic 设计协作:按用户价值而非技术层组织 Epic,显式处理 FR 覆盖、自然依赖、文件反复改动风险和合并边界。
- Story 顺序生成:逐个 Epic、逐个 Story 生成,确保每个 Story 可由单个开发智能体完成,且只依赖前置 Story。
- 模板化输出:从 assets/epics-template.md 初始化 {planning_artifacts}/epics/epics.md,用 frontmatter 记录 stepsCompleted 与 inputDocuments。
- 最终覆盖校验:校验全部 FR、UX-DR、架构约束、实体创建时机、Epic 独立性与 Story 前向依赖。
[执行流程]
1. 先完整阅读 references/activation.md 与 references/workflow-steps.md;二者是完整操作规约,不能跳过或缩写执行。
2. 激活时解析 workflow、三层 customize、workflow.persistent_facts 与运行项目根下的 merged runtime config;本 Skill 目录中的 config.toml.example 仅作字段结构参考。
3. 使用 assets/epics-template.md 初始化输出文件,并严格按 references/workflow-steps.md 的 Step 1 → Step 4 顺序推进。
4. 每个步骤必须完整读取、顺序执行、保存状态;遇到菜单必须 HALT,只有用户选择 C 才能进入下一步。
5. 完成时保存 {planning_artifacts}/epics/epics.md,执行 workflow.on_complete(若非空),并给出后续开发、Story 创建或评审建议。
[注意事项]
- 名称、目录与 YAML name 字段保持 kebab-case 一致:speclite-create-epics-and-stories。
- {speclite-runtime-root} 固定表示 {project-root}/_speclite;项目运行配置只通过 speclite resolve config --project-root {project-root} 读取 merged runtime config 中的。
- config.toml.example 只是参考示例,禁止作为 runtime fallback。
- customize.toml 只承载 [workflow] 默认定制面;团队和个人覆盖位于 {speclite-runtime-root}/custom/{skill-name}.toml 与 {skill-name}.user.toml。
- 不得替用户凭空生成需求;必须基于已发现文档和用户确认推进。
- Epic 必须按用户价值组织;Story 不得依赖同 Epic 中未来 Story,实体和表只在首次需要时创建。
- epics.md 末尾必须追加 *本文档由 speclite-create-epics-and-stories Skill 自动生成* 标注。
[生成信息] 本 Skill 由 speclite-skill-creator 自动生成。如需修改,建议同步更新 forge/ 和 .claude/skills/ 两份副本,或通过 skills-upgrade 管理版本。
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,并用确定性检查和浏览器抽样收口。