如何在 2026 年打造你的第一個 AI Loop

1npm i -g @randomlabs/slate

1cd /path/to/your/project
2slate

1# AGENTS.md
2
3## 這個程式碼庫是做什麼的
4[一段專案描述]
5
6## 架構
7- src/api/ — Express API 路由
8- src/services/ — 業務邏輯
9- src/db/ — 資料庫模型（透過 Prisma 連接 PostgreSQL）
10- tests/ — Jest 測試套件
11
12## 主要指令
13- npm test — 執行完整的測試套件
14- npm run build — TypeScript 編譯
15- npm run lint — ESLint 檢查
16- npm run typecheck — tsc --noEmit
17
18## 規則
19- 未經人類核准，絕不修改 src/billing/ 或 src/auth/
20- 在將任何任務標記為完成之前，務必先執行測試
21- 使用 src/utils/errors.ts 中現有的錯誤處理模式
22
23## 環境
24- .env.slate 包含 Slate 需要的所有環境變數

1/workspace add ./src
2/workspace add ./tests
3/workspace list

1請檢視 @src/api/routes.ts 並提出改進建議

1{
2  "$schema": "https://randomlabs.ai/config.json",
3  "permission": {
4    "*": "allow",
5    "bash": "ask"
6  },
7  "models": {
8    "main": { "default": "anthropic/claude-opus-4.6" },
9    "subagent": { "default": "anthropic/claude-sonnet-4.6" },
10    "search": { "default": "anthropic/claude-haiku-4.5" },
11    "reasoning": { "default": "openai/gpt-5.6" }
12  }
13}

1slate run "執行測試套件並修復所有失敗" --dangerously-skip-permissions --output-format stream-json

1請檢視我整個程式碼庫的架構。
2建立一個 ARCH.md 檔案，包含：
3- 目前的結構
4- 模組之間的依賴關係
5- 3 個需要改進的地方
6先看 @src/，然後看 @tests/

1嘿 Slate，研究我程式碼庫中的認證流程，
2然後制定一個加入 OAuth2 支援的計畫。
3請務必查看 @src/auth/ 和 @src/api/routes.ts

1不，不要新增一個新的認證提供者類別。
2讓它遵循 src/auth/api-key.ts 中現有的 ApiKeyAuth 模式

1mkdir -p .slate/skills/ci-triage
2touch .slate/skills/ci-triage/SKILL.md

1---
2name: "ci-triage"
3description: "分類 CI 失敗的根本原因，並為簡單的問題起草修復方案。"
4---
5
6# CI 分類技能
7
8## 我要做什麼
9當 CI 運行失敗時，我會：
101. 讀取測試輸出
112. 分類失敗原因：環境問題 / 不穩定的測試 / 真正的錯誤 / 依賴套件版本更新 / 基礎設施問題
123. 為錯誤和依賴問題起草修復方案
134. 將環境和基礎設施問題升級給人類處理
14
15## 分類規則
16- env：缺少機密、錯誤的環境變數 → 標記給人類
17- flake：不修改程式碼重新執行就會通過 → 重試一次，然後開立議題
18- bug：與近期提交相關的確定性失敗 → 起草修復方案
19- dependency：與版本更新相關的失敗 → 起草回滾 PR
20- infra：超時、記憶體不足、執行器問題 → 立即升級
21
22## 修復模式
23- 認證測試失敗 → 先檢查 src/auth/middleware.ts
24- 資料庫測試失敗 → 確認遷移已在 CI 環境中執行
25- E2E 測試失敗 → 檢查 UI 選擇器是否與最新快照相符
26
27## 絕對不做的事
28- 停用失敗的測試
29- 未經詢問修改 CI 設定
30- 碰觸 src/billing/ 或 src/payments/
31
32## 狀態
33每次運行後更新 STATE.md：
34- 檢查過的檔案
35- 做出的分類
36- 已開啟的 PR
37- 已升級的事項

1/skills

1@ci-triage 請分類今天失敗的測試

1# 循環狀態 — CI 分類
2
3## 上次運行
42026-06-28 03:30 UTC — 7 個失敗已分類，3 個修復方案已草擬，4 個已升級
5
6## 進行中
7- claude/fix-auth-token-refresh — 測試在本地端通過，等待 CI
8- claude/fix-flaky-payment-webhook — 已套用重試模式，監控中
9
10## 已完成
11- claude/bump-axios-1.7.4 → 已合併（CI 綠燈）
12- claude/lint-fix-pass-june-28 → 已合併
13
14## 已升級給人類
15- src/billing/refund.ts — 測試以 3 種方式失敗，根本原因不明
16- ci/staging-runner — 基礎設施超時，非程式碼問題
17
18## 學到的經驗
19- 2026-06-27：PowerShell 在此 Windows 執行器上遇到 TLS 1.2 問題。請改用 bash。
20- 2026-06-26：tests/e2e/checkout 需要在環境變數中設定 Stripe webhook 密鑰。如果缺少則跳過。

