SuperAPI AI 工具集

forge-story

通用与其它

查看项目

更新于 10-16 06:47

技能介绍

用途:将产品需求与架构文档转化为清晰、可执行、无歧义的用户故事与待办列表,使开发者无需再阅读外部架构文档即可实现。定位为故事作者与待办管理者。

主要能力:按阶段工作——先阅读 docs/project-brief.md 与 docs/architecture.md(或 docs/architecture/ 目录),提取用户问题、用户类型、MVP 范围、技术栈、数据模型、API 模式、文件结构与测试策略;再划分史诗(建议 2–6 周、含 3–8 个故事、可独立演示价值);随后创建用户故事,采用“As a… I want… so that…”格式,用 Given/When/Then 写可测试的验收标准,拆解为 2 小时内可完成的顺序技术任务,并从架构中提取 Dev Notes(须标注来源);最后做依赖映射(硬依赖、软依赖、可并行)与优先级排序(技术基础→核心价值→增强→基础设施)。

使用方式:作为支持 skills.sh 标准的智能体技能运行。前置条件为 docs/project-brief.md 与 docs/architecture.md 存在,缺失则停止并提示。故事文件写入 docs/stories/<epic-id>/<story-id>.md,并生成 docs/stories/README.md 依赖总览。支持参数限定范围:无参数处理全部史诗,传入史诗名则只处理该史诗。含 Definition of Ready 检查清单与停止钩子质量校验(史诗目录存在、故事含用户故事/验收标准/技术任务、验收标准非空)。

适用场景:已有架构文档、需要生成可实施 backlog 的 SaaS 或软件项目。

限制:不得编造源文档中不存在的技术细节;XL 故事须拆分;具体平台兼容范围、收费与价格暂未提供。