如何于 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: 不修改代码，重新运行就能通过 → 重试一次，然后提交 issue
18- bug: 与最近提交相关的确定性失败 → 起草修复方案
19- dependency: 与版本升级相关的失败 → 起草回滚 PR
20- infra: 超时，OOM，运行器问题 → 立即上报
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
3在所有上次构建中失败的测试上运行 CI 分类技能。
4
5对于每个失败：
6- 使用 ci-triage 技能规则进行分类
7- 为错误和依赖问题起草修复方案
8- 上报环境和基础设施问题
9
10运行修复方案。检查测试是否通过。
11如果测试通过 → 开启 PR。
12如果测试仍然失败 → 记录在 STATE.md 中并停止。
13
14用本次运行完成的所有事项更新 STATE.md。
15
16硬性停止：最多尝试 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 中 — 参见上面的第六步

1# morning-brief-loop.md
2cat > morning-brief-loop.md << 'EOF'
3读取过去 24 小时的内容：
4- git log --since="24 hours ago" --oneline
5- 草稿或审查中的开放 PR
6- 过去 24 小时内创建或更新的 GitHub Issue
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 返回退出码 0 并且 npm run lint 返回退出码 0。
2不是"测试看起来不错"。不是"大部分测试通过"。
3两个命令的退出码都是 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、部署）都要有人工审查关卡