GPT Pilot Spec Writer快速教程：把一句话想法变成完整项目规范
【免费下载链接】gpt-pilotThe first real AI developer项目地址: https://gitcode.com/GitHub_Trending/gp/gpt-pilot
开会时说"我们做个带评论的博客站"，没人反对，但第二天每个人写出来的需求文档都不是一回事。GPT Pilot 的 Spec Writer 模块就是为这个问题设计的：让 AI 先把清晰、结构化的项目规范写出来，大家确认后才动手。
一句话定位
GPT Pilot是一个开源的 AI 开发者工具，Spec Writer是它负责"把口头需求写成规范文档"的智能体：你给一句话的项目想法，它输出一份完整、可评审的项目规范。在写任何代码之前，你就知道要做什么、用户会怎么操作。
它能做的五件小事：
- 口头想法变书面规范
- 多轮对话细化规范
- 自动评估项目难度
- 自动判断是否要登录
- 自动选择前端模板
能力一：一句话想法变成完整规范
给一句话，得到一份以用户操作视角写的规范。装好之后，直接用命令行参数传入你的想法：
python main.py --initial-prompt "Build a recipe sharing app with user login"这条命令相当于在启动时的提问里直接输入你的想法，由 Spec Writer 智能体调大模型把描述扩写成完整规范。写作规则写在提示词 core/prompts/spec-writer/build_full_specification.prompt 里，要求模型只关注用户交互，不提技术栈和数据库。
适合场景：你脑子里只有一个模糊的想法，想先拿到一份能评审的基线文档。
能力二：多轮对话细化规范
第一版规范肯定覆盖不全，它会让你反复补充直到满意。规范生成后，它会不断问你这个问题：
while True: user_done_with_description = await self.ask_question( "Are you satisfied with the project description?", buttons={"yes": "Yes", "no": "No, I want to add more details"}, default="yes", buttons_only=True, )这个循环就是细化的核心：选 No，说出缺什么，模型会结合你的新输入重写整份规范；选 Yes，规范定稿。相关逻辑在 core/agents/spec_writer.py 的 change_spec 方法里。
适合场景：第一版规范少了功能点，你想分批补充，而不是从头再解释一遍背景。
能力三：难度评级与登录决策
规范定稿后，它还会自动给项目定难度，并决定要不要做登录功能。评级就是这几行：
complexity = await self.check_prompt_complexity( self.current_state.specification.description ) self.next_state.specification.complexity = complexity模型只返回 hard、moderate、simple 三档之一，影响后续开发计划的拆解方式。它还会跑一次隐藏判断：根据规范内容判断应用是否需要登录，需要时自动生成 JWT 密钥，你不用手动配。
适合场景：立项前想粗略评估工作量，又不想自己梳理认证配置。
最短上手路径 🚀
前提：Python 3.9+ 和一个大模型 API key。
- 获取仓库：
git clone https://gitcode.com/GitHub_Trending/gp/gpt-pilot，然后cd gpt-pilot进入目录。 - 建虚拟环境：
python3 -m venv venv，再source venv/bin/activate激活（Windows 用venv\Scripts\activate）。 - 装依赖：
pip install -r requirements.txt。 - 配模型密钥：
cp example-config.json config.json，在llm段填好 provider 和api_key，示例见 example-config.json。 - 启动：
python main.py，在提示 "Please describe the app you want to build" 时输入你的想法，Spec Writer 就开始干活。
上手前的三个坑 💡
- 第一句描述要具体：规范质量和你给的信息量直接挂钩，写"用户可以按食材搜索菜谱并收藏"，别写"做个菜谱应用"。
- 确认规范后再往下走：按了 Yes，Spec Writer 就会开始套模板、排开发计划；发现遗漏时，在确认循环里改比开发中途改成本低得多。
- 注意代码存放位置：所有生成的代码都放在
workspace下以应用名命名的文件夹里，想翻代码去那儿找。
写在最后
Spec Writer 把"要做什么"从口头共识变成了可评审的文档，为后续代码生成打好地基。现在就试：克隆仓库，跑python main.py，输入你的第一个想法。
【免费下载链接】gpt-pilotThe first real AI developer项目地址: https://gitcode.com/GitHub_Trending/gp/gpt-pilot
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
