文檔教程知識(shí)庫(kù)人工智能【免費(fèi)下載鏈接】ai-guide程序員魚(yú)皮的 AI 資源大全 Vibe Coding 零基礎(chǔ)教程分享 OpenClaw 保姆級(jí)教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 資訊、Prompt 提示詞大全、AI 知識(shí)百科Agent Skills / RAG / MCP / A2A、AI 編程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 開(kāi)發(fā)框架教程Spring AI / LangChain、AI 產(chǎn)品變現(xiàn)指南幫你快速掌握 AI 技術(shù)走在時(shí)代前沿。本項(xiàng)目為開(kāi)源文檔 aiguide已升級(jí)為魚(yú)皮 AI 導(dǎo)航網(wǎng)站項(xiàng)目地址https://gitcode.com/GitHub_Trending/aig/ai-guide點(diǎn)擊查看免費(fèi)下載讓文檔和代碼始終保持同步在 AI 編程時(shí)代如何讓 AI 遵循專(zhuān)業(yè)、可控的流程開(kāi)發(fā)項(xiàng)目而不是想到哪寫(xiě)到哪本教程以 Vibe Coding 零基礎(chǔ)教程中《OpenSpec輕量規(guī)范開(kāi)發(fā)框架》為核心結(jié)合倉(cāng)庫(kù)內(nèi) Spec-kit 教程、AI 輔助工具集 與 Vibe Coding 概念大全 中對(duì)規(guī)范驅(qū)動(dòng)開(kāi)發(fā)SDD的講解系統(tǒng)介紹 OpenSpec 的安裝初始化、目錄結(jié)構(gòu)、五步標(biāo)準(zhǔn)化開(kāi)發(fā)流程以及與 Spec-kit 的適用場(chǎng)景差異。學(xué)完后你將掌握在現(xiàn)有項(xiàng)目上借助 AI 進(jìn)行提案—審查—實(shí)現(xiàn)—?dú)w檔規(guī)范迭代的完整技能。一、什么是 OpenSpecOpenSpec 是一個(gè)輕量的規(guī)范驅(qū)動(dòng)開(kāi)發(fā)SDDSpec-Driven Development框架相比 Spec-kit 更簡(jiǎn)單易用特別適合在現(xiàn)有項(xiàng)目上迭代功能。要理解 OpenSpec 的價(jià)值先要理解規(guī)范驅(qū)動(dòng)開(kāi)發(fā)的核心理念。如 Vibe Coding 概念大全 所述傳統(tǒng)開(kāi)發(fā)流程是想到什么寫(xiě)什么邊寫(xiě)邊改最后再補(bǔ)文檔容易導(dǎo)致需求不清晰、代碼和文檔對(duì)不上而 SDD 的思路正好相反——先把需求寫(xiě)成規(guī)范文檔并把規(guī)范文檔當(dāng)作代碼的唯一真相來(lái)源AI 必須嚴(yán)格遵守這些條文來(lái)生成代碼確保產(chǎn)出完全符合預(yù)期。OpenSpec 在此基礎(chǔ)上做了輕量化設(shè)計(jì)它的核心哲學(xué)是把規(guī)范文檔作為代碼庫(kù)的一部分。每次改功能先寫(xiě)變更提案? 確認(rèn)后再實(shí)現(xiàn) ? 實(shí)現(xiàn)完再把變更歸檔到規(guī)范文檔中讓文檔和代碼始終保持同步。這套循環(huán)提案 → 實(shí)現(xiàn) → 歸檔正是 OpenSpec 區(qū)別于其他 SDD 工具的精髓不是一次性把整個(gè)項(xiàng)目規(guī)范做完而是把每一次功能變更都沉淀成可追溯的規(guī)范記錄。二、快速上手 OpenSpec下面通過(guò)給現(xiàn)有項(xiàng)目添加用戶(hù)搜索功能這個(gè)實(shí)際例子帶你完整走一遍 OpenSpec 的開(kāi)發(fā)流程。1. 安裝 OpenSpec首先確保你的電腦安裝了符合要求的 Node.js 版本示例環(huán)境要求Node.js 20.19.0然后全局安裝 OpenSpec CLInpm install -g fission-ai/openspeclatest進(jìn)入你的項(xiàng)目目錄運(yùn)行初始化命令openspec init初始化過(guò)程中會(huì)讓你選擇要集成的 AI 工具如 Claude Code、Cursor 等本文以選擇 Cursor 為例。初始化完成后OpenSpec 會(huì)自動(dòng)在你的項(xiàng)目中生成一個(gè)openspec/目錄里面包含openspec/specs/存放主規(guī)范文檔記錄項(xiàng)目的完整現(xiàn)狀openspec/changes/存放變更提案記錄每次修改的計(jì)劃??openspec/AGENTS.md讓 AI 編程助手使用 OpenSpec 進(jìn)行規(guī)范驅(qū)動(dòng)開(kāi)發(fā)的操作指南包含如何創(chuàng)建變更提案、編寫(xiě)需求規(guī)范、驗(yàn)證和歸檔變更的完整工作流程openspec/project.md當(dāng)前項(xiàng)目的上下文說(shuō)明用于記錄項(xiàng)目信息此外OpenSpec 還會(huì)根據(jù)你選擇的 AI 編程工具生成對(duì)應(yīng)的命令文件例如 Cursor 的斜杠命令配置這樣你就能在 AI 編程工具中直接以斜杠命令方式驅(qū)動(dòng)整個(gè)流程。2. 標(biāo)準(zhǔn)化開(kāi)發(fā)流程五步走初始化完成后即可開(kāi)始規(guī)范化的開(kāi)發(fā)流程主要分為 5 個(gè)步驟步驟 1Draft 起草變更提案直接在 AI 編程工具中告訴 AI讓它創(chuàng)建變更提案。例如添加用戶(hù)搜索功能創(chuàng)建一個(gè) OpenSpec 的 change添加功能根據(jù)名稱(chēng)和郵箱搜索用戶(hù)也可以用 AI 編程工具如 Claude Code、Cursor的斜杠命令/openspec:proposal 添加功能根據(jù)名稱(chēng)和郵箱搜索用戶(hù)AI 會(huì)為這個(gè)功能創(chuàng)建一個(gè)獨(dú)立目錄openspec/changes/add-user-search/并在目錄下創(chuàng)建一系列文檔proposal.md描述要改什么、為什么改tasks.md實(shí)施步驟的任務(wù)分解specs/…/spec.md需求變更的具體內(nèi)容每個(gè)變更都有獨(dú)立目錄是 OpenSpec變更即文檔設(shè)計(jì)的體現(xiàn)——一次變更的全部上下文都收斂在一個(gè)文件夾里便于審查與追溯。步驟 2Verify Review 驗(yàn)證和審查運(yùn)行以下命令檢查 AI 創(chuàng)建的變更提案是否正確openspec list # 查看所有變更 openspec validate add-user-search # 驗(yàn)證格式是否正確 openspec show add-user-search # 查看詳細(xì)內(nèi)容list用于總覽當(dāng)前所有未歸檔的變更validate會(huì)校驗(yàn)變更目錄內(nèi)的文檔結(jié)構(gòu)是否符合 OpenSpec 的規(guī)范格式是保證機(jī)器可讀的關(guān)鍵檢查show用于逐項(xiàng)查看某個(gè)變更的完整內(nèi)容方便人工審閱。步驟 3和團(tuán)隊(duì)一起審查提案如果提案需要完善可以繼續(xù)與 AI 對(duì)話例如你能幫我添加更多搜索條件和限制么AI 會(huì)據(jù)此更新規(guī)范文檔和任務(wù)列表直到團(tuán)隊(duì)對(duì)需求達(dá)成一致。這一步體現(xiàn)了 SDD 的對(duì)齊價(jià)值所有人包括 AI都基于同一份規(guī)范文檔工作從源頭減少誤解。步驟 4Implement 實(shí)現(xiàn)變更規(guī)范確認(rèn)后讓 AI 開(kāi)始實(shí)現(xiàn)規(guī)范已經(jīng)很完美了開(kāi)始生成代碼吧也可以用斜杠命令/openspec:apply add-user-searchAI 會(huì)按照tasks.md中的任務(wù)列表逐一實(shí)現(xiàn)并標(biāo)記完成狀態(tài)。由于所有改動(dòng)都建立在已確認(rèn)的規(guī)范之上AI 的輸出會(huì)非常整齊每次改動(dòng)的目標(biāo)、范圍一目了然。步驟 5Archive 歸檔變更所有任務(wù)完成后讓 AI 歸檔這次變更請(qǐng)歸檔這次變更也可以用斜杠命令/openspec:archive add-user-search或者在終端直接運(yùn)行openspec archive add-user-search --yes這個(gè)命令會(huì)完成三件事將變更文件夾移動(dòng)到openspec/changes/archive/歸檔區(qū)將需求變更自動(dòng)合并到openspec/specs/主規(guī)范中保持文檔和代碼的同步歸檔意味著本次變更正式轉(zhuǎn)正需求從提案狀態(tài)升級(jí)為主規(guī)范的一部分成為項(xiàng)目現(xiàn)狀的權(quán)威描述。這樣一來(lái)通過(guò)openspec/changes/的歷史記錄你可以隨時(shí)追溯每次變更的來(lái)龍去脈。實(shí)踐建議在整個(gè)開(kāi)發(fā)過(guò)程中建議定期運(yùn)行openspec validate驗(yàn)證命令確保規(guī)范的完整性避免提案堆積或格式漂移。三、OpenSpec 和 Spec-kit 的區(qū)別OpenSpec 常與 Spec-kit 一起被歸為規(guī)范驅(qū)動(dòng)開(kāi)發(fā)工具參見(jiàn) AI 輔助工具集但兩者定位有明顯差異維度Spec-kitOpenSpec流程完整的 7 步流程制定準(zhǔn)則 → 寫(xiě)需求 → 澄清疑問(wèn) → 定方案 → 拆任務(wù) → 檢查 → 寫(xiě)代碼更簡(jiǎn)化的 5 步起草提案 → 審查 → 實(shí)現(xiàn) → 歸檔 → 驗(yàn)證適用場(chǎng)景適合從 0 開(kāi)始做大型新項(xiàng)目適合在現(xiàn)有項(xiàng)目上迭代功能上手成本流程完整但較重上手更快輕量易用核心機(jī)制全流程規(guī)范驅(qū)動(dòng)以變更提案 歸檔保持文檔與代碼同步如 Spec-kit 教程 中所說(shuō)Spec-kit 完整流程雖能保證項(xiàng)目質(zhì)量但對(duì)小項(xiàng)目而言幾分鐘能寫(xiě)完的代碼要走半小時(shí)流程而 OpenSpec 正是針對(duì)這種痛點(diǎn)做的輕量化設(shè)計(jì)——把規(guī)范流程收斂為變更提案這一核心單元每次只規(guī)范一次改動(dòng)天然適配日常的功能迭代節(jié)奏。選型建議如果你是在現(xiàn)有項(xiàng)目上持續(xù)迭代功能OpenSpec 是更好的選擇如果你是從 0 開(kāi)始做大型新項(xiàng)目Spec-kit 的完整流程能幫你打好基礎(chǔ)。兩者并不沖突可以在同一套規(guī)范理念下按項(xiàng)目階段靈活選用。四、總結(jié)OpenSpec 的適用場(chǎng)景與價(jià)值回顧全文OpenSpec 的核心價(jià)值可以概括為三點(diǎn)輕量相比 Spec-kit 的 7 步完整流程O(píng)penSpec 用提案 → 審查 → 實(shí)現(xiàn) → 歸檔四個(gè)動(dòng)作承載規(guī)范驅(qū)動(dòng)開(kāi)發(fā)上手更快同步通過(guò)歸檔機(jī)制把每次變更自動(dòng)合并進(jìn)openspec/specs/主規(guī)范從機(jī)制上保證文檔與代碼不脫節(jié)可追溯所有變更的歷史記錄保留在openspec/changes/含歸檔區(qū)團(tuán)隊(duì)隨時(shí)可以回溯每個(gè)功能的決策過(guò)程。如果你覺(jué)得 Spec-kit 太重可以試試 OpenSpec。它的流程更簡(jiǎn)單但同樣能保證文檔和代碼的同步讓團(tuán)隊(duì)協(xié)作更順暢。建議你在自己的項(xiàng)目中實(shí)際跑一遍創(chuàng)建提案 → 驗(yàn)證 → 實(shí)現(xiàn) → 歸檔的完整流程親身體驗(yàn)規(guī)范驅(qū)動(dòng)開(kāi)發(fā)給功能迭代帶來(lái)的秩序感。延伸閱讀想進(jìn)一步了解規(guī)范驅(qū)動(dòng)開(kāi)發(fā)的整體方法論可閱讀本倉(cāng)庫(kù)的 SDD 規(guī)范驅(qū)動(dòng)開(kāi)發(fā)對(duì)比學(xué)習(xí)完整流程可閱讀 Spec-kit規(guī)范驅(qū)動(dòng)開(kāi)發(fā)框架更多輔助工具推薦見(jiàn) AI 輔助工具集 與 優(yōu)質(zhì) AI 編程擴(kuò)展推薦。贊分享文檔教程知識(shí)庫(kù)人工智能【免費(fèi)下載鏈接】ai-guide程序員魚(yú)皮的 AI 資源大全 Vibe Coding 零基礎(chǔ)教程分享 OpenClaw 保姆級(jí)教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 資訊、Prompt 提示詞大全、AI 知識(shí)百科Agent Skills / RAG / MCP / A2A、AI 編程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 開(kāi)發(fā)框架教程Spring AI / LangChain、AI 產(chǎn)品變現(xiàn)指南幫你快速掌握 AI 技術(shù)走在時(shí)代前沿。本項(xiàng)目為開(kāi)源文檔 aiguide已升級(jí)為魚(yú)皮 AI 導(dǎo)航網(wǎng)站項(xiàng)目地址https://gitcode.com/GitHub_Trending/aig/ai-guide點(diǎn)擊查看免費(fèi)下載相關(guān)推薦OpenSpec 規(guī)范驅(qū)動(dòng)開(kāi)發(fā)實(shí)戰(zhàn)在 Midway 倉(cāng)庫(kù)中編寫(xiě)、實(shí)施與歸檔變更提案的完整指南OpenSpec 規(guī)范驅(qū)動(dòng)開(kāi)發(fā)實(shí)戰(zhàn)在 Midway 倉(cāng)庫(kù)中編寫(xiě)、實(shí)施與歸檔變更提案的完整指南 MidwayNode.js 云端一體框架在其倉(cāng)庫(kù)根目錄維護(hù)了后端微服務(wù)云原生OpenSpec 輕量規(guī)范驅(qū)動(dòng)開(kāi)發(fā)框架實(shí)戰(zhàn)讓文檔與代碼始終保持同步OpenSpec 輕量規(guī)范驅(qū)動(dòng)開(kāi)發(fā)框架實(shí)戰(zhàn)讓文檔與代碼始終保持同步 面向現(xiàn)有項(xiàng)目迭代場(chǎng)景的規(guī)范驅(qū)動(dòng)開(kāi)發(fā)SDD輕量方案本文基于《Vibe Coding 零文檔教程知識(shí)庫(kù)人工智能OpenSpec 變更歸檔工作流實(shí)戰(zhàn)基于 openspec-archive-change 技能將已完成變更安全歸檔OpenSpec 變更歸檔工作流實(shí)戰(zhàn)基于 openspec archive change 技能將已完成變更安全歸檔 導(dǎo)讀 openspec archive c數(shù)據(jù)庫(kù)災(zāi)備創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考