1## 會話開始
2總是先讀取 STATE.md。從上次運行中止的地方繼續。
3每次運行結束時更新 STATE.md，記錄已完成的事項和下一步計畫。

1讀取 STATE.md 以了解已經嘗試過什麼。
2對上次建置中所有失敗的測試執行 CI 分類技能。
3
4針對每個失敗：
5- 使用 ci-triage 技能規則對其進行分類
6- 為錯誤和依賴問題起草修復方案
7- 將環境和基礎設施問題升級
8
9執行修復方案。檢查測試是否通過。
10如果測試通過 → 開啟 PR。
11如果測試仍然失敗 → 記錄在 STATE.md 中並停止。
12
13更新 STATE.md，記錄此次運行完成的所有事項。
14
15硬性停止：最多 8 次嘗試。達到上限時，報告當前狀態。

1slate --queue loop.md

1slate run "$(cat loop.md)" --output-format stream-json --dangerously-skip-permissions

1name: CI 分類循環
2on:
3  workflow_run:
4    workflows: ["CI"]
5    types: [completed]
6
7jobs:
8  triage:
9    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
10    runs-on: ubuntu-latest
11    steps:
12      - uses: actions/checkout@v4
13
14      - name: 安裝 Slate
15        run: npm i -g @randomlabs/slate
16
17      - name: 執行分類循環
18        env:
19          SLATE_API_KEY: ${{ secrets.SLATE_API_KEY }}
20        run: |
21          slate run "$(cat loop.md)" \
22            --output-format stream-json \
23            --dangerously-skip-permissions \
24            --workspace ./src \
25            --workspace ./tests

1{
2  "models": {
3    "main": { "default": "anthropic/claude-opus-4.6" },
4    "subagent": { "default": "anthropic/claude-sonnet-4.6" },
5    "search": { "default": "anthropic/claude-haiku-4.5" }
6  }
7}

1請修復失敗的認證測試。
2
3步驟 1：讓一個搜尋 Agent 探索 src/auth/，以了解目前的實作。
4步驟 2：讓另一個 Agent 根據找到的資訊來實作修復。
5步驟 3：讓第三個 Agent 根據原始的測試需求來驗證修復方案——
6        這個 Agent 不應該看過實作過程。
7步驟 4：只有在驗證者核准後才開啟 PR。

1你正在運行一個多會話循環。
2
3目標：將所有 Express 路由遷移到新的 ApiError 模式。
4在 STATE.md 中追蹤進度。
5
6每個會話開始時：
71. 讀取 STATE.md
82. 找到「剩餘路由」中的第一個未完成項目
93. 只處理那個項目
10
11每個會話結束時：
121. 將已完成的項目移到 STATE.md 的「已完成路由」
132. 將任何阻礙因素記錄在「阻礙因素」中
143. 更新「上次運行」時間戳記
154. 乾淨地停止
16
17STATE.md 格式：
18---
19## 已完成路由
20- [x] /api/users (2026-06-27)
21- [x] /api/auth/login (2026-06-28)
22
23## 剩餘路由
24- [ ] /api/payments/checkout
25- [ ] /api/payments/refund
26- [ ] /api/admin/users
27
28## 阻礙因素
29- /api/payments/refund — 需要人工審查（涉及計費邏輯）
30
31## 上次運行
322026-06-28 14:30 UTC
33---
34
35嚴格規則：
36- 未經人類核准，絕不碰觸 src/billing/
37- 每次遷移路由後務必執行測試
38- 每個會話完成一條路由後就停止

1slate --continue "$(cat loop.md)"

1{
2  "command": {
3    "triage": {
4      "description": "執行 CI 分類循環",
5      "template": "讀取 STATE.md。對所有失敗的測試執行 ci-triage 技能。完成後更新 STATE.md。",
6      "agent": "build"
7    },
8    "review": {
9      "description": "檢視一個檔案的正確性",
10      "template": "檢視 @$ARGUMENTS 的正確性、邊界情況以及與周圍程式碼的一致性。"
11    },
12    "migrate": {
13      "description": "將一條路由遷移到 ApiError 模式",
14      "template": "讀取 STATE.md。將下一條未完成的路由遷移到 ApiError 模式。執行測試。更新 STATE.md。"
15    }
16  }
17}

1/triage
2/review src/api/payments.ts
3/migrate

1# 觸發
2slate run "$(cat loop.md)" --dangerously-skip-permissions --output-format stream-json
3
4# 或者用 GitHub Actions——請見上方步驟 6

1# 用於晨間簡報的 loop.md
2cat > morning-brief-loop.md << 'EOF'
3讀取過去 24 小時的：
4- git log --since="24 hours ago" --oneline
5- 處於草稿或審查中的開啟 PR
6- 過去 24 小時內已開啟或更新的 GitHub Issues
7
8撰寫一份晨間簡報：
9- 3 件最重要的事
10- 2 件今天需要注意的事
11- 1 件可能阻礙別人的事
12
13保持在 120 字以內。發布到 #engineering Slack 頻道。
14EOF
15
16# 使用 cron 排程執行
170 7 * * 1-5 slate run "$(cat morning-brief-loop.md)" --dangerously-skip-permissions

1cat > deps-loop.md << 'EOF'
2讀取 STATE.md。
3
4執行：npm outdated
5
6針對每個過時的套件：
71. 檢查版本更新是 major（破壞性）還是 minor/patch（安全）
82. 如果是 minor/patch：更新套件，執行 npm test
93. 如果測試通過：開啟一個 PR
104. 如果測試失敗：在 STATE.md 中記錄為「需要人工審查」
115. 如果是 major 更新：一律升級給人類處理
12
13嚴格規則：
14- 單次循環最多更新 5 個套件
15- 絕不更新「peer dependencies」部分的套件
16- 每次更新後都必須執行完整的測試套件，而不僅僅是相關測試
17
18更新 STATE.md，記錄已更新和已升級的項目。
19EOF
20
21# 每週一執行
220 9 * * 1 slate run "$(cat deps-loop.md)" --dangerously-skip-permissions

1停止條件：tests/auth/ 中的所有測試均通過 且 lint 回傳值為 0。
2使用一個單獨的檢查運行來驗證，而不是 Agent 自己的判斷。
3硬性上限：8 次疊代。達到上限時：報告狀態並停止。

1# VISION.md — 在每次會話開始時讀取
2
3## 核心目標
4將所有 Express 路由遷移到 ApiError 模式。
5
6## 嚴格約束（絕不違反）
7- 未經人類核准，絕不碰觸 src/billing/
8- 絕不停用失敗的測試
9- 在開啟任何 PR 之前，務必執行完整的測試套件
10
11## 當前優先順序
12src/api/payments/ 中的路由——處理時要格外小心

1驗證者 Agent 不應該看到執行者 Agent 的工作。
2它應該只能看到：原始的測試需求和測試輸出。
3如果測試通過 → 核准。如果測試失敗 → 拒絕。除此之外沒有意見。

1完成條件：npm test 回傳 exit code 0 且 npm run lint 回傳 exit code 0。
2不是在「測試看起來不錯」時。不是在「多數測試通過」時。
3兩個指令都回傳 exit code 0。這就是唯一的完成條件。

1[Slate 正在執行遷移任務...]
2
3你：對了，請確保新的模式也處理了 userId 為 null 的情況
4[Tab — 已排隊]
5
6[Slate 完成當前步驟，然後讀取你排隊的訊息]

1[Slate 正在執行修復方案的一半...]
2
3你：等等——不要為此新增一個新類別。使用 src/utils/errors.ts 中現有的 BaseError
4[Enter — 立即引導]
5
6Slate：收到，正在切換方法改用 BaseError...

1!npm test          # 執行測試並將輸出傳送給 Slate
2!git diff HEAD     # 檢查有什麼改變
3!git status        # 查看當前狀態

1# 終端機 1 — 啟動伺服器
2slate serve --port 7777
3
4# 終端機 2 — 連接 TUI
5slate attach http://localhost:7777 --dir /path/to/project

1□ 已安裝 npm i -g @randomlabs/slate
2□ 已建立 AGENTS.md，包含專案概覽、指令和規則
3□ 已建立 slate.json，包含權限和模型設定
4□ 已完成一次手動運行並驗證其可靠性
5□ 已為你的第一個重複任務撰寫 SKILL.md
6□ 已建立 STATE.md 並在 AGENTS.md 中引用
7□ 已撰寫 loop.md，包含明確的停止條件
8□ 已設定疊代次數的硬性上限（剛開始最多 8 次）
9□ 驗證者與執行者是不同的 Agent
10□ 對任何不可逆操作（PR、部署）設置了人工審查關卡