XBuckle

主题

推荐工作流 ​

Agent playbook

场景：帮人类把应用接到 XBuckle ​

text
1. health + runtime.selftest
2. 读桌面 Connect → From scratch 的 prompt（或 services.describe）
3. 在应用仓库改 env（仅 loopback）
4. 用真实 SDK 发一个最小请求并确认 traffic.recent
5. 更新/补充测试；不要改 XBuckle 除非任务要求

场景：已有 .xbuj，继续开发（功能 / 数据） ​

text
1. 人类 Open 仓库里的 .xbuj（旁路 .xbujd/ 复用数据）
2. 复制 Connect → Develop tab 的 prompt
3. selftest；迁移/灌数打 :5432；业务用真实 SDK
4. traffic.recent / Control 验收
5. 这不是 Connect，也不是 Ship

场景：实现依赖 Postgres / Redis 的功能 ​

text
1. 确认 database / cache 服务在跑（Develop prompt）
2. DATABASE_URL / REDIS_URL → 本机 wire
3. 迁移或建表：可用 MCP data.query / 应用 migration 跑到 :5432
4. 业务代码只用官方 SDK
5. 用 chaos.inject 验证超时/重试（可选）

场景：Supabase 形应用（Auth + REST + RLS） ​

text
1. 指 VITE_SUPABASE_URL=http://127.0.0.1:3100
2. anon key = xbuckle-anon-key
3. 应用 migrations 到 PGlite（/db/exec 或 psql :5432）
4. signup → 带 JWT 调 /rest/v1
5. 需要 edge：XBUCKLE_FUNCTIONS_DIR + deno；无 key 时 XBUCKLE_AGENT_MOCK=1

场景：修 flaky 联调 ​

text
1. traffic.recent 看实际 path/status
2. route.override.set 固定下游
3. 或 chaos.inject 制造 500/延迟
4. 修应用重试/错误处理
5. chaos.clear

场景：上线前检查 ​

text
1. ship.scan + ship.checklist
2. ship.env_template 对齐部署密钥（不是 mock 值）
3. 提醒人类：生产构建不要 bake localhost

输出期望 ​

向人类汇报时写清：

  • 改了哪些 env（值是否仅 loopback）
  • 打过哪些端点 / selftest 结果
  • 已知能力缺口（对照 services.describe）