【GitHub项目推荐--GSD-2：从“提示词框架”到“真正能自动写代码的 CLI”】⭐⭐⭐

GitHub 地址https://github.com/gsd-build/gsd-2简介GSD-2Get Shit Done v2是一个基于TypeScript​ 和Pi SDK​ 构建的全自动代码生成与工程管理 CLI 工具。它彻底告别了“靠 LLM 自觉执行指令”的旧模式通过直接控制 Agent 会话、Git 工作流和文件系统实现了从需求到可运行代码的无人值守交付。如果说 v1 版本是“给 AI 一张任务清单”那么 v2 就是“雇佣了一个全栈开发团队”。它能自动拆解里程碑、规划切片、执行任务、运行验证lint/test并在完成后生成清晰的 Git 提交记录和 HTML 报告。你只需运行/gsd auto即可“走开并回来验收成品”。主要功能1. 真正的工程级自动化Not Just Prompting直接控制 Agent基于 Pi SDKGSD-2 能直接管理上下文窗口、清理会话垃圾、注入精准文件而非依赖 LLM 的“自觉性”。状态机驱动内置research → plan → execute → verify → commit的完整状态机自动推进项目进度。2. 零干预的 Git 工作流Git Isolation分支隔离每个里程碑Milestone自动创建独立分支或工作树Worktree避免污染主分支。自动合并里程碑完成后自动执行 Squash Merge 回主分支生成原子化提交保持历史清晰可追溯。崩溃恢复进程意外退出后重启可自动读取磁盘状态并从中断点恢复无需人工干预。3. 多模态验证与防呆机制机械验证Must-Haves每个任务必须定义可机械验证的结果如“测试通过”、“lint 无报错”杜绝 AI 的“幻觉式完成”。验证阶梯自动运行配置的验证命令如npm test失败时自动重试修复多次失败则暂停并告警。卡死检测自动检测“死循环”任务如重复提交相同代码并触发诊断模式或停止运行。4. 成本感知与模型路由实时成本看板实时追踪每个阶段、切片的 Token 消耗与预估费用。智能模型降级支持为不同阶段配置不同模型如“规划用 Opus执行用 Haiku”并在接近预算阈值时自动降级模型以节省成本。5. 团队协作支持唯一里程碑 ID通过配置确保多分支、多成员协作时的里程碑 ID 唯一性避免冲突。上下文共享通过.gsd/artifacts目录共享任务摘要和决策记录新成员接入无需重复“考古”。安装与配置环境要求Node.js必须使用 Node.js 24 LTS。Homebrew 默认安装的 Development 版本可能导致兼容性问题建议使用nvm或直接下载 LTS 版本。包管理器推荐使用npm或yarn。安装步骤全局安装npm install -g gsd-pi初始化配置首次运行gsd命令会启动交互式配置向导LLM 提供商支持 Anthropic (Claude)、OpenAI、Google Gemini、OpenRouter 等 20 提供商。认证方式支持 API Key 或 OAuth如直接使用 Claude Max 订阅令牌但需注意合规风险。工具密钥可选配置 Brave Search、Slack Webhook 等。关键配置说明全局配置位于~/.gsd/PREFERENCES.md。项目级配置位于项目根目录的.gsd/PREFERENCES.md。Agent 指令使用AGENTS.md或CLAUDE.md文件定义代码规范与架构约束替代旧版的agent-instructions.md。如何使用1. 项目初始化在已有项目或新项目根目录下确保存在ROADMAP.md或phases/目录来定义里程碑结构。若无GSD 会引导你创建。2. 两种核心模式Step Mode单步模式运行gsd或gsd next。推荐新手使用它会逐步执行每个阶段规划→执行→验证并在每一步暂停等待你确认便于调试和审查。Auto Mode全自动模式运行gsd auto。真正的生产力模式。启动后即可关闭终端GSD 会按状态机自动完成整个里程碑的所有工作包括 Git 提交和报告生成。3. 监控与干预状态看板随时运行gsd status或按CtrlAltG查看实时进度、当前任务和累计成本。暂停与恢复在 TUI 界面按Escape可暂停自动模式进行人工检查后输入/gsd auto继续运行。Headless 模式使用gsd headless用于 CI/CD 流水线它无 TUI 界面通过退出码0成功, 1错误, 2阻塞反馈状态。应用场景实例无代码场景一个人 Side Project 从 0 到 1痛点你想开发一个 Markdown 转 PPT 的工具但只有想法不想写脚手架、配置构建工具和 CI。GSD-2 方案创建ROADMAP.md定义三个里程碑M001初始化 Node.js 项目、M002核心转换逻辑、M003CLI 封装。运行gsd auto。结果3 小时后回来发现项目已初始化了package.json、配置了 TypeScript 和 Jest 测试、实现了核心函数并通过了所有测试且 Git 历史是清晰的 3 个 Squash 提交。你只需运行npm start验证即可。场景二遗留代码库的“AI 重构”痛点接手一个无测试、结构混乱的旧 Python 脚本需要重构但不敢动刀。GSD-2 方案将旧代码放入目录创建ROADMAP.md定义M001代码静态分析、M002补充单元测试、M003模块化重构。在.gsd/PREFERENCES.md中设置verification_commands: [pytest]和verification_max_retries: 3。运行gsd auto。结果GSD 会自动分析依赖优先为关键函数补写测试用例确保安全网然后在测试通过的前提下进行重构。如果重构导致测试失败它会自动回滚并尝试其他策略直到验证通过才提交。场景三团队技术栈统一迁移痛点团队有 10 个老项目需要统一从 Webpack 4 迁移至 Vite并更新 ESLint 规则。GSD-2 方案创建标准的ROADMAP.migration.md模板和AGENTS.md定义团队编码规范。在每个项目根目录运行gsd headless --milestone migration。结果10 个项目并行执行迁移任务。GSD 会自动处理每个项目的依赖差异运行npm run build验证迁移成功并在失败时生成详细的 HTML 报告供后续排查。所有变更都集中在独立的milestone/migration-*分支上主程只需审查合并即可。总结GSD-2 不是另一个“聊天式编程”工具而是一个软件工程执行引擎。它将 AI 从“聪明的助手”升级为“可信的执行者”通过严格的机械验证和 Git 隔离让开发者敢于将重复性、标准化的开发工作全权交付。对于独立开发者它是 24 小时待命的编程伙伴对于团队它是可重复、可审计的自动化重构流水线。GitHub 地址https://github.com/gsd-build/gsd-2