開源專案 RED 於 V2EX 發布:以三份文件讓 AI 持續理解軟體專案的全貌
開發者於V2EX發布開源方法RED,以Research、Evolve、Document三份文件讓AI持續理解專案,本臺整理其內容輪廓、使用方式與限制。
一名署名 exoticknight 的開發者近日在技術社羣 V2EX 的「分享創造」板塊發文,公開一套名為 RED 的開源方法與配套工具。根據發文內容,RED 取自 Research、Evolve、Document 三個環節的縮寫,目的在於讓 AI 在軟體開發的完整週期中持續理解專案,把過程中形成的認識與決定累積下來,供後續工作使用。專案程式碼託管於 GitHub,並附有中文方法介紹。截至本臺查閱,該討論串累積約 516 次瀏覽,尚無回覆。
方法核心:三份文件對應三種狀態的知識
依據原發文與專案說明,RED 將專案知識分為三類,分別放置於三份文件中。Research 記錄問題、調查發現與建議,並保留判斷所需的上下文;Evolve 記錄當前獲準推進的改動、方案、進展與驗收要求,隨反饋更新;Document 則收錄已經被接受的結論,整理進專案原有的使用、開發或維護說明。
換言之,同一項資訊在 RED 的架構下有明確的生命週期:從待研究的問題,進入正在推進的方案,最終成為專案的正式約定。開發者強調,這三份文件並非靜態筆記,而是由人與 AI 共同維護的工作介面,人可以檢查和修正 AI 對專案的理解,AI 也參與維護這份理解。
發文者表示,這套方法源於團隊自 GPT-4o 發布後持續將 AI 用於軟體開發的實際經驗。其觀察是:一個專案從最初想法走到可用產品,需求往往要邊做邊聊才能講清楚,方案會隨調查和反饋調整,實現之後還要維護。既有的對話式 AI 使用方式難以把這些過程中的認識保留下來,因此整理出 RED。
示意案例:回款看板從想法到迭代
原發文以一個具體例子說明運作方式。假設使用者想為團隊做一個回款看板,最初的表述只是「想知道這個月收了多少錢,還有哪些客戶沒付」。
在 Research 階段,AI 先查看現有的訂單、付款記錄與專案說明,然後帶著發現與使用者討論:一張訂單可能分幾次付款;簽單日期和到帳日期不同;「還沒付」也可能包含尚未到期的款項。使用者補充,看板主要供負責人安排跟進,希望按實際到帳日期看本月回款。AI 將資料來源、已查明的情況、候選統計方式和待確認問題留在 Research 文件中,需求在這個過程裡逐漸具體化。
進入 Evolve 階段,使用者確定先做月度回款彙總與待跟進列表。AI 在文件中整理這輪目標、統計口徑、頁面方案和驗收要求,再推進實現。看到第一版後,使用者提出按負責人篩選的需求,AI 檢查負責人資料是否齊全,說明缺失記錄的顯示方式,與使用者確定處理辦法後,同步更新方案與實現。討論中順帶提到的自動催款功能,則以觸發條件、發送管道等待研究問題的形式留下,等待後續決定推進範圍。
在 Document 階段,使用者以包含分期付款、跨月到帳和負責人缺失的樣例核對結果,確認這一版可用後,AI 將已接受的統計口徑、篩選規則、資料介面和使用方式更新到正式說明文件,並保留「為何選擇到帳日期」「哪些邊界已處理」等維護所需的脈絡。
發文者指出,後續迭代也從這份理解出發。例如使用者要增加季度報表時,AI 會先讀取當前統計約定與既有實現,再調查季度彙總帶來的新問題;若使用者改變報表用途,例如改看簽單業績,AI 則需要重新討論日期口徑與受影響的頁面和介面。
交付形式:Skill 加 CLI,一行指令安裝
RED 以開源 Skill 搭配 CLI 的形式交付。Skill 負責指導上述流程,CLI 負責安裝與結構檢查。使用者在專案目錄執行一條 npx 指令、加上 scope 參數,即可把 Skill 安裝到指定範圍。
發文者同時說明了這套方法的效果邊界:實際效果取決於所用工具是否載入並遵循 Skill,以及專案知識有沒有被持續維護。換句話說,RED 本身並不強制執行,它提供的是結構與約定,而非封閉的自動流程。
訊源與傳播輪廓
本次資訊的主要來源為 V2EX 討論串原文,以及開發者提供的 GitHub 專案頁與個人網誌上的中文方法介紹。三方訊源在方法描述上一致,GitHub 頁面另提供安裝指令與專案結構細節。
截至本臺整理時,該討論串瀏覽量約 516 次,尚無其他使用者回覆,亦無第三方實測回報或採用案例可查。專案的授權條款細節、星標數與提交歷史,以 GitHub 頁面的即時狀態為準,本臺不以發文時點以外的數字做推斷。
在方法定位上,RED 處理的問題與近年 AI 輔助開發工具普遍面對的脈絡延續課題相鄰:對話記錄無法長期累積、跨 session 的專案理解容易遺失、需求探索與文件維護脫節。RED 選擇的路徑是把知識外顯為專案內的三份文件,讓文件本身成為人機協作的介面,這一取向與把記憶交給平臺代管的商業方案形成對照。
後續觀察項目
可持續跟進的可核實指標包括:GitHub 專案的星標與 fork 數變化、是否出現外部貢獻、是否有使用者在 V2EX 或其他平臺回報實際專案的採用經驗,以及方法本身是否隨反饋修訂。這些項目均為公開可查,本臺將視後續討論情形再作整理。
主題