SuperAPI AI 工具集

spec-generator

写作与研究

查看项目

更新于 10-15 17:32

技能介绍

用途:把一句话想法逐步扩展为可执行的规格包,覆盖从产品简报、需求(PRD)、架构决策到 Epics/Stories 的完整文档链,最终做跨文档就绪度校验。只做文档生成,不生成或执行代码,完成后交接给 lite-plan、plan、req-plan 等既有工作流。

主要能力:多阶段流程(Phase 0 规格研读、Phase 1 发现、Phase 1.5 需求澄清、Phase 2 产品简报、Phase 3 需求/PRD、Phase 4 架构、Phase 5 Epics/Stories、Phase 6 就绪检查,Phase 6.5 自动修复,最多 2 轮)。使用 Gemini/Codex/Claude 多 CLI 并行分析,提供产品、技术、用户视角;产出 glossary.json 保证术语一致,并提供模板驱动文档与可选代码库探索。

用法:输入想法或文件,默认交互式确认,-y 为全自动模式,-c 从 spec-config.json 断点续跑,-m 等其他标志按资料提及。会话 ID 形如 SPEC-{slug}-{YYYY-MM-DD},工作目录为 .workflow/.spec/${sessionId},用 mkdir -p "${workDir}" 创建;输出含 spec-config.json、product-brief.md、requirements/、architecture/、epics/、readiness-report.md、spec-summary.md。就绪分 ≥80% 通过、60-79% 带提示交接、<60% 触发自动修复。

适用场景:需要规范文档链的产品/技术团队,从想法到可执行故事的规格化过程。

限制:资料明确其为纯文档生成,不写代码;依赖 specs/ 与 templates/ 等前置文档,缺失会影响质量;具体收费、平台支持范围、完整 CLI 版本要求等暂未提供。