xiaoxia-saas/docs/agents/AUTO-RUN-PROTOCOL.md

小虾 SaaS 全自动执行协议

目标

把小虾 SaaS 的开发方式从“半自动逐步请示”改为“目标授权后全自动执行”。老大只确认方向、范围和验收目标；小虾在授权范围内连续完成分析、开发、测试、构建、发布、监控和汇报。

固定 8 Agent

本项目只使用规则文档定义的 8 个 Agent 名称：

1. requirement_agent：需求确认、范围冻结、验收标准
2. arch_agent：架构方案、风险收敛、数据流/权限边界
3. code_dev_agent：前端、后端、Worker、脚本实现
4. lint_review_agent：代码规范、Review、安全和回归风险检查
5. test_agent：单测、集成测试、Playwright E2E、公网 smoke
6. build_pack_agent：前端 build、镜像构建、产物校验、包完整性
7. release_agent：tag、部署、版本一致性、上线验证
8. ops_monitor_agent：生产巡检、日志、资源、告警和回滚建议

默认自动授权范围

当老大明确给出目标（例如“按全自动模式执行”“修复上传链路并上线验证”“启动开发包 2”）后，小虾默认可以自动执行以下动作：

• 阅读项目代码、文档、日志和生产状态。
• 修改 F:\openclaw-saas 项目内代码、测试、脚本和文档。
• 新增必要测试、smoke、Playwright E2E 和发布检查。
• 本地运行测试、构建、lint、smoke。
• 提交到 develop。
• 在测试通过后打 tag、触发发布、部署生产。
• 运行公网 smoke、生产 health、日志检查和巡检。
• 对明确可恢复、低风险的生产配置热修做备份后执行。
• 对明显错误的派生数据做可审计回填，例如把已完成 ingest 的素材状态从 uploading 修为 ready。
• 更新项目状态板、Runbook、发布记录和 UAT 记录。

必须暂停请示的情况

以下情况必须暂停并向老大说明风险、选项和推荐方案：

• 涉及新增费用、扩容、购买云资源或启用付费服务。
• 删除生产数据、删除备份、清库、重置仓库、不可逆清理。
• 新增、暴露、轮换或修改敏感密钥、账号、安全策略。
• 改变产品方向、MVP 范围、商业策略或砍掉已确认能力。
• 高风险停机、数据库迁移、服务器重装、跨主机迁移。
• 需要老大提供验证码、真实文件、云控制台操作或人工验收材料。
• 自动修复连续 3 轮仍失败，且无法通过本地/生产证据继续收敛。

执行循环

每个目标按以下循环推进，默认不中途请示：

requirement_agent
  → arch_agent
  → code_dev_agent
  → lint_review_agent
  → test_agent
  → build_pack_agent
  → release_agent
  → ops_monitor_agent

如果任一阶段失败：

1. 记录失败证据。
2. 回到对应 Agent 修复。
3. 重新运行该阶段及之后所有门禁。
4. 最多自动重试 3 轮。
5. 仍失败才向老大汇报阻塞点。

完成标准

小虾不能只说“修好了”。完成必须同时满足：

• 相关单元测试通过。
• 前端改动通过 build。
• 真实浏览器 Playwright E2E 通过，若任务涉及 UI。
• 公网 smoke 通过，若任务涉及生产主流程。
• 生产 /health 版本与目标版本一致，若发版。
• 生产日志无新增关键 4xx/5xx/499 异常，若发版或热修。
• Agent Board 已更新当前状态、证据和下一步。

配置文件保护

除非老大明确授权，小虾不得修改 OpenClaw/自身配置和人格/记忆规则文件，包括但不限于：

• AGENTS.md
• SOUL.md
• MEMORY.md
• USER.md
• TOOLS.md
• META.md
• OpenClaw 运行时配置文件

日常开发只修改 F:\openclaw-saas 项目文件。记忆刷新只允许按用户明确要求追加到指定 memory/YYYY-MM-DD.md。