該 AI Software Factory 儲存庫說明從產品使命和任務，到 Archon 建立提取請求的流程。安裝與工作流程檢查只是起點。維護者的首小時指南指出，真實的端對端驗證仍待完成。本指南依據工廠提交 9e2d85298b45497031009597a6ae0811b66fe6d6 及其固定的 Archon 版本 fad09169ea1b43512bc7ee88470d47f960a3e0f8。內容來自文件與程式碼閱讀，不是 BIG CHANGE 安裝或執行後的報告。

此流程適用於能管理應用程式儲存庫或 PRD、GitHub 權限及模型供應商帳戶的團隊。維護者明確說明如何複製工廠並安裝到自己的儲存庫。固定版本的工廠檔案樹沒有授權或聲明檔；本指南不確立更廣泛的重用或再散布權利。Archon 的 MIT 授權適用於獨立的 Archon 原始碼。不要把供應商機密放進任務、提示、日誌或審查紀錄。

重大改變

  • 改變是什麼： 此實作用固定的 Archon 工作流程套件串連產品範圍、任務規劃、程式開發、獨立審查與執行檢查。工廠提供專案輸入與啟動器；共享套件負責 AI 步驟。
  • 為何重要： 團隊可以從任務追溯至具體差異、CI 結果和執行中的候選版本，再決定是否合併。只有安裝檢查，證據鏈仍不完整；維護者也指出真實整合仍待驗證。
  • 接下來關注： 第一個有用證明，是實際任務的交付版本通過有意義的使用者流程及獨立保留測試，同時團隊能查看成本與審查紀錄。排程及部署仍是審查後的獨立決定。

1. 核對儲存庫、權限與固定版本

維護者的安裝說明要求 Git、Python 3.10 或更新版本、已通過驗證的 gh（具 workflow 權限範圍）、GitHub 遠端儲存庫、程式開發代理、Bun 與 uv。Git 也必須能推送工作流程檔案（gh auth setup-git）。啟動代理前，核對現有測試、啟動與 CI 指令、分支保護、GitHub 存取、供應商驗證與模型計費。只授予執行所需的儲存庫和工作流程權限。

將工廠複製到應用程式儲存庫之外，並切換至指定提交。文件中的安裝指令應從應用程式根目錄執行：

Terminal
git clone https://github.com/coleam00/ai-software-factory ~/ai-software-factory
git -C ~/ai-software-factory checkout 9e2d85298b45497031009597a6ae0811b66fe6d6
python ~/ai-software-factory/bin/factory.py init

必要時使用 python3。安裝程式會複製工廠及專案範本，並安裝 pack.json 指定的 Archon 原始碼。這個提交的 README 與套件皆指定 fad09169ea1b43512bc7ee88470d47f960a3e0f8。安裝程式不會驗證供應商、選擇模型等級或啟動排程。在儲存庫接受修改前，先檢查實際檔案變更。

依照已安裝的 Archon 設定說明，設定所選供應商及支援的模型識別碼。在 harness/harness.config.json 填入專案實際的靜態檢查與單元測試指令。若 GitHub 無法回報分支保護資訊，在 required_checks 列出合併所需的 CI 工作。檢查 protected_paths，確保修改產品使命、驗證框架與工廠政策需要人工介入。範本把一般檢查指令及 required_checks 留白；僅複製範本不會建立可用的驗收關卡。

2. 為現有產品撰寫使命與檢查

在 MISSION.md 說明產品目的、硬性限制及合理但超出範圍的請求。在 harness/END-TO-END.md 描述現有應用程式確實能完成的二至五條使用者流程，包括使用者可見的價值。依賴尚未開發功能的流程會阻擋首次交付。在 .factory/holdout/HOLDOUT.md 另寫結合行為或探索邊界情況的案例。目錄名稱不會對能存取同一工作副本的開發者隱藏案例；真正私密的案例應置於副本外，只交給驗證環節。

若儲存庫只有 PRD，README要求從文件提取使命、預期流程及驗證指令。第一項提案任務必須讓產品可執行，並列明啟動指令、健康狀態與建置身分檢查路徑、測試及 CI。允許發布任務前，先審查提案。

把使用者流程轉成 Archon 執行工作流程預期的情境輸入。依已安裝的 factory/RUNTIME_HOST.md，從交付提交準備應用程式快照、全新狀態、健康與建置身分檢查，以及允許的 Python 或 Node 啟動指令。文件中的執行宿主不把遠端資料庫、容器或雲端資源當成自己管理的執行資源。使用這些資源的應用程式需要另行論證的驗證安排；本機宿主檢查成功不能證明它們已隔離。

依賴評估器前，先建立能驗證真實使用者價值且通過的基準，證明相關的刻意錯誤會失敗，並確認候選版本身分錯誤時回傳無法確定的判定。宿主指南列出測試套件輸入與精確的預期欄位，包括 expectations_passed: true 和 baseline_verified: true。保留實際原生回傳與候選版本身分作證。僅檢查頁面載入，或直接預先建立測試的最終狀態，都不足以完成驗證。

3. 檢查安裝，再選一項工作

從應用程式根目錄執行：

Terminal
python factory/consumer.py doctor
python factory/consumer.py list

doctor 檢查固定原始碼、指令能力及可用工作流程。list 顯示找到的工作流程。兩者都不能證明供應商能完成任務、CI 會通過或應用程式會執行。交付前先解決回報的問題；保持排程關閉。

對現有程式碼庫，撰寫一項結果明確且有驗收檢查的小任務。README 記錄了以下指令，從分類、交付與審查推進至提取請求：

Terminal
python factory/consumer.py run archon-ship --input target=https://github.com/OWNER/REPO/issues/1 --input discovery_publication=preview --detach --json

將任務 URL 換成你能管理的任務。明確設定 discovery_publication=preview，避免把審查中的相關發現發布為任務；固定的 archon-ship 工作流程預設使用 auto。只有執行情境與保留測試輸入準備好後，才使用 archon-lifecycle。以 target 傳入任務，以 scenario 和 holdout 傳入相應路徑，並設定 merge_mode=approve 和 discovery_publication=preview。也要提供專案核准的 merge_method：merge、squash 或 rebase。例如，只有儲存庫允許時才使用 merge_method=squash。此流程包含執行與保留測試驗證、修復及合併關卡。核准模式在合併前保留人的決定；工作流程的就緒標記不等於人工決定。工廠宿主的文件選項 --runtime-host 僅支援前景執行，不能搭配 --detach 或 --resume。

對 PRD，文件中的待辦生成指令為：

Terminal
python factory/consumer.py run archon-backlog --input 'prd=docs/PRD.md' --input publication=approve

將指令中加引號的 docs/PRD.md 換成 PRD 相對於應用程式工作副本的實際路徑。發布前審查提案任務及順序。依第一項任務宣告的啟動方式與身分契約設定宿主，再用已準備的流程及保留測試，透過 archon-lifecycle 處理該任務。第一項任務應與後續工作一樣仔細檢查。

4. 核准前評估差異與實際執行結果

保存回傳的執行 ID。控制程式提供 get <run-id> --json --events 與 status --all --json，用來查看進度及證據。對照 MISSION.md 檢查任務與計畫；閱讀實際提取請求差異及針對目前最新版本的獨立審查；檢查必要 CI 結果與受保護路徑報告。在交付版本執行產品流程，查看原生執行及保留測試結果，包括候選版本身分。將觀察到的使用者結果與驗收條件比對。審查者應把有缺陷的請求退回修復；README 說明了對合併佇列保留的交付執行使用 archon-deliver --adopt <run id>。

所有檢查通過後，只能由有儲存庫權限的人核准合併。部署需要專案自己的部署、健康與身分指令，並在部署後回讀版本；請求合併本身不代表已部署。首項任務期間保持排程關閉，再另外決定是否啟用定期執行。

維護者的成本說明沒有提供單次執行的固定價格。它建議從第一天量測權杖用量，啟用循環前先觀察一項小任務的模型呼叫。費用取決於供應商、模型與帳戶條款。BIG CHANGE 沒有量測這座工廠的支出。

執行中的工作也需要明確的停止決定。控制程式碼中的 halt 阻止新啟動和後續推進，cancel <run-id> 則針對執行中的工作。pause 停止計時器啟動新工作，但允許喚醒已在進行的工作。任何指令都不能取代檢查目前執行狀態與遠端儲存庫變更。

來源與延伸閱讀