AGENT SKILL

speclite-create-epics-and-stories

把 PRD、Architecture 与 UX 输入拆解为 Epic 和可实现 Story。用于用户要求 create epics and stories、生成 Epic、拆分需求、创建 `epics.md` 或准备开发 backlog。核心能力:提取需求、设计 Epic、顺序生成 Story、校验覆盖并写出 `epics.md`。

License 许可
MIT
所属仓库
flanliulf/SpecLite
最近更新
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

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

flanliulf
flanliulf/SpecLite

speclite-dev-story

暂无简介

★ 4
flanliulf
flanliulf/SpecLite

speclite-code-review-01-reviewer

Fixture-owned installed skill entry for the minimal artifact loop.

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-lint

只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-creator

创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。

★ 4
flanliulf
flanliulf/SpecLite

speclite-html-ppt-generator

生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。

★ 4
flanliulf
flanliulf/SpecLite

speclite-docs-intro-ppt-creator

生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。

★ 4