尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
OpenSpec完整指南:如何给AI编码助手写好“规则书“
OpenSpec完整指南如何给AI编码助手写好规则书【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpecAI编码助手直接写代码出来的东西时好时坏、风格漂移。规范驱动开发SDD就是先写规则书再让AI照规则写代码解决的就是这个问题。OpenSpec是面向AI编码助手的规范驱动开发工具它替你管理规则书从提变更到验证通过。 AI编码助手为什么需要一本规则书你遇到过这种情况吗同一个功能让AI写三遍三遍风格都不一样还经常违背之前约定好的行为AI编码助手直接动手写代码问题会越积越多——它写的对但不是你项目想要的对。漂移的根源是缺少一本写在纸面上的规则书。脑子里的需求留不下痕迹AI只能凭感觉发挥。规范驱动开发给出的答案是先把系统应该怎么表现写成人人包括AI都能读懂的规范再让AI动手。那么如何用OpenSpec管理AI代码答案就在下一张图。️ 一张图看懂OpenSpecOpenSpec把活分成三层各干各的规范存储装下所有已确认的行为规范也就是规则书的定稿变更管理改规则的提案和增量修改都发生在这里不动主规范验证执行每个变更落地前先过一道检查保证不破坏既有规则仪表盘让你一眼看清项目状态。打开它会看到10个规范、64个需求、3个进行中的变更、4个已完成的变更任务完成率73%——做到哪一步、缺什么一张图讲完。 核心四件套提案→规范→设计→任务OpenSpec里的每个变更都是一串四个工件按顺序生成后者依赖前者提案proposal.md说清为什么改是整条链的起点规范specs/*.md基于提案写系统应该有什么行为设计design.md在规范之上敲定怎么做的细节任务tasks.md把设计拆成可执行的任务清单以 openspec/changes/ 目录为例每个变更都是一个独立文件夹。比如add-change-stacking-awareness/里面有proposal.md、tasks.md还有一个specs/子目录里面按 change-creation、change-stacking-workflow、cli-change 等能力再拆。独立文件夹意味着多个变更可以并行推进做完后归档合回主规范。 快速上手3步跑起来第1步初始化在项目里运行openspec init自动生成 openspec/ 目录和模板文件第2步写规范照着提示从四件套写起先提案再规范、设计、任务第3步验证运行openspec validate 变更名缺什么、哪里不合规一条条报给你不需要额外配置就能跑起来规则想改后面随时能改。⚙️ 自定义规则一份配置看懂自定义规则只需要看两个文件。第一个是 openspec/config.yaml管全局行为验证严格度、遥测开关、命令的默认参数都在这——global: validation: strict: false # 开发初期放宽验证 telemetry: enabled: true commands: validate: outputFormat: detailed开发期放宽验证、上线前收紧都不用改代码。第二个是 schemas/spec-driven/schema.yaml它定义四件套怎么生成每个工件声明自己产出什么文件、依赖哪些前置工件——description: Default workflow - proposal → specs → design → tasks artifacts: - id: proposal generates: proposal.md - id: specs generates: specs/**/*.md requires: [proposal]改模板、改依赖就能长出属于自己的规范流程。⚡ 跨平台与性能两个细节跨平台OpenSpec在macOS、Linux、Windows上行为一致。代码里一律用Node.js的path.join()和path.resolve()拼路径从不硬编码斜杠同一套规范文件在任何系统打开都正常。性能验证只查你改的部分不重查全库。系统还维护一份规范索引查规范、查依赖的速度不随规范数量变慢。 团队怎么用采用节奏建议一步一迈阶段做法试点挑一个非关键模块先写出规范基线扩展把经验复制到更多模块形成团队约定标准化制定组织级规范标准设质量门禁优化根据使用反馈持续调整流程日常盯住四个指标规范覆盖率关键功能是否都有对应规范变更周转时间从提案到归档花多久验证通过率变更一次通过的比例任务完成率规范变更是否真的落地了❓ 常见问题问已有项目需要重写文档吗不需要。openspec/ 目录和代码放在同一个仓库里按模块逐个补写规范即可存量代码不用动。问AI没照规范写怎么办先跑openspec validate检查规范本身再把验证通过的规范交给AI对照执行。规范就是契约AI的产出必须以它为准。问Windows上能正常用吗能。macOS、Linux、Windows三端命令和目录结构完全一致路径分隔符这类跨平台问题已由工具内部处理。总结先写规则书再让AI动手变更隔离管理验证后落地两份配置定制所有行为【免费下载链接】OpenSpecSpec-driven development (SDD) for AI coding assistants.项目地址: https://gitcode.com/GitHub_Trending/op/OpenSpec创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

腾讯后台开发面试核心考点:C++、TCP/IP与系统设计全面复盘

腾讯后台开发面试核心考点:C++、TCP/IP与系统设计全面复盘

准备腾讯2015春招后台开发岗的时候,我找了不少资料,最后发现一套练习卷特别说明问题。那会儿腾讯后台的主流语言还是C,面试官考的东西非常实在:指针、内存、进程线程、TCP/IP、手写算法,几乎全是后台日常要碰的内容。十…

📅 2026/9/12 3:12:41
斗鱼前端面试全攻略:WebRTC、React性能与弹幕系统设计

斗鱼前端面试全攻略:WebRTC、React性能与弹幕系统设计

1. 面试前的准备:想清楚斗鱼到底要什么样的人1.1 斗鱼业务特点与考点预测先说一下我拿到斗鱼面试机会的背景。当时我在 offerMe 上整理面经时,发现斗鱼的技术岗面试和纯互联网电商、教育类公司有明显差异——它是一家直播平台,核心链路是“开…

📅 2026/10/9 3:19:04
阿里Android面试全流程复盘:从技术基础到架构思维

阿里Android面试全流程复盘:从技术基础到架构思维

阿里巴巴的Android岗面经,网上其实不少,但大多数是"面了哪些题"的流水账。今天这篇我想换个写法,不只列出问题,更想把每一轮背后的考察意图、我当时是怎么思考的、以及事后复盘觉得哪里该答得更好,都掰开揉碎…

📅 2026/10/5 19:08:06
MORE NEWS

更多资讯

📰

启动报Port 8088 was already in use?先查是谁占的

启动报Port 8088 was already in use?先查是谁占的 项目启动报 Port 8088 was already in use,意思很直白:这个端口已经有人占了。 先说原理:端口是"门牌号",一间房只住一个进程 端口就是一台机器上的门牌号…

📰

担心文档上云?本地运行的办公AI才敢放心用

单位上周开了个会,主题是"AI 提效",散会时领导补了一句:涉及客户资料的文档,不许往云端传。这话一出,会议室里本来跃跃欲试的同事全蔫了——大家平时用的那些在线 AI,文档一上传就不知道存哪儿去…

📰

先能用,再好用:从烂尾复盘到两周上线,全栈项目的‘原型—快速迭代‘方法论

先能用,再好用:从烂尾复盘到两周上线,全栈项目的“原型—快速迭代”方法论 全栈学习路径的文章已经很多了:怎么选技术栈、怎么搭环境、怎么记文档,几乎每个方向都有人写。但一个更扎心的问题很少有人正面讨论——为什…

📰

深度思考模式把 ARC-AGI-2 从 17.6% 拉到 45.1%:对照 Gemini 3 Pro 的三份能力评测,看‘会思考‘改写了哪些边界

深度思考模式把 ARC-AGI-2 从 17.6% 拉到 45.1%:对照 Gemini 3 Pro 的三份能力评测,看“会思考”改写了哪些边界 一、先说结论:变强的不是“知识”,而是“解法” 每次新模型发布,评测榜单都会涨几个点,大…

📰

1.c++入门篇

1.c中的关键字asmdoifreturntrycontinueautodoubleinlineshorttypedefforbooldynamic_castintsignedtypeidpublicbreakelselongsizeoftypenamethrowcaseenummutablestaticunionwchar_tcatchexplicitnamespacestatic_castunsigneddefaultcharexportnewstructusingfriendclassext…

📰

《江灯合声》:有可行的分框版,也仍可以选择连续鸣谢

武汉江岸区栎坡合唱团在免费节目册《江灯合声》中,以表格集中鸣谢资助者。各家共同要求改为独立小框,团里仍想保留表格。现有全名与支持事项清楚可见,双方此前未承诺具体排版。我支持保留表格。补充的试排材料让选择更具体:分框能…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