super-dev
AI 编程工具的工程治理层,三文档强制门+12阶段流水线让 AI 开发从「写得快」进化到「交付稳」
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
AI 编程工具的工程治理层,三文档强制门+12阶段流水线让 AI 开发从「写得快」进化到「交付稳」
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
2025 年第三季度,上海某创业公司的 CTO 李明(化名)遇到了一个让他夜不能寐的问题:团队接入了 Claude Code、Cursor 等 AI 编程工具,开发者们用得很嗨,每天代码产出量翻了两倍。但三个月后回头一看——代码仓库里塞满了未经评审的功能、需求文档与实现完全对不上号、上线前才发现某模块根本没有测试。AI 确实帮团队"写得快"了,但没有人敢说"交付稳"。
这不是一家公司的困境。随着 Claude Code、Cursor、Codex CLI、Kiro 等 AI 编程工具在 2025 年的迅速普及,无数开发团队都面临同一个问题:AI 能写代码,但不知道怎么让它稳定交付一个商业项目。 Super Dev 正是在这个时间点出现的——它不是又一个代码生成器,而是一套"宿主教练系统",专门解决 AI 编程工具的"最后一公里"问题。
Super Dev 的核心定位,可以用一句话概括:"宿主是执行者,Super Dev 是产品总监。"
传统的 AI 编程工具(Claude Code、Cursor 等)本质上是一个强大的"执行代理":接收指令、读取代码、生成文件、执行终端命令。但它们天然缺乏产品视角——不知道需求从哪来、不管设计稿对不对、不关心交付标准是什么。一个 Claude Code 会很认真地帮你写 3000 行代码,却不会主动问你:"这个功能的目标用户是谁?验收标准是什么?有没有安全风险要评估?"
Super Dev 就是在 AI 编程工具之上叠加了一层"工程治理层":它把宿主里的模型能力训练成一套稳定、清晰、可审计、能做商业项目的交付流程。就像给一个天赋异禀但缺乏项目管理经验的新人,配上了一位资深产品总监 + 架构师 + QA 负责人组成的虚拟团队。
从技术架构看,Super Dev 采用了模块化的插件化设计,核心由 Python 实现(super_dev/ 目录),通过 CLI 入口(cli.py)提供命令交互。项目支持完整的容器化部署:既有标准的 Dockerfile,也有 docker-compose.yml 一键启动方案,还提供了 k8s/ 目录下的 Kubernetes manifest,真正做到了"装完就能跑"。部署难度极低,官方推荐的安装方式只需一条命令:uv tool install super-dev,整个过程不超过 5 分钟。
Super Dev 的核心是一套经过精心设计的 12 阶段流水线,涵盖从"需求输入"到"产品交付"的全生命周期。这套流水线被组织为 9 个治理阶段、2 道强制确认门和 10 个专家 Agent 协作节点。
第一阶段:Research 与需求增强。 当用户在宿主中输入需求时,Super Dev 不会立刻开始写代码。它会先启动 Research 模式——读取项目本地的 knowledge/ 知识库、联网研究同类产品、补全边界条件、异常路径和验收口径。这一步解决的是"AI 不知道上下文"的问题。传统的 AI 编程工具只能依赖 prompt 里提供的信息,而 Super Dev 会主动构建知识上下文。
第二阶段:三文档与 Spec 确认门。 这是 Super Dev 设计最精妙的地方——它要求在开始编码之前,必须生成三份文档:PRD(产品需求文档)、Architecture(架构设计文档)、UI/UX(界面设计文档)。三文档未经用户确认,Super Dev 不会创建 Spec,也不会开始编码。这道强制确认门从流程上杜绝了"边做边改、做到哪算哪"的混乱开发模式。文档驱动,而不是代码驱动——这是 Super Dev 与其他 AI 编程辅助工具最本质的区别。
第三阶段:前端优先验证门。 假设你要做一个 ToB 管理后台,传统的 AI 开发流程会一次性生成前后端代码,然后在联调阶段才发现前端根本没法用。Super Dev 的策略是"前端优先":先把前端做出来并运行验证,有了前端 runtime 通过的证据,才允许进入后端与中后段。这道门的核心理念是:用户能看见的东西,应该优先验证。 避免了后端写完才发现前端交互逻辑有问题的返工。
第四阶段:10 专家 Agent 协作。 在实现与质量保障环节,Super Dev 会调动 10 个虚拟专家 Agent 协作:PM(产品经理)、架构师、UI/UX 设计师、安全专家、代码审查员、DBA、QA 工程师、DevOps 工程师、RCA(根因分析)工程师,以及一个综合协调 Agent。每个 Agent 都有明确的职责边界,从各自专业角度审视代码和设计,确保交付质量。
第五阶段:质量门禁与发布演练。 交付包未 ready 或发布演练未通过,Super Dev 不允许宣称项目完成。这包括 UI Review、红队安全检查、交付包完整性验证、发布 rehearsal 等环节。每个阶段的产出物都会被记录到 output/ 目录,形成可追溯的交付证据链。
Super Dev 最有野心的设计之一,是它的"宿主接入矩阵"。目前支持 12 个 CLI 工具(Claude Code、Codex CLI、Droid CLI、Copilot CLI、Cursor CLI、Gemini CLI、Kiro CLI、OpenCode、Qoder CLI、Qwen Code 等)、9 个 IDE(Cursor、CodeBuddy、Trae、Windsurf、Kiro 等)和 5 个桌面助手(Claude App、Codex App/Desktop、Trae SOLO 等)。
这意味着无论团队使用哪种 AI 编程工具,只需要按照 Super Dev 提供的"宿主第一句"接入,就能获得完全一致的交付流程和工程质量标准。对于多工具混用的团队(比如前端用 Cursor、后端用 Claude Code),Super Dev 解决了"不同工具产出质量参差不齐"的问题。
接入流程极度简洁:在项目目录运行 super-dev,安装器会自动检测宿主类型并写入项目级接入面,生成一份 host-onboard-smoke-*.md 文件,里面包含了标准流第一句、比赛流第一句、接入后先验等关键信息。用户只需要复制粘贴即可开始工作。官方承诺从安装到宿主第一条指令,5 分钟内完成。
从代码结构看,Super Dev 采用了前后端分离的架构:Python 侧(super_dev/)承担核心治理逻辑,包括 CLI 入口、各类 Mixin 模块(cli_parser_mixin、cli_spec_mixin、cli_governance_mixin 等)、编排器(orchestrator/)、专家系统(experts/)、策略治理(policy/)等核心模块;TypeScript/Next.js 侧(frontend/ 和 super-dev-website/)提供 Web 界面和官网。
Python 后端依赖 uv 作为包管理器,通过 pyproject.toml 声明依赖,使用 mypy 做类型检查、ruff 做代码规范检查。数据库层采用 Prisma(prisma/ 目录),支持 SQLite 等多种数据库。CLI 提供了完整的命令解析、工作流编排、主机适配器(host_adapters.py)和运行验证(host_runtime_validation.py)等机制。
整个项目遵循 MIT 开源协议,代码质量较高:有完整的类型注解(mypy 通过)、规范的 lint 检查(ruff)、多语言文档(README.md 中文 + README_EN.md 英文)、详细的贡献指南(CONTRIBUTING.md)和变更日志(CHANGELOG.md)。文档质量在同类开源项目中属于顶尖水平。
没有任何工具是银弹,Super Dev 也不例外。
首先,三文档强制门对快速原型不友好。对于只想快速验证一个 idea 的极早期项目,Super Dev 的流程显得有些"重"。PRD + Architecture + UI/UX 三件套跑完,最少也要 15-30 分钟,这和很多开发者"先写代码再想清楚"的习惯相悖。当然,项目也提供了"比赛流"(/super-dev-seeai)来应对需要快速交付的场景。
其次,宿主依赖意味着它的能力上限受制于宿主的智能程度。Super Dev 本身不生成代码,它依赖于 Claude Code、Cursor 等宿主来完成任务。如果宿主 AI 模型能力不足,或者 prompt 工程做得不好,Super Dev 的流水线效果也会打折扣。
第三,目前 stars 仅 270(截至分析时),生态成熟度有待验证。作为一个 2024-2025 年出现的年轻项目,它的真实用户量、社区活跃度、长期维护能力都需要更多时间来检验。GitHub 上的很多 AI 开发工具都经历了"发布即巅峰"的命运,Super Dev 能否持续迭代还需要观察。
Super Dev 的出现,标志着 AI 编程工具正在从"个人效率工具"向"团队工程系统"演进。
2025 年之前的 AI 编程工具市场,几乎所有产品都在比拼"生成速度"和"代码质量"。但随着 Claude Code、Cursor 等工具能力的持续提升,生成代码本身已经不再是瓶颈——真正的瓶颈变成了:如何让 AI 生成的东西符合产品需求?如何保证交付质量?如何让团队协作有章可循?
Super Dev 给出的答案是:用流程约束取代人为监督,用文档驱动取代代码驱动,用专家系统取代单一模型。 这套思路的本质,是将软件开发领域的成熟工程实践(需求评审、架构设计、质量门禁、发布检查清单)系统化地引入 AI 编程时代。
从更长的时间维度看,Super Dev 可能代表了一种趋势的开始:AI 编程工具的下一战场,不是模型能力,而是工程治理能力。 当所有人都能通过 AI 快速生成代码时,谁能让代码有序交付、谁能让项目可控演进,谁就掌握了真正的竞争力。