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