AI-translated from English; not yet reviewed by a fluent editor.

# 設定以 Archon 為基礎的軟體工廠，並審查一項任務

> 依據固定版本的維護者文件，規劃並審查一項 Archon 程式開發任務：從產品使命、執行檢查到由人決定是否合併。BIG CHANGE 並未執行這座工廠。

By BIG CHANGE Editorial

Published: 2026-10-19T14:43:34.857Z
Updated: 2026-10-19T14:43:34.857Z
Canonical: https://bigchange.ai/blog/archon-software-factory-reviewed-issue

![Conceptual charcoal illustration of one reviewer studying an unbranded two-column code change printout clipped to a wall rail.](https://bigchange.ai/api/media/file/archon-reviewed-code-change-v2.png)
AI-generated conceptual illustration by BIG CHANGE; no factory installation, issue delivery, code review outcome or product interface is depicted.

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

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

## 重大改變

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

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

維護者的[安裝說明](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent)要求 Git、Python 3.10 或更新版本、已通過驗證的 `gh`（具 `workflow` 權限範圍）、GitHub 遠端儲存庫、程式開發代理、Bun 與 uv。Git 也必須能推送工作流程檔案（`gh auth setup-git`）。啟動代理前，核對現有測試、啟動與 CI 指令、分支保護、GitHub 存取、供應商驗證與模型計費。只授予執行所需的儲存庫和工作流程權限。

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

```bash
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`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent)要求從文件提取使命、預期流程及驗證指令。第一項提案任務必須讓產品可執行，並列明啟動指令、健康狀態與建置身分檢查路徑、測試及 CI。允許發布任務前，先審查提案。

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

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

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

從應用程式根目錄執行：

```bash
python factory/consumer.py doctor
python factory/consumer.py list
```

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

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

```bash
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，文件中的待辦生成指令為：

```bash
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>`。

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

維護者的[成本說明](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#cost)沒有提供單次執行的固定價格。它建議從第一天量測權杖用量，啟用循環前先觀察一項小任務的模型呼叫。費用取決於供應商、模型與帳戶條款。BIG CHANGE 沒有量測這座工廠的支出。

執行中的工作也需要明確的停止決定。[控制程式碼](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py)中的 `halt` 阻止新啟動和後續推進，`cancel <run-id>` 則針對執行中的工作。`pause` 停止計時器啟動新工作，但允許喚醒已在進行的工作。任何指令都不能取代檢查目前執行狀態與遠端儲存庫變更。

## 來源與延伸閱讀

- [固定版本的工廠 README](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md)：安裝步驟、指令、產品輸入、工作流程選擇與聲明的限制。這是維護者描述，不是 BIG CHANGE 執行的證據。
- [固定套件清單](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json)與[控制程式碼](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py)：Archon 版本、提供的工作流程，以及 status、halt、cancel、pause 的區別。
- [首小時指南](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md)與[執行宿主指南](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md)：維護者對驗證的保留說明，以及綁定候選版本的執行檢查要求。
- [BIG CHANGE 關於程式開發代理與已完成工作的相關報導](https://bigchange.ai/articles/ai-coding-agents-review-output-study)：檢查完成結果的背景。報導研究不同主題，並非這座工廠實作的後續進展。

## Sources

- [README.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) — 維護者的安裝、專案檔案、工作流程、任務與 PRD 路徑、合併政策及執行限制。
- [pack.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) — 指定確切 Archon 版本、工作流程及命令列能力，與固定 README 一致。
- [first-hour.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) — 安裝順序及仍需真實端對端驗證的明確聲明。
- [consumer.py](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py) — doctor/list、工作流程呼叫、status、halt、pause 與 cancel 的實作。
- [RUNTIME_HOST.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md) — 候選版本綁定、基準與刻意錯誤校準、支援的應用程式形式及限制。
- [harness.config.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/harness/harness.config.json) — 顯示留白的專案檢查指令、必要檢查設定與預設受保護路徑。
- [LICENSE](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/LICENSE) — Archon 授權條款；不能證明獨立工廠儲存庫也獲得許可。
- [archon-ship.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/ship/archon-ship.yaml) — 確認發現事項預設以 auto 發布，preview 不發布相關發現。
- [archon-lifecycle.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/lifecycle/archon-lifecycle.yaml) — 要求明確指定 merge、squash 或 rebase 合併方式。
- [archon-backlog.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/backlog/archon-backlog.yaml) — PRD 以工作副本內的路徑指定。
- [BIG CHANGE](https://bigchange.ai/articles/ai-coding-agents-review-output-study) — 與檢查完成結果相關、但主題不同的背景。