4x-autopilot

4x Autopilot

WARNING：owner-only，非 owner 請勿安裝或執行。（全自動行為定義見下方「核心原則」）

搭配 /loop 持續輪詢 4x 狀態，驅動 feature 完整生命週期。

核心原則

• 無狀態：每次 wakeup 從 4x 側重新讀狀態，session 斷線重連即接上
• 序列執行：一次只跑一個 feature，完成後才 pick 下一個
• 全自動：不停頓等確認，包括 merge MR
• 專案無關：所有專案特定值（repo 清單、GitLab 路徑）從 .4x/settings.json 動態讀取
• 永不停機：除非「沒有 not-started feature 可跑」或「使用者主動說暫停/停止」，否則不可停下來。完成一個 feature 後必須立即 IDLE-PICK 下一個，不可印 session 摘要、不可問「要繼續嗎？」、不可等確認。這是最高優先規則，違反等同 bug。

前置：讀取專案設定

每次 wakeup 開始時，先讀 .4x/settings.json 取得：

REPOS      = Object.keys(settings.workspace.repos)   # 所有 repo 名稱（動態，不硬寫）
HUB_REPOS  = settings.hub_repos || []                 # hub repo（同步時包含，scope 檢查時排除）
USE_GITLAB = settings.issue_tracker?.enabled == true   # 是否啟用 GitLab MR 流程

取得 GitLab group（僅 USE_GITLAB 時需要）：

# 從第一個 repo 的 git remote 推導
GITLAB_GROUP=$(git -C <first-repo> remote get-url origin | sed -E 's|.*[:/](.+)/[^/]+\.git$|\1|')
# 例如 [email protected]:server/kairos/kairos-core.git → server/kairos

參數

• 無參數：自動從 4x status --json --pending 按 priority + id 選下一個
• 帶 feature-id：優先跑指定 feature

每次 Wakeup 決策樹

每次被 /loop 喚醒時，依序檢查：

1. 讀取狀態

4x status --json --pending

解析 JSON，對每個 feature 取 id, name, status, priority, active 和對應的 state.phase。

2. 判斷當前階段

按以下優先順序判斷，命中第一個就執行，不繼續往下：

優先	條件	動作	下次 wakeup
1	有 feature active: true	→ 執行 RUNNING	270s
2	有 feature phase: pending-review	→ 執行 FINISHING	不排（連續執行）
3	有 feature phase: needs-attention 或 blocked，且累計失敗 < 2	→ 執行 AUTO-FIX	270s
4	有 feature phase: needs-attention 或 blocked，且累計失敗 ≥ 2	→ log 跳過該 feature	立即回到判斷
5	有 status: not-started 的 feature	→ 執行 IDLE-PICK	270s
6	都沒有	→ log 全部完成	1800s

IDLE-PICK：前置同步 + 選擇 + 啟動

觸發條件：決策樹優先 5（有 not-started feature 可跑）。

Step A: 前置同步（每次 pick 前必做）

對 REPOS 中每個 repo 依序執行（跳過 path 不存在的）：

# 跳過不存在的 repo 目錄
[ -d <repo> ] || continue

git -C <repo> fetch origin main
git -C <repo> merge --ff-only origin/main