CodeGuide

CodeGuide 是什麼？

CodeGuide 是 AI 編碼工具的規格驅動上下文生成器。它能將想法或現有 GitHub 程式碼庫轉換成結構化專案文件，例如 PRD、技術規格與線框，讓 AI 模型在實作軟體時有更明確的參考。

核心目的是透過建立專案知識庫，減少 AI 輔助開發中的「黑盒子」問題，提供更清晰的規劃與文件上下文，無論從描述開始還是擴展舊有程式碼庫。

主要功能

• 規格驅動文件生成（純英文輸入）：用純英文描述專案，即可生成文件套件，包括 PRD、技術堆疊指引與線框。
• 現有 GitHub 程式碼庫文件化：輸入現有 GitHub 專案，繪製程式碼庫地圖，讓 AI 工具更清楚了解程式碼庫內容。
• AI 文件工作流程（澄清問題 → 計畫 → 文件）：提供專案簡介並回答開放問題（例如通知行為、上手流程、功能限制），以塑造最終文件。
• Software v2 自主編碼代理：使用能分析程式碼庫、規劃文件並「自主」執行編碼任務的代理，適用於長時間工作階段。
• 多 CLI 工具 / 模型路由的統一介面：透過單一介面操作，多個 AI 模型同步工作；模型路由器會為工作流程不同部分選擇合適模型。
• Chrome 延伸套件，支援瀏覽器生成：直接在瀏覽器中生成 PRD、技術規格與文件。
• 螢幕上 UI 編輯器：螢幕上編輯，並平行協調多個代理進行 UI 修正或功能新增。
• 入門套件減少設定功夫：開源樣板適用 AI 編碼模型，包含常見基礎設施如認證、資料庫設定與 Stripe 付款設定（依樣板描述）。

如何使用 CodeGuide

1. 從想法或程式碼庫開始：用純英文描述想建置的內容，或指向現有 GitHub 專案。
2. 回應提示的專案問題：利用澄清問題指定產品行為與限制。
3. 生成文件套件：產生實作所需的輸出，如 PRD、技術規格、線框與相關規劃產出。
4. 使用 Software v2 執行：進入編碼與實作時，執行自主代理分析程式碼庫並遵循規劃文件。
5. 選用 Chrome 延伸套件：在瀏覽器工作流程中生成 PRD / 技術規格 / 文件。

使用情境

• 將 App 想法轉成實作就緒規格：開發者描述 App 概念（例如行動 App 對比網站），回答產品行為問題，即可取得 PRD、技術規格與線框。
• 為 AI 開發文件化舊有 GitHub 程式碼庫：處理難解舊程式碼時，輸入程式碼庫取得 AI 可用的地圖化上下文，用於後續編碼任務。
• 在 AI 編碼助理前規劃產品需求：使用生成規格作為結構化輸入，讓 AI 編碼工具依明確需求實作功能，而非臨時提示。
• 以代理執行自主編碼：使用 Software v2 協調程式碼庫分析、規劃與編碼執行，透過統一介面進行長時間工作階段。
• 反覆改善或擴展 UI：使用螢幕上編輯器修正 UI 問題或新增功能，同時多個代理平行作業。

常見問題

CodeGuide 能否從描述、儲存庫，或兩者生成文件？

CodeGuide 兩者皆支援：它能從純英文想法生成文件，也能透過映射儲存庫為 AI 上下文，生成現有 GitHub 程式碼庫的文件。

CodeGuide 能產生哪些類型文件？

網站描述 PRD、技術規格與線框為主要輸出，並提供與專案簡報連結的更廣泛「文件套件」。

什麼是 Software v2？

Software v2 被描述為自主編碼代理，能分析程式碼庫、規劃文件並執行程式碼，具統一介面與多模型同步。

產品如何幫助解決 AI 幻覺問題？

網站將此方法框定為建立專案知識庫與結構化規格/上下文，讓 AI 模型參考，旨在減少因缺少或不明確上下文導致的「猜測」。

是否有工具能在主應用程式外使用 CodeGuide？

有。網站提到 Chrome 延伸元件，能直接從瀏覽器生成 PRD、技術規格與文件。

替代方案

• 手動撰寫 PRD/技術規格加上 AI 編碼助理：自行（或用通用 AI 聊天）撰寫文件，再提供給編碼工具；不同之處在於依賴使用者撰寫規格，而非儲存庫映射與結構化生成流程。
• 通用 AI 編碼副駕駛：專注程式碼生成與重構的工具，可能無法提供相同端到端文件套件（PRD/技術規格/線框）或所述儲存庫映射。
• 以文件為先的程式碼庫分析工具：專注從原始碼生成文件（無規格/PRD 流程）的做法，能助理解，但可能無法產生與產品需求連結的相同規劃產出。
• 啟動模板/樣板加上獨立規劃：使用樣板可減少設定時間，但仍需另一流程生成 PRD/技術規格與線框，用於 AI 編碼工作流程。