1. 项目概述:从“会写代码”到“稳定交付”的AI宿主教练系统
如果你和我一样,在过去一年里深度使用过各种AI编码助手——无论是Claude Code、Cursor还是Codex,你大概率会经历一个相似的“兴奋-困惑-疲惫”循环。一开始,你会惊叹于它们能快速生成一个功能模块,甚至一个完整的应用骨架。但当你试图用它来交付一个真正的商业项目时,问题就来了:需求理解总是有偏差,生成的代码风格飘忽不定,UI设计要么过于简陋要么过度设计,最关键的是,整个开发过程缺乏可追踪、可审计的流程。你发现自己花了大量时间在“指导”AI,而不是让它“自主工作”。最终,项目要么半途而废,要么交付质量远低于预期。
这正是我接触并深度使用Super Dev的核心原因。它不是一个简单的命令集合或脚手架,而是一个“宿主教练系统”。你可以把它理解为你团队里的产品总监、架构师、设计总监和技术教练的集合体。它的核心使命,是把宿主(你用的那个AI编码工具)里强大的模型能力,训练成一套稳定、清晰、可审计、能真正用于商业项目交付的标准化流程。
简单来说,宿主负责“写代码”这个动作,而Super Dev负责确保“写代码”这件事,是按照一个成熟软件团队的规范来进行的。它通过一套精心设计的流水线,将你的需求沉淀为PRD、架构图、UI/UX设计稿等可落地的“工件”,在每个关键节点设置质量门禁,并最终生成完整的交付证据包。我使用它完成了多个从零到一的项目,以及几个已有项目的重大迭代,最大的感受是:它让AI驱动的开发从“玩具”变成了“工具”。
1.1 核心问题:为什么AI编码工具需要“教练”?
在深入细节之前,我们先拆解一下,为什么单纯的AI宿主工具在商业交付场景下会“失灵”。
第一,缺乏产品与业务视角。当你对AI说“帮我开发一个电商网站”时,它可能会生成一个带有购物车和支付按钮的页面。但它不会主动问你:目标用户是谁?核心转化路径是什么?有哪些关键的商业规则(比如满减、优惠券)?竞品是怎么做的?Super Dev内置的PRODUCT和PM专家Agent,会在需求分析(research)阶段就介入,通过结构化的提示词,引导宿主去思考这些问题,并输出一份像样的产品需求文档(PRD)。
第二,架构设计随意,技术债务隐形。AI生成的代码往往只关注“功能实现”,而忽略了可维护性、扩展性和安全性。一个典型的例子是,它可能会把所有逻辑都塞在一个文件里,或者使用不安全的数据库查询方式。Super Dev的ARCHITECT和SECURITY专家Agent,会在架构设计阶段强制引入分层设计、接口契约、安全策略和数据模型,从源头规避技术债务。
第三,UI/UX质量不可控。这是最直观的痛点。宿主生成的界面,审美完全取决于模型当时的“心情”,且几乎不考虑一致性、响应式、无障碍访问(A11y)等专业要求。Super Dev的UI和UX专家Agent,配合其内置的119套配色方案、39个组件库和完整的Design Token体系,能将设计约束直接“冻结”成一份UI契约(ui-contract.json)。后续的前端实现、质量检查都会严格对标这份契约,确保最终产出是专业、一致且可交付的。
第四,过程不可追踪,协作成本高。当项目中断(比如你关掉了电脑),或者需要多人协作时,你很难向队友或自己清晰地说明:“我们进行到哪一步了?”“之前做了哪些决策?”“为什么这个组件要这么设计?”。Super Dev的流水线引擎和审计系统,会将每个阶段的输入、输出、决策依据都记录下来,形成.super-dev/目录下的状态文件和output/目录下的交付物。整个开发过程变得像Git提交历史一样清晰可追溯。
第五,质量保障靠人工,效率低下。最终,你还是得自己一行行去Review代码,测试功能,检查UI。Super Dev的质量门禁体系,通过25条声明式验证规则和红队审查,自动在关键节点(如代码实现后、交付前)进行扫描,不仅告诉你“哪里不行”,还会给出具体的修复建议(Quick Wins优先排序),甚至直接生成修复命令。
所以,Super Dev解决的,正是“宿主会写代码,但不一定会稳定交付”这个根本性矛盾。它通过一套标准化的“教练”流程,将AI的创造力约束在工程化和商业化的轨道上。
1.2 核心价值:给开发者带来了什么?
经过几个月的实战,我认为Super Dev的核心价值可以归结为三点:
- 交付确定性大幅提升:你再也不用担心AI“跑偏”。从需求输入到最终交付,每一步都有明确的输入、输出和质量标准。项目进度清晰可见,风险提前暴露。
- 开发效率的质变:它并没有取代宿主,而是极大地放大了宿主的价值。宿主依然负责最擅长的联网搜索、推理和编码,而Super Dev负责所有繁琐的“流程管理”和“质量把关”工作。你将从一个“微观管理者”变成一个“宏观监督者”,把精力集中在业务逻辑和核心决策上。
- 知识沉淀与团队赋能:项目过程中产生的所有文档、设计、架构决策,都被结构化的保存下来。这对于团队知识传承、新人 onboarding 以及项目复盘,是无价之宝。Super Dev内置的270+个知识文件(覆盖23个技术领域)也会在相应阶段自动推送给宿主,相当于一个随时在线的资深技术顾问团。
接下来,我将以一个真实的“个人博客系统”项目为例,带你完整走一遍Super Dev的标准化流水线,拆解每一个环节的实操细节、避坑经验和独家技巧。
2. 核心工作流拆解:一条标准化的AI开发流水线
Super Dev的核心,是其精心设计的9阶段核心工作流。这套流程不是拍脑袋想出来的,而是融合了敏捷开发、DevOps和现代软件工程的最佳实践。理解这个流程,是高效使用Super Dev的关键。
整个流程可以概括为两条主链,分别对应“从零开始”和“已有项目”两种场景:
- 新项目主链:
research(需求研究) -> docs(三文档生成) -> docs_confirm(文档确认) -> spec(任务规格) -> frontend(前端实现) -> preview_confirm(预览确认) -> backend(后端实现) -> quality(质量门禁) -> delivery(交付) - 已有项目主链:
baseline(基线分析) -> baseline_confirm(基线确认) -> delta research(增量需求研究) -> docs(三文档生成) -> ...(后续阶段与新项目相同)
这条流水线被设计成可中断、可恢复的。这意味着你可以随时关掉窗口,第二天打开宿主,说一句“继续当前流程”,它就能从上次中断的地方接着干。这背后依赖于.super-dev/workflow-state.json和SESSION_BRIEF.md等状态文件对流程上下文的精准记录。
2.1 阶段一:需求研究与分析(Research)
这是所有事情的起点。很多人(包括之前的我)会直接跳过这一步,让AI立刻开始编码。这是大忌。模糊的需求输入,必然导致模糊甚至错误的输出。
Super Dev如何做?当你输入/super-dev 开发一个支持Markdown、标签分类、暗色模式的个人博客系统后,流程并不会直接进入编码。Super Dev会先激活PRODUCT和PM专家Agent,引导宿主进行深度研究。
宿主会做什么?
- 联网搜索:自动搜索“现代个人博客最佳实践”、“流行的博客技术栈(如Next.js, Hugo, Ghost)”、“Markdown编辑器选型”、“标签系统设计”等。
- 竞品分析:可能会快速浏览几个知名的开源博客(如Hexo, Jekyll)或在线服务,分析其功能矩阵和优缺点。
- 需求结构化:结合搜索和你的初始描述,输出一份结构化的需求摘要。这份摘要是后续所有文档的基础。
我的实操心得:
- 需求描述要具体:不要只说“一个博客系统”。尽量描述清楚核心用户(你自己?技术读者?)、核心功能(写作、发布、分类、搜索、评论?)、非功能需求(加载速度、SEO友好、移动端适配)。
- 善用“比赛模式”快速验证:如果你只是做一个概念验证或Demo,可以在需求后加上“用比赛模式”。命令会变成
/super-dev-seeai 开发一个...。这个模式会压缩文档确认和预览确认的环节,更快地进入一体化开发,适合30分钟左右的快速原型搭建。 - 关注
output/research/目录:宿主的研究摘要、参考链接、初步的功能列表都会生成在这里。这是理解AI“思考过程”的第一个窗口,如果有明显偏差,可以在这里及时纠正。
2.2 阶段二:三文档生成与确认(Docs & Docs Confirm)
研究完成后,Super Dev会指挥宿主,在三位专家(PRODUCT/PM,ARCHITECT,UI/UX)的指导下,并行生成三份核心文档。这是将模糊需求转化为可执行方案的关键一步。
1. 产品需求文档(PRD)由PRODUCT和PM专家主导生成output/*-prd.md。这份文档会详细定义:
- 用户画像:博客的读者是谁?作者是谁?
- 功能矩阵:核心功能(文章CRUD、标签管理)和扩展功能(搜索、评论、数据统计)的详细描述。
- 验收标准:每个功能“完成”的具体定义是什么?(例如:“发布文章功能,要求支持富文本和Markdown双模式编辑,编辑后实时预览,保存后立即在首页可见”)
- 商业规则:如果有,比如“文章发布后自动推送到社交媒体”。
2. 系统架构文档(Architecture)由ARCHITECT和SECURITY专家主导生成output/*-architecture.md。这份文档会确定:
- 技术栈选型:前端用Next.js还是Vite + React?后端用Node.js + Express还是Python + FastAPI?数据库用SQLite还是PostgreSQL?
- 系统架构图:前后端如何通信?是否有缓存层?静态资源如何托管?
- 数据模型:
Article,Tag,User等核心实体的字段和关系。 - 接口契约:关键API的路径、方法、请求/响应格式。
- 部署方案:本地开发环境、测试环境、生产环境如何搭建。
3. UI/UX设计文档(UIUX)由UI和UX专家主导生成output/*-uiux.md和最重要的output/*-ui-contract.json。这份“UI契约”是后续所有前端工作的法律文件,包含:
- 设计Token:在
output/frontend/design-tokens.css中生成完整的CSS变量,定义颜色、字体、间距、阴影、圆角等。 - 配色方案:从119套方案中,根据“博客”、“技术”、“阅读”等关键词,自动选择一套主色、辅助色、语义色(成功、警告、错误),并生成对应的暗色模式。
- 组件库映射:指定使用哪个UI框架(如Tailwind CSS, MUI, Ant Design)以及具体的组件使用规范。
- 页面骨架与交互状态:定义首页、文章列表页、文章详情页、后台管理页的布局框架,以及加载、空、错误等状态的设计。
文档确认门(Docs Confirm)三份文档生成后,流水线会自动暂停,等待你的确认。这是整个流程中第一个,也是最重要的“刹车点”。Super Dev会在宿主中提示你:“三份初始文档已生成,请审阅output/目录下的*-prd.md,*-architecture.md,*-uiux.md文件。确认无误后,请回复‘确认继续’或提出修改意见。”
你必须做的事情:
- 仔细阅读这三份文档。这是你纠正方向成本最低的时候。
- 重点检查架构文档的技术选型是否符合你的技术栈偏好和项目复杂度。比如,一个简单的博客可能不需要微服务。
- 重点检查UI契约。配色喜欢吗?组件风格是Material Design还是你更倾向的Neumorphism?如果不满意,千万不要点“确认继续”!你应该直接提出修改意见,例如:“主色调太暗,希望更明亮一些,类似GitHub的风格”或者“希望采用更圆润的卡片设计”。
- 提出意见后,宿主会基于你的反馈更新文档,并再次等待确认。这个循环可以持续多次,直到你满意为止。
踩坑实录:我曾在一个电商后台项目中,因为赶时间快速确认了UI契约,结果后面生成的前端页面风格与我期望的“专业、简洁”相去甚远,导致在预览确认门不得不发起“UI改版回路”,重新走了一遍UIUX文档和前端实现,反而浪费了更多时间。教训是:在文档确认门多花10分钟,能在后面节省1小时。
2.3 阶段三:任务规格与实现(Spec & Implementation)
确认文档后,流程进入“怎么做”的阶段。
任务规格(Spec)Super Dev会基于确认后的PRD和架构文档,拆解出具体的开发任务,生成output/*-spec.md。这份文档会非常具体,例如:
- 任务1:初始化Next.js项目并配置Tailwind CSS和设计Token。
- 任务2:实现文章数据模型(
lib/models/article.ts)和数据库连接。 - 任务3:创建博客首页组件(
components/HomePage.tsx),包含文章列表和标签云。 - 任务4:实现Markdown文章渲染组件(
components/MarkdownRenderer.tsx)。 - ...
每个任务都包含输入、处理逻辑、输出和验收标准。同时,质量门禁体系会开始对这份Spec进行评分,检查其完整性、可测试性和与架构文档的一致性。
前端优先实现(Frontend)这是宿主开始大量写代码的阶段。但和以往不同,宿主现在是在UI契约和设计Token的严格约束下工作。
- 宿主会先搭建项目骨架,安装依赖。
- 然后,按照Spec的任务顺序,开始实现各个前端组件。
- 关键点:宿主生成的每一行CSS样式,都应该引用
design-tokens.css中的变量(如var(--color-primary)),而不是硬编码的颜色值。每一个按钮、卡片,都应该遵循UI契约中定义的组件规范。
预览确认门(Preview Confirm)前端界面实现到一个可运行的程度(通常是一个完整的页面或一组核心组件)后,流水线会再次暂停。Super Dev会引导宿主启动本地开发服务器(如npm run dev),并提示你:“前端预览已就绪,请访问http://localhost:3000查看效果。确认UI实现符合预期后,请回复‘确认继续’。”
你必须做的事情:
- 在浏览器中打开本地预览。这是你第一次看到“实物”。
- 对照UI契约和设计稿,检查视觉还原度。颜色、字体、间距、组件样式是否正确?
- 进行简单的交互测试。点击按钮、切换暗色模式、调整浏览器窗口大小看响应式布局。
- 如果发现严重不符,同样可以提出修改意见,宿主会进行修复。如果只是细微调整,也可以确认继续,因为后续的UI Review和质量门禁环节还会再次检查。
后端实现与联调(Backend)前端确认后,宿主开始根据架构文档和Spec实现后端API、数据库操作等。前后端会在本地进行联调。Super Dev会确保后端代码遵循架构中定义的安全策略(如输入验证、SQL防注入)和接口契约。
2.4 阶段四:质量门禁与交付审计(Quality & Delivery)
这是确保项目“不仅做完,而且做好”的环节。
质量门禁(Quality Gate)当宿主完成所有编码任务后,Super Dev会启动质量顾问对代码库进行全量扫描。这个过程是自动的,会执行25条内置的验证规则,包括:
- Spec-Code一致性检测:检查实际实现的代码是否完全覆盖了Spec中定义的任务。
- A11y无障碍检查:自动检测页面是否满足WCAG标准,如图片是否有alt文本,颜色对比度是否达标。
- 性能预算校验:检查关键页面的资源大小、加载时间是否在合理范围内。
- 安全扫描:检查是否存在常见的安全漏洞模式。
- 代码风格检查:是否符合项目预设的规范(如ESLint, Prettier)。
- UI契约对齐检查:这是Super Dev的特色。它会比对
ui-contract.json、生成的design-tokens.css、以及实际运行的前端页面,确保三者完全一致。
扫描结束后,会生成一份详细的质量报告(output/*-quality-report.md)。报告不仅会列出所有问题,还会将问题分类(错误、警告、建议),并给出具体的修复命令。例如:“检测到首页按钮颜色未使用设计Token,建议运行npm run fix:colors” 或 “Article模型缺少publishedAt字段,与Spec不符”。
红队审查(Red Team Review)对于更严苛的项目,可以启用红队审查。这会模拟攻击者视角,从安全、性能、架构韧性三个维度进行“攻击”,试图找出系统的薄弱点,并生成攻防报告。
交付(Delivery)通过所有质量门禁后,项目进入交付阶段。Super Dev会打包所有交付物,生成交付证据包(Proof Pack),包括:
proof-pack/:包含可执行的应用构建产物、部署脚本、配置说明。release-readiness-report.md:发布就绪度报告,汇总所有门禁结果和审计证据。delivery-manifest.json:交付清单,记录所有代码文件、文档、配置的版本和哈希。
至此,一个完整的、经过标准化流程和质量审计的项目就交付了。你可以清晰地告诉任何人:这个项目做了什么,为什么这么做,以及它是如何保证质量的。
3. 宿主接入与日常使用实操指南
理解了核心流程,我们来看看如何把它用起来。Super Dev支持26个主流宿主(12个CLI,9个IDE,5个桌面助手),覆盖了绝大多数AI编码工具。其接入治理系统非常智能,目标是让你“5分钟上手”。
3.1 安装与一键接入
安装(唯一需要记住的终端命令)
uv tool install super-dev推荐使用uv(一个更快的Python包管理器),它会自动处理所有Python依赖。安装后,在任何项目的根目录下,执行:
super-dev这会启动一个交互式的宿主安装引导界面。你会看到一个列表,展示了Super Dev自动检测到的、你本地已安装的宿主工具(如Claude Code, Cursor, Codex等)。
接入流程
- 在引导界面,用
↑/↓键选择你想要接入的宿主(比如你常用的 Cursor)。 - 按
空格键勾选,可以多选。 - 按
回车键开始安装。 - Super Dev会自动向该宿主的项目级配置目录写入必要的规则文件、Skill定义和Slash命令映射。
- 安装完成后,终端会直接显示在这个宿主中触发Super Dev的命令。例如,对于Claude Code,它会显示:
接入完成!请在 Claude Code 会话中使用: /super-dev 你的需求 - 根据提示,打开你的宿主(如Cursor),在它的AI聊天框里,输入
/super-dev 开发一个...。
关键心智转变
安装完成后,终端就该退场了。这是最重要的一点。
super-dev这个CLI工具,99%的时间只用于三个命令:super-dev(安装/接入)、super-dev update(升级)、super-dev uninstall(卸载)。真正的日常开发,全部在你的宿主(如Cursor的聊天窗口)里完成。你只需要记住在宿主里输入/super-dev 需求或super-dev: 需求即可。
3.2 不同宿主的使用差异与技巧
虽然Super Dev统一了流程,但不同宿主在细节上仍有差异。了解这些能避免很多坑。
对于 Claude Code / Cursor / Windsurf 等(支持/命令的宿主):
- 触发:直接在聊天框输入
/super-dev 需求。这是最自然的方式。 - 技巧:尽量在同一个会话(Session)中完成整个流水线。因为这些宿主有很强的上下文记忆能力,跨会话可能会导致状态丢失,需要手动恢复。
对于 Codex App/Desktop:
- 触发:在Codex的“/”命令列表里,你会看到一个新增的
super-dev选项,点击它,然后输入需求。 - 注意:接入后需要重启一次Codex,新的Skill和命令才会生效。
对于 Copilot in VS Code / Trae IDE 等(仅支持自然语言触发的宿主):
- 触发:输入
super-dev: 需求(注意是冒号)。 - 技巧:确保你的VS Code工作区打开的是目标项目根目录,这样Copilot才能读取到项目级的规则文件。
通用恢复技巧:无论使用哪个宿主,当流程中断(关窗口、第二天继续)后,不要回到终端去找run或jump命令。正确做法是:重新打开宿主,在聊天框里直接说“继续当前流程”或“现在下一步是什么”。Super Dev的状态管理引擎会根据.super-dev/下的状态文件,自动恢复到中断点。
3.3 5分钟上手验证路径
为了确保接入成功,Super Dev在安装后会生成一份烟测指南(output/maintenance/host-onboard-smoke-*.md)。我强烈建议你按照这个指南做一次快速验证:
- 打开烟测指南文件。
- 找到并复制“标准流第一句”。通常类似
/super-dev 创建一个简单的待办事项应用,要求有添加、删除、完成状态切换功能,并具备暗色模式。 - 回到宿主,粘贴并发送这条命令。
- 观察宿主行为:它应该依次进入
research -> 生成三文档 -> 等待你的确认这个流程。 - 如果成功走到“等待确认”这一步,恭喜你,你的宿主已经被成功“训练”成了这个项目的交付教练。
如果宿主没有按预期响应,可以回到终端运行super-dev doctor进行诊断,它会给出具体的修复建议。
4. 高级特性与深度使用心得
当你熟悉了基本流程后,Super Dev的一些高级特性能让你如虎添翼。
4.1 知识驱动治理:你的私人专家团
这是Super Dev区别于普通脚本工具的“灵魂”。它的knowledge/目录下,有270多个文件,超过15万行的结构化知识,覆盖架构、安全、运维、云原生、数据工程、设计等23个领域。
它是如何工作的?当宿主进入research或docs阶段时,Super Dev的知识推送引擎会自动运行:
- L1索引匹配:快速扫描知识库目录,找到与“博客”、“前端”、“数据库”等关键词相关的领域。
- L2内容推送:将相关领域知识文件(如“现代Web应用安全最佳实践.md”、“RESTful API设计规范.md”)的内容,作为硬约束注入到给宿主的提示词中。
- L3深度引用:在生成具体内容(如架构图中的认证模块)时,精准引用知识库中对应的段落。
带来的好处:
- 你不需要是安全专家,宿主在设计架构时会自动考虑OWASP Top 10。
- 你不需要是DBA,宿主在设计数据模型时会遵循规范化原则。
- 你不需要是UX设计师,宿主会应用专业的色彩理论和交互设计模式。
我的使用技巧:
- 定制你的知识库:你可以往
knowledge/目录里添加自己团队或公司的开发规范、设计系统文档、API标准等。Super Dev会在后续的项目中自动引用它们,实现团队知识的标准化传承。 - 关注知识命中报告:在
output/knowledge-cache/下,可以看到本次项目命中了哪些知识条目,这有助于你理解AI决策的依据。
4.2 质量门禁体系:从“检查”到“修复”
质量门禁不是简单的“报错”。它的质量顾问(Quality Advisor)模式非常智能。
实战案例:在一次项目中,质量门禁扫描后报告:“检测到User模型的密码字段以明文存储,违反安全规则SEC-001。” 它没有止步于此,而是继续给出:
- 修复建议(Quick Win):“建议使用
bcrypt库进行哈希加盐存储。预估修复时间:15分钟。” - 具体修复命令:“运行
npm install bcrypt并参考knowledge/security/password-hashing.md中的示例代码进行修改。” - 关联知识推送:自动将安全知识库中关于密码存储的章节推送给宿主,供其参考。
这种“发现问题 -> 给出建议 -> 甚至提供命令”的闭环,将质量保障从“负担”变成了“助力”。
4.3 处理已有项目与增量开发(Evolve / Patch)
Super Dev对已有项目的支持非常优雅。你不需要从头开始。
操作步骤:
- 在已有项目根目录,运行
super-dev完成接入。 - 在宿主中输入
/super-dev 我们需要为博客增加一个文章评论功能。 - Super Dev不会直接开始编码。它会先启动基线分析(Baseline):
- 扫描现有代码库,理解当前的项目结构、技术栈、数据模型。
- 生成一份
baseline报告,描述当前系统状态。
- 你需要确认基线(Baseline Confirm),确保Super Dev对现状的理解是正确的。
- 确认后,它才会进入增量需求研究(Delta Research),分析“增加评论功能”需要对现有系统做哪些改动,然后继续走标准的三文档、Spec、实现流程。
这种方式保证了增量开发与原有系统的一致性,避免了“推倒重来”或“引入架构冲突”。
4.4 UI改版回路与设计约束
如果你在preview_confirm阶段对UI不满意,除了提意见让宿主修改,还可以发起正式的UI改版回路。 在宿主中说:“我对当前UI不满意,需要正式改版。” Super Dev会:
- 将流程回退到
uiux阶段。 - 让你重新审视和修改
ui-contract.json和uiux.md。 - 基于新的契约,重新执行
frontend实现。 - 再次进入
preview_confirm。
这个回路机制,将UI设计从一次性的“开盲盒”,变成了一个可迭代、受控的过程。
5. 常见问题排查与避坑指南
即使工具再智能,在实际使用中还是会遇到各种问题。以下是我踩过坑后总结的排查清单。
5.1 宿主接入失败或命令不生效
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
执行super-dev后,列表中看不到我的宿主。 | 1. 宿主未安装或不在系统PATH中。 2. Super Dev的宿主检测逻辑未覆盖该工具。 | 1. 确认宿主已正确安装并可命令行启动(如cursor --version)。2. 尝试使用 super-dev --host <宿主名>强制指定接入。 |
在宿主中输入/super-dev无反应或报“未知命令”。 | 1. 宿主需要重启以加载新配置。 2. 项目级规则文件未正确生成。 3. 宿主不支持项目级Slash命令。 | 1.首先,完全关闭并重新打开宿主应用。这是解决90%此类问题的方法。 2. 检查项目根目录是否存在宿主对应的配置文件(如Cursor的 .cursor/rules/,Claude Code的CLAUDE.md)。3. 对于只支持自然语言的宿主(如Copilot),改用 super-dev: 需求触发。 |
| 流程卡在某个阶段不动了。 | 1. 宿主联网失败或API调用超时。 2. 宿主上下文长度不足,丢失了流程状态。 | 1. 检查网络,或在宿主中手动触发“继续”。 2. 对于长流程项目,尽量在同一个会话中完成,避免中途进行大量无关对话。如果状态丢失,使用“继续当前流程”指令。 |
5.2 流程与内容相关问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 生成的UI非常简陋或不符合预期。 | 1. 在docs_confirm阶段没有仔细审查UI契约。2. 需求描述过于模糊,宿主缺乏设计灵感。 | 1.务必在文档确认门仔细看ui-contract.json,提出具体修改意见(“主色用#2563eb,字体用Inter”)。2. 在需求中增加设计关键词,如“采用玻璃拟态风格”、“参考Vercel官网的简洁设计”。 3. 发起UI改版回路。 |
| 代码质量不高,有低级错误。 | 质量门禁的规则级别设置过低,或未启用红队审查。 | 1. 在项目初始化或quality阶段前,通过super-dev config调整质量策略为balanced或enterprise。2. 启用红队审查,进行深度安全与性能扫描。 |
| 宿主生成的代码技术栈不是我想要的。 | 在docs_confirm阶段没有修改架构文档。 | 架构确认是选型的唯一机会。在审阅*-architecture.md时,明确指定技术栈,如“后端使用Python FastAPI而非Node.js”。一旦确认,后续实现将严格遵循。 |
| 项目很大,一次生成不完。 | 宿主单次对话有token长度限制。 | 1.利用好“继续当前流程”。让宿主分批次生成代码,每次聚焦一个模块。 2. 在Spec阶段,任务拆解得越细越好,方便分步执行和验证。 |
5.3 性能与优化建议
- 对于小型项目或原型:大胆使用
/super-dev-seeai比赛模式。它会跳过一些确认环节,极大加快从想法到可运行原型的速度。 - 管理知识库:如果
knowledge/目录内容过多,可能会轻微影响初期research的速度。你可以将暂时用不到的领域知识移出该目录,或使用.gitignore忽略,按需引入。 - 善用缓存:
output/knowledge-cache/和.super-dev/下的状态文件不要轻易删除。它们是实现“断点续传”和知识复用的关键。 - 定期升级:使用
super-dev update保持工具最新,以获取最新的专家Playbook、验证规则和宿主兼容性改进。
6. 总结:从工具到伙伴
使用Super Dev近半年,我最大的感触是,它让我与AI宿主的关系发生了根本性的改变。我不再是一个不断给出模糊指令、然后失望地纠正结果的“驯兽师”。Super Dev在我和宿主之间,搭建起了一座坚固的、标准化的“协作桥梁”。
我变成了一个产品负责人和架构评审者,在关键节点(文档确认、预览确认)做出决策。宿主则变成了一个高度专业化、纪律严明的执行团队,在明确的蓝图(PRD、架构、UI契约)和质量标准下高效工作。
它并没有让开发变得“全自动”,而是让开发变得“高度可控”。这种可控性,正是将AI编码应用于严肃商业项目所必需的前提。如果你也受困于AI生成代码的随机性和不可靠性,渴望一种更工程化、更可预测的协作方式,那么Super Dev绝对值得你投入一个下午的时间去深入尝试。它的学习曲线并非陡峭,而一旦掌握,回报将是数十倍的效率提升和交付质量的飞跃。
最后记住那句核心口诀:终端只做三件事——接入、升级、卸载。真正的开发,回到宿主里,说“/super-dev 开始吧”。