Spec Builder 是一个交互式规格构建工具,用于自主编码项目。它的核心作用是把模糊的想法转化为详细、可执行的规格说明,并使其达到可被自主编码流程直接启动的状态。
用途 当用户只有模糊想法、需要帮助定义需求,或希望创建项目规格时,可以使用 Spec Builder。它通过引导式发现流程,帮助用户逐步明确要构建什么,最终输出一份完整的规格。
主要能力 Spec Builder 的工作流程分为四个阶段:
第一阶段:发现(Discovery)。通过核心问题收集基本信息,包括:应用类型(用于归类为 Web、移动端、API 等)、目标用户(定义受众与规模)、3-5 个核心功能(识别必备项)、技术偏好(约束或开放技术栈选择)、约束条件(预算、时间线、集成等)。
第二阶段:细化(Elaboration)。针对每个核心功能展开,包括子功能、用户故事、边界情况和集成点。例如对“页面”功能会展开为层级结构、页面模板、页面分享、页面历史/版本控制等。
第三阶段:技术推荐(Technology Recommendation)。根据需求推荐技术栈,例如前端、编辑器、后端、数据库、实时通信、托管方案等。
第四阶段:规格输出(Specification Output)。生成完整规格,格式为可直接用于 autonomous-master 的 autonomous start 指令,包含核心功能与技术栈说明。
发现问题的机制 核心问题始终会被询问,包括应用类型、用户是谁、3-5 个核心功能、技术偏好、约束条件。此外还有基于回答的追问:提到“authentication”会追问 OAuth 提供商、SSO、MFA;提到“payments”会追问 Stripe、订阅、一次性支付;提到“real-time”会追问聊天、通知、协作;提到“mobile”会追问原生、PWA、React Native;提到“API”会追问 REST、GraphQL、消费方。
项目模板 提供常见项目类型的快速启动模板:SaaS 应用(用户认证与多租户、订阅计费、管理后台、用户设置、API 访问)、电子商务(商品目录、购物车、结账流程、订单管理、库存跟踪)、社交平台(用户资料、帖子/内容流、点赞/评论、关注系统、通知)、内部工具(SSO 认证、基于角色的访问、数据表格/CRUD、报表/仪表盘、审计日志)。
使用方式 用户可以通过自然语言启动,例如“I want to build a todo app”“build spec: project management tool”或“help me define what I want to build”。工具会依次提问并生成规格。生成后,用户可以复制规格或自动调用 autonomous-master。
脚本与参考资源 脚本包括:scripts/spec_builder.py(核心发现引擎)、scripts/question_engine.py(动态问题生成)、scripts/template_expander.py(模板展开)、scripts/tech_recommender.py(技术推荐)、scripts/spec_formatter.py(格式化最终规格)。参考文档包括:references/QUESTION-BANK.md(所有发现问题)、references/TEMPLATES.md(项目模板)、references/TECH-STACKS.md(技术推荐)。模板文件包括:templates/saas.md、templates/ecommerce.md、templates/social.md、templates/internal.md。
适用场景 适合需要从零梳理项目需求、希望获得结构化规格说明、准备使用自主编码工具启动项目的用户。也适合已有清晰构想但需要补充细节的场景。
限制 关于收费、价格、平台支持范围、具体效果等事实,资料中暂未提供。