Mastra Factory：從需求到 PR 的 AI 軟體開發

Mastra Factory 是供開發者與軟體團隊使用的開源 AI 開發環境。它將程式開發代理、儲存庫工作區、任務接收、規劃、實作和 Pull Request（PR）審查整合成可調整的流程。團隊可以把具體修改交給代理執行，同時保留對需求範圍、實作計畫與合併結果的判斷。

用白話說，Mastra Factory 是做什麼的？

假設你在 GitHub 提出「修正某個按鈕無法操作」的 Issue。Factory 能讓代理查看專案、調查問題、提出計畫、修改檔案並執行檢查。完成後，團隊檢視差異，決定是否把變更合併進專案。

它整理的是從需求到可審查實作的整段過程，產出可以是與原始工作關聯的 PR。官網列出的用途包括新增功能、修正錯誤、重構及撰寫測試。這適合有既有程式碼、希望把 AI 納入開發流程的團隊；仍需要設定模型、執行環境，以及能夠判斷程式碼品質的人員。

從任務看板到團隊審查

工作透過 Intake、Triage、Planning、Building、Review 和 Done 等階段推進。團隊可以依工作類型調整規則，在調查階段補充資訊，並在實作之前審查或修改計畫。

每個工作項目保留自己的對話工作階段。PR 另有獨立的審查項目與工作階段，因此「一個 PR 已合併」不一定代表最初的需求已全部完成。同一任務可能需要多個 PR，驗收時應同時核對需求條件與工作項目的狀態。

用現有 GitHub 專案完成第一次試用

按照官方入門文件，可以先使用本機伺服器搭配平台資源：

1. 在目標儲存庫之外執行 npm create factory@latest my-factory，進入新目錄並完成設定提示。
2. 在 .env 設定一次 FACTORY_CREDENTIAL_ENCRYPTION_KEY。若缺少金鑰，文件使用 openssl rand -base64 32 產生；請妥善備份，任意更換可能造成已儲存的憑證無法讀取。
3. 執行 npm run dev，開啟終端顯示的網址。在介面建立 Factory，連接 GitHub 儲存庫及模型供應商；Linear 可依需求加入。
4. 在 Settings → Work Intake 啟用 GitHub Issue 同步並選擇儲存庫。授權存取程式碼與訂閱任務來源是不同步驟。
5. 先建立範圍小、驗收條件清楚的任務，例如補充 README。首次驗證時關閉自動啟動與自動批准計畫。
6. 查看調查、回答問題並檢視計畫。實作完成後核對實際 Diff、工具輸出與 PR 檢查，再依團隊原有流程審查及合併。

不要只依代理回報「測試通過」就驗收；應確認執行了哪些檢查、修改是否超出範圍，以及原始需求是否成立。

平台託管、本機與完整自架的差別

官方提供完整平台託管、本機伺服器使用平台資源，以及完整自架三種配置。本機服務仍可能使用 Mastra 的認證、PostgreSQL 和雲端沙盒，不能僅憑本機介面就認定所有資料都留在裝置內。

完整自架可以使用 --no-platform，但需自行設定認證、持久化資料庫及執行環境。正式環境需要持續運作的 Node.js 程序，以及支援串流回應的 HTTPS 網址。詳見部署文件。

模型權限取決於供應商帳號，個人與組織憑證的適用範圍也不同。金鑰應存於憑證設定或伺服器配置，不要寫進 Issue 或儲存庫說明。連接私有程式碼前，請同時檢查隱私權政策與模型、沙盒供應商條款；現有資料不足以保證所有配置都不會將資料用於訓練。

開源授權與實際費用

截至 2026 年 9 月 10 日，官方美元標價顯示 Starter 為每月 0 美元，包含 10 萬次可觀測性事件、24 CPU 小時及 15 天資料保留；Teams 為每月 250 美元，Enterprise 另行報價。這是平台資源條件，不是無限量程式開發額度。

模型使用、超額資源與自架基礎設施都可能產生費用。請參考完整價格表，不要把月費視為總成本；這裡不將美元換算成含稅新臺幣售價。官方授權說明也區分 Apache 2.0 程式碼與 ee/ 目錄中的企業功能，後者在正式環境需要有效企業授權。

常見問題

可以接入既有專案嗎？

可以。連接 GitHub 儲存庫並設定 Issue 接收後，就能針對既有程式碼處理工作。Linear 並非必要條件。

Mastra Factory 完全免費嗎？

它有開源基礎與免費起步方案，但模型、超額資源、自架服務及企業功能可能需要付費。

本機執行就代表資料不離開電腦嗎？

不代表。伺服器、認證、資料庫、模型與沙盒是不同選項，必須整體檢查資料處理路徑。

誰決定最後合併程式碼？

團隊可以釐清需求、審查計畫並決定是否合併 PR。看板規則決定自動化程度，驗收仍應核對實際變更與檢查結果。

官方資源與開發者社群

• Factory 官方文件：導入與設定。
• Mastra GitHub 儲存庫：原始碼與問題追蹤。
• 官方 Discord 社群：開發者討論。
• Mastra 官方 X：產品公告。
• 聯絡 Mastra 團隊：展示與企業需求諮詢。