C.R.A.B Deploy Agent

核心用法

deploy-agent 是一个面向全栈应用的多阶段部署工作流工具，采用"人类在环"（Human-in-the-loop）设计理念，将复杂的部署流程拆解为 5 个可控步骤：设计初始化 → 本地构建 → 本地测试 → GitHub 推送 → Cloudflare 部署。每个关键节点都设置了人工审批环节，确保开发者在正式发布前有机会审查和确认。

典型工作流程：
1. 使用 init 创建部署项目并进入设计阶段
2. 配合 C.R.A.B 完成应用设计后，build 执行构建
3. test 验证本地运行状态
4. push 自动创建 GitHub 仓库并推送代码
5. deploy 部署至 Cloudflare Pages 并绑定自定义域名

状态管理：部署状态持久化存储于 ~/.clawdbot/skills/deploy-agent/state/，支持跨会话恢复，可随时通过 status 和 continue 查看进度或继续流程。

显著优点

• 流程可控：五步审批机制大幅降低误操作风险，特别适合生产环境部署
• 工具链整合：一站式打通 GitHub + Cloudflare 生态，避免多平台手动切换
• 状态持久：JSON 状态文件确保部署流程可中断、可恢复
• 域名自动化：默认提供 {name}.sheraj.org 子域名，支持自定义域名绑定
• 清理便捷：cancel 命令提供优雅的回滚和清理机制

潜在局限

• 外部依赖重：强制依赖 gh CLI、wrangler CLI、git 和 jq，任一工具缺失将导致流程中断
• 平台锁定：深度绑定 GitHub 和 Cloudflare，不支持 GitLab、Vercel、AWS 等替代平台
• 域名受限：默认域名归属 sheraj.org，企业用户可能需要额外配置自有域名
• 无回滚机制：文档未提及版本回退或历史部署管理功能
• 本地测试模糊：test 步骤仅提示启动 dev server，缺乏自动化测试集成

适合人群

• 个人开发者快速上线全栈项目
• 小型团队需要标准化部署流程
• 学习全栈部署流程的新手（审批机制提供安全边际）
• 已深度使用 GitHub + Cloudflare 生态的技术栈用户

常规风险

• 凭证泄露风险：Cloudflare API token 需配置在 ~/.wrangler.toml，需确保文件权限正确（建议 600）
• 状态文件损坏：JSON 状态文件若被手动修改可能导致部署流程异常
• GitHub 权限问题：gh CLI 需预先完成身份认证，否则 push 步骤将失败
• 域名冲突：{name}.sheraj.org 可能存在命名冲突，建议提前确认或使用自定义域名
• 网络依赖：Cloudflare 和 GitHub API 调用受网络环境制约