AI编程规范

文章目录前言SDD是个啥先写菜谱再炒菜OpenSpecAI项目的档案局局长SuperPowersAI的军训教官双剑合璧112的暴力美学第一层用OpenSpec做项目骨架第二层用SuperPowers做行为约束第三层双向验证闭环避坑指南别把这些当银弹写在最后从氛围编程到规范编程前言各位老铁你们有没有过这种绝望的时刻你对Claude说“帮我写个用户登录模块”AI刷刷刷给你生成200行代码你热泪盈眶——终于不用加班了结果一跑密码明文存储SQL注入漏洞比筛子还多连验证码逻辑都写成了只要用户输入的不是空字符串就通过。你气得想砸键盘AI却无辜地看着你“不是你让我写的吗”这就是2025年最痛的领悟AI不是不够聪明而是太聪明了聪明到它猜不透你脑子里的潜规则。就像你相亲时对姑娘说我人还不错结果对方理解成了长得帅、有房有车、会做饭、孝敬父母、年薪百万。期望落差之大足以让项目崩盘。于是一帮被AI坑惨了的工程师们一拍大腿咱们得签合同不是和AI签而是和自己签——先把我要什么写清楚再让AI按章办事。这就是今天的主角SDDSpec-Driven Development规范驱动开发。SDD是个啥先写菜谱再炒菜用大白话说SDD就是先写说明书再让AI打螺丝。想象你要装修房子。传统开发方式是“师傅给我整得温馨点”然后瓦工刷了个死亡芭比粉的墙面你当场崩溃。SDD方式则是你先拿出厚厚的设计图纸标明墙面 Pantone 12-4302 色调、地板橡木实木、插座高度距地30cm师傅按图施工验收时对色卡——对不上就不给钱。在AI时代规范Specification就是唯一的真理来源Single Source of Truth代码只是规范的衍生品。就像菜谱是核心炒出来的菜只是菜谱的物质形态。你想吃红烧肉改菜谱就行不用亲自下厨房。SDD有三个段位你可以根据自己的控制欲选择Level 1规范优先你写规范AI参考着写代码最后你还得人工Review——像教练指导运动员。Level 2规范锚定规范长期有效每次需求变更都得更新规范文档——像建筑图纸改一版就要归档。Level 3规范即源码你只管写规范代码完全由AI生成人永不碰代码——像米其林餐厅老板只定菜单不炒菜。但光知道理论没用咱们得落地。这时候就需要两员大将出场OpenSpec和SuperPowers。OpenSpecAI项目的档案局局长OpenSpec是啥你可以把它理解为Git的远房表亲专门管规范版本。这玩意儿是Fission AI搞出来的核心理念叫Versioned proposals for evolving systems为演进中的系统提供版本化提案。听着高大上实际上就是任何需求变更必须先写提案Proposal通过评审才能动工。它的工作流像政府审批提案阶段你想加功能先写proposal.md说清楚我要加啥、为啥加、不加啥Out of Scope——防止AI过度帮助把简单需求做成操作系统。规格阶段写spec.md用GIVEN/WHEN/THEN格式描述验收标准像写测试用例一样写需求。变更追踪每个变更都有Delta标记ADDED/MODIFIED/REMOVED就像Git的diff一眼看出改了啥。最骚的是它的棕地优先Brownfield-first设计。老项目最怕什么新AI助手一上来就把祖传代码改崩了。OpenSpec要求你必须标注哪些旧逻辑被修改防止AI乱动你的屎山。安装也简单npm install -g fission-ai/openspec然后openspec init项目里就多了个openspec/目录里面分三个档案柜 specs/ ← 已完成的功能规范历史档案 changes/ ← 正在开发的变更施工图纸 archive/ ← 已归档的提案结案卷宗这套系统最适合需求不稳定、团队成员多、代码要长期维护的项目。就像给AI戴上了紧箍咒不是不让你发挥而是先立规矩再发挥。SuperPowersAI的军训教官如果说OpenSpec是制定法律的人那SuperPowers就是监督执行的军训教官——而且是那种TDD测试驱动开发铁律违者必究的狠角色。这玩意儿是Jesse Vincent键盘大厂Keyboardio的创始人开源的神器GitHub上已经爆了5.7万星。它不搞花里胡哨的就一件事用严格的流程纪律约束AI的行为。SuperPowers的核心是Skills技能包每个技能都是一份Markdown格式的军规告诉AI在这个阶段该干啥。关键技能包括技能名作用类比brainstorming苏格拉底式提问逼AI想清楚了再动手像论文导师先问死你writing-plans把任务拆成2-5分钟的小块像把大象切块一口一口吃test-driven-development强制RED-GREEN-REFACTOR循环像先画靶再射箭射不中不能换靶subagent-driven-development派子代理并行执行任务像包工头找农民工分队requesting-code-review两阶段审查规格合规代码质量像安检海关双重检查最狠的是subagent-driven-development子代理驱动开发。AI不再是一个人干所有活而是像项目经理一样派专门的Implementer子代理写代码派Reviewer子代理审查派Debugger子代理修Bug——多AI协同各司其职。而且SuperPowers是自动触发的。你不需要记命令AI在干活前会自动检查“哦我在实现阶段必须先跑TDD技能”。就像汽车不系安全带就发不出警报声AI不按流程就走不动道。这套系统最适合追求代码质量、需要严格测试、团队协作复杂的场景。一句话OpenSpec管做什么SuperPowers管怎么做。双剑合璧112的暴力美学现在问题来了OpenSpec和SuperPowers选哪个小孩子才做选择成年人全都要。真正的暴力美学是双框架组合拳。第一层用OpenSpec做项目骨架先用OpenSpec初始化项目建立规范基准。每次新需求都走openspec propose流程生成proposal.md。这一步解决需求漂移问题——很多项目做着做着就歪了就是因为前期没写清楚不做啥。第二层用SuperPowers做行为约束把SuperPowers的技能文档放在项目的.claude/或.cursor/目录里。当OpenSpec的规范定好后SuperPowers的writing-plans技能读取规范自动拆分任务。然后subagent-driven-development技能派子代理执行强制执行TDD。第三层双向验证闭环OpenSpec规格文档 → SuperPowers读取并拆分任务↓SuperPowers子代理执行强制TDD↓OpenSpec验证引擎检查实现是否满足规格↓SuperPowers审查技能提供测试通过证据↓OpenSpec归档变更更新 specs/ 目录这套组合拳打下来AI编程就从开盲盒变成了流水线作业。规范是图纸SuperPowers是监工OpenSpec是档案管理三者缺一不可。避坑指南别把这些当银弹当然这两把利器也不是万能的。根据实战经验有几个坑你得避开坑1规范写成散文别写用户体验要好这种虚的要写页面加载时间小于2秒错误提示使用红色#FF0000。AI读不懂散文诗它要的是结构化约束。坑2全量加载SuperPowers技能14个技能全装上Token烧得比火箭还快。建议只选5个核心TDD、writing-plans、systematic-debugging、verification-before-completion、requesting-code-review。坑3在小脚本上用重武器如果你只是写个一次性爬虫别搞SDD纯属大炮打蚊子。SDD适合多人协作、长期维护、对稳定性要求高的项目。坑4以为规范不用维护规范不是一次性写完的而是随系统演进的核心资产。每次改代码都要问规范更新了吗Delta标记了吗归档了吗写在最后从氛围编程到规范编程2025年AI编程已经从玩具变成了生产工具。但工具越强大越需要规矩约束。SDDOpenSpecSuperPowers这套组合拳本质上是在解决一个核心矛盾AI有能力写代码但没有纪律维护工程质量。它不会主动先写测试不会系统定位Bug根因也不会在写代码前检查spec。通过结构化规范OpenSpec 强制执行纪律SuperPowers我们终于可以把AI从瞎猜的实习生培养成靠谱的老司机。下一篇我会用实战案例演示如何用OpenSpecSuperPowers在3天内重构一个遗留系统的用户认证模块且零回归Bug。敬请期待朋友们今天的内容就到这里。如果你觉得有收获欢迎点赞、在看、转发三连——毕竟在这个AI时代掌握规范驱动开发的人才是掌握AI的人。PS目前国内还是很缺AI人才的希望更多人能真正加入到AI行业共同促进行业进步增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 http://blog.csdn.net/jiangjunshow教程通俗易懂高中生都能看懂还有各种段子风趣幽默从深度学习基础原理到各领域实战应用都有讲解我22年的AI积累全在里面了。注意教程仅限真正想入门AI的朋友否则看看零散的博文就够了。