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），仅供参考