SuperAPI AI 工具集

planning-stories

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:接收用户故事描述,将其拆解为小型、可验证、可独立完成且不破坏现有功能的任务,产出人类可读的规划文档。

主要能力:默认模式下按数据库/后端/API/前端顺序排列任务以避免破坏构建,为每个任务定义可测试的验证标准(含 typecheck、测试通过、应用无错误运行),生成 STORY.<name>.md,并可选派生 STORY.<name>.TECH-SPEC.md 技术规格。另一模式仅在用户明确要求时启用,生成 Ralph 循环文件 <task-name>.TASK.md 与 <task-name>.progress.txt,由 ralph.sh 自主逐故事迭代执行。

使用方式:默认流程为分析故事、必要时提出澄清问题、拆解任务、定义验证标准、生成 STORY.<name>.md,然后调用 writing-tech-specs 子代理创建技术规格(该技能不可用时跳过并注明)。仅在用户直接要求如“break this into Ralph tasks”或“generate the .TASK.md files”时,才按 ralph-tasks.md 生成任务文件,命名遵循 task-<number>-<description>,用户随后运行 ralph.sh <task-name>.TASK.md。

适用场景:新功能、字段或实体新增与修改、缺陷修复、重构等需要拆解为可验证小任务的开发工作。若故事已是单文件、无数据库与 API 变更、30 分钟内可完成且只有一条验证路径,则可不拆分。

限制:任务不得跨层混合,不得出现前向依赖,避免过细或过宽的拆分;反模式包括模糊验证、缺少回滚方案。Ralph 模式为显式选择,普通故事规划中不得生成 .TASK.md 或 .progress.txt。官方资料未提供具体收费、平台或价格信息。