SuperAPI AI 工具集

maestro-spec-generate

智能体与模型

查看项目

更新于 10-15 20:11

技能介绍

用途:把一个想法或主题(直接文本、@文件或头脑风暴会话)转成完整规格包,通过两波 CSV 流水线执行。

主要能力:第一波并行运行三个研究代理,分别负责领域研究、竞品分析与技术栈分析,发现结果通过 discoveries.ndjson 共享板交换;第二波由单个合成代理按序产出 7 阶段文档链——产品简报、PRD/需求(REQ-、NFR-)、架构(ADR-*)、数据模型、API 规格、UI 线框、Epic 到路线图,并生成 glossary.json 统一术语。第三阶段汇总结果、导出 results.csv,并按完整性、一致性、可追溯性、深度各 25% 计算就绪度评分,>=80% 通过,60-79% 带保留通过,<60% 记录问题后继续。

使用方式: $maestro-spec-generate "Build a real-time collaboration platform" $maestro-spec-generate -y "@requirements.md" $maestro-spec-generate --skip-research "CLI workflow orchestration tool" $maestro-spec-generate --from-brainstorm WFS-001 "Enhance auth system" 标志:-y/--yes 跳过全部确认;--skip-research 跳过第一波研究直接生成文档;--from-brainstorm SESSION-ID 导入指定会话的 guidance-specification.md 作为种子。核心通过 spawn_agents_on_csv 执行,主状态记录在 tasks.csv(字段含 id、title、description、research_focus、doc_phase、deps、context_from、wave、status、findings、output_file、error)。

输出:会话目录 .workflow/.csv-wave/{session-id}/ 下生成 tasks.csv、results.csv、discoveries.ndjson、context.md、spec-config.json;规格包写入 .workflow/.spec/SPEC-{slug}-{date}/,路线图写入 .workflow/roadmap.md。

适用场景:需要从零到一产出可追溯规格文档的产品或技术项目,尤其希望并行做前期调研再统一合成文档时。

限制:文档未提供定价、平台支持或具体模型信息;发现板为只追加,不得修改或清空;两波顺序不可颠倒;研究代理失败时文档链降级为仅用种子输入运行;错误包括未提供主题、会话或文件不存在、代理超时、CSV 解析错误等,均有对应处理说明。