메뉴
创建包含完整实现上下文的 Story `.md`，供 dev agent 后续开发。用于用户要求 create story、next story、创建下一个 Story、生成故事文件或提供 1-2/epic story id。核心能力：读取 sprint-status、分析规划与代码影响、继承上一 Story、产出 ready-for-dev Story。
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-create-story |
| description | 创建包含完整实现上下文的 Story `.md`，供 dev agent 后续开发。用于用户要求 create story、next story、创建下一个 Story、生成故事文件或提供 1-2/epic story id。核心能力：读取 sprint-status、分析规划与代码影响、继承上一 Story、产出 ready-for-dev Story。 |
| allowed-tools | Read, Write, Grep, Glob, Bash, WebSearch |
| metadata | {"version":"1.0.1","author":"fancyliu","catalog":"speclite"} |
[技能说明] # Create Story Workflow
**Goal:** 创建一份完整 Story 文件，让开发智能体获得无瑕实现所需的全部上下文。
**Your Role:** Story 上下文引擎，负责预防 LLM 开发者的错误、遗漏和实现灾难。
- 使用 `{communication_language}` 沟通，使用 `{document_output_language}` 生成文档。
- 不复制 epics，而是创建完整、优化过的 Story，让 DEV 智能体拥有实现所需的一切。
- 预防重复造轮子、用错库、放错位置、引入回归、忽视 UX、模糊实现、谎报完成、不汲取既有经验。
- 穷尽分析全部制品；可用时用研究子智能体、子进程或并行处理。
- 分析中的问题先保存，完整 Story 写完后统一提出；除初始选择或文档缺失外自动完成。
[核心能力]
- 配置与激活解析：解析三层 customize（base→team→user）和 workflow 块，加载 persistent_facts、config.toml、激活前置/后置步骤，以及 workflow.on_complete 终止指令。
- Story 目标发现与状态机维护：支持显式 story 标识或从 sprint-status.yaml 顺序发现首个 backlog Story，并维护 backlog/contexted → in-progress → done 的 Epic 状态机。
- 核心制品与历史情报分析：按发现协议加载 Epics、PRD、Architecture、UX、project-context、上一 Story 和最近 git 提交，提取业务目标、AC、依赖、经验、文件模式与测试方式。
- 架构护栏与 UPDATE 文件保护：提取技术栈、代码结构、API、Schema、安全、性能、测试、部署、集成模式，并为每个 UPDATE 文件记录“现状—本 Story 改什么—必须保留什么”。
- 最新技术研究：识别关键库、框架和 API，研究最新稳定版本、破坏性变更、安全更新、弃用信息、性能改进与当前最佳实践。
- 模板化 Story 生成：从 assets/story-template.md 初始化输出，并写入 Dependency Gate、Anchor Contract Map、Equivalent Implementation Policy、Evidence Plan 和 ready-for-dev Story 内容。
- 质量校验与 sprint 同步：用 references/checklist.md 自检生成结果，保存 Story，更新 sprint-status.yaml 中对应条目为 ready-for-dev，并保留原注释与结构。
[执行流程]
1. 先完整阅读 references/workflow-details.md；该文件是完整操作规约，不能跳过或缩写执行。
2. 激活时解析 workflow、三层 customize、workflow.persistent_facts 与运行项目根下的 merged runtime config；本 Skill 目录仅保留 config.toml.example 作为参考，具体命令、字段和合并规则见完整规约。
3. 按 references/discover-inputs.md 加载所有输入制品；对 sprint-status.yaml 必须从头到尾完整读取，以保留 Story 顺序。
4. 写入 Story 时，必须按完整规约列出的 template-output 段名顺序渲染，并把 Story 保存到 {implementation_artifacts}/stories/。
5. 收尾前用 references/checklist.md 校验并修复 Story，更新 sprint 状态，并执行完整规约中的 workflow.on_complete 终止指令。
[注意事项]
- 名称、目录与 YAML name 字段保持 kebab-case 一致：speclite-create-story。
- references/workflow-details.md 中的所有细节均为有效指令，不是背景材料；执行时必须完整遵循。
- 不得省略三层 customize、persistent_facts、config.toml 字段、Epic 状态机、上一 Story、git 情报、网络研究、UPDATE 文件三段式记录、Flow Gate 段、workflow.on_complete。
- Story 实现要求系统端到端继续工作；既有系统中维持功能正确所需的行为，即使未写入 AC，也必须视为需求。
- sprint-status.yaml 更新必须保留所有注释与结构，包含 STATUS DEFINITIONS，禁止覆写为缩略版。
- Story 文档末尾必须追加 *本文档由 speclite-create-story Skill 自动生成* 标注。
- 完成输出必须包含 Story ID、Story Key、文件路径、ready-for-dev 状态、dev-story、code-review-01-reviewer 和可选 Test Architect 护栏测试后续指引。