自动化质量保证与测试协议

此技能是 OpenClaw 环境中所有自动化项目测试的权威依据。它确保操作稳定性，防止回归问题，并在所有自动化流程中维持高标准的质量。

代理：如何使用此技能

在修改或部署任何自动化脚本之前，请完整阅读本协议。请按顺序执行以下步骤。

1. 全面自动化测试策略

为确保自动化系统的健壮性，每个项目必须通过以下六个关键测试层级：

• 第1层：单元测试（逻辑） - 在隔离环境中测试单个函数、数学计算和内部逻辑分支。
• 第4层：幂等性与恢复能力 - 确保脚本在失败后重启时不会产生副作用（例如不发送重复邮件或冗余 API 调用）。脚本必须具备“安全重启”特性。
• 第2层：集成测试（连接器） - 使用真实或沙箱凭证验证与外部服务（Meta API、Google Sheets、SMTP 等）的通信是否成功。
• 第3层：端到端（E2E）流程 - 模拟自动化完整生命周期（例如：预算超支 → 暂停 → 通知），确保整个链路正常运行。
• 第5层：回归测试 - 每次修改后，必须运行完整的 run_tests.py 测试套件，以确认现有功能仍可正常使用。
• 第6层：可观测性与日志验证 - 确保脚本在每一步都生成清晰、可操作的日志，尤其在失败时，消除“盲点”。

2. 执行协议

每次修改前后都必须查找并执行测试：

1. 发现：始终检查项目根目录下是否存在 run_tests.py 或 tests/ 目录。
2. 执行：

   python3 path/to/project/run_tests.py

1. 初始化：如果项目缺少测试，则必须创建一个实现上述六层测试的 run_tests.py 文件。

3. 标准退出标准（完成定义）

只有当满足以下条件时，任务才被视为“已完成”：

• 100% 通过率：所有六层测试均无错误通过。
• 时区统一性：所有时间戳和调度均同步至环境本地时区（例如：Africa/Cairo）。
• 安全合规性：无硬编码密钥。所有令牌和密码必须存放在 .env 或配置文件中。
• 故障容错性：脚本能妥善处理 API 超时和连接中断，不会崩溃。
• 文档完整性：代码清晰、有注释，并包含对新增测试用例的简要说明。

维护与可扩展性

• 测试套件应随项目增长而扩展。每个新功能都需配套相应的测试用例。
• 任何缺乏功能性 run_tests.py 的项目均视为“不合格”，必须立即修复。