SuperAPI AI 工具集

story-plan

写作与研究

查看项目

更新于 10-15 23:42

技能介绍

用途:在已有用户故事(US)下创建或更新技术任务(TK-XXX)规格文档,用于规划实现、拆分工作。任务是技术规格,描述目标、实现方式与依赖,不实现代码、不执行测试、不创建 ADR。

必要用法:必须由 docs-specialist 子代理执行,不可直接运行。任务路径为 docs/product/user-stories/US-XXX-[名称]/TK-XXX-[kebab-case].md,文件名 TK-XXX 大写、编号按故事内顺序三位补零,正文须先读 references/task-template.md。

两种流程:stub 仅保留 ID 与 US 关联,状态 Draft,单元可“Por definir”;完整 TK 需定义工作单元、可验证描述、依赖、实现计划、有效引用,满足检查清单后才能标 Ready。UI 类 TK 的 Ready 必须有 Figma、线框图或高保真图参考。缺信息时不猜测,向用户提问。

限制:不得在 US 处于 Draft 时创建 TK;需检测与已有 TK 的范围重叠;不得在 work-units.md 罗列 TK、DTO 或技术文档;不得用 glossary 代替 ADR 或技术文档;不得编造流程、实体或集成。平台、收费与安装方式暂未提供。