Skill: vetmomen/automation-testing-protocol (version 1.0.0)

--- name: Automation Quality Assurance & Testing Protocol id: automation-qa-testing version: 1.1.0 description: A comprehensive framework for testing and validating automation projects to ensure stability, security, and scalability. author: Moamen Mohamed --- # Automation Quality Assurance & Testing Protocol This skill is the primary authority for testing any automation project within the OpenClaw environment. It ensures operational stability, prevents regressions, and maintains high-quality standards across all automated workflows. --- ## Agent: How to Use This Skill Read this protocol fully before modifying or deploying any automation script. Follow the steps sequentially. ### 1. Comprehensive Automation Testing Strategy To ensure a robust automation, every project must pass through these 6 critical testing layers: - **Layer 1: Unit Testing (Logic)** - Test individual functions, mathematical calculations, and internal logic branches in isolation. - **Layer 4: Idempotency & Recovery** - Ensure that if a script fails and restarts, it does not produce side effects (e.g., no duplicate emails or redundant API calls). The script must be "Safe to Restart." - **Layer 2: Integration Testing (Connectors)** - Verify successful communication with external services (Meta API, Google Sheets, SMTP, etc.) using real or sandbox credentials. - **Layer 3: End-to-End (E2E) Flow** - Simulate a complete lifecycle of the automation (e.g., Budget Breach -> Pause -> Notify) to ensure the entire chain works. - **Layer 5: Regression Testing** - Always run the full `run_tests.py` suite after any change to confirm that existing features remain functional. - **Layer 6: Observability & Logging Verification** - Confirm that the script produces clear, actionable logs for every step, especially during failures, to ensure "blind spots" are eliminated. --- ### 2. Execution Protocol Do find and execute tests before and after every modification: 1. **Discover:** Always look for `run_tests.py` or a `tests/` directory within the project root. 2. **Execute:** ```bash python3 path/to/project/run_tests.py ``` 3. **Initialize:** If the project lacks tests, **you are mandated** to create a `run_tests.py` file implementing the 6 layers above. --- ### 3. Standard Exit Criteria (Definition of Done) A task is considered "Complete" only when: - **100% Pass Rate:** All 6 testing layers pass without errors. - **Timezone Uniformity:** All timestamps and scheduling are synchronized to the environment's local time (e.g., `Africa/Cairo`). - **Security Compliance:** Zero hardcoded secrets. All tokens and passwords must be isolated in `.env` or config files. - **Failure Resilience:** The script handles API timeouts and connection drops gracefully without crashing. - **Documentation:** The code is clean, commented, and includes a brief explanation of any new test cases added. --- ## Maintenance & Scalability - The Test Suite must grow with the project. Every new feature requires a corresponding test case. - Any project without a functional `run_tests.py` is considered "Substandard" and must be fixed immediately.

path: README.md
content: # OpenClaw Automation Testing Protocol 🚀
## (v1.1.0) - The Professional QA Framework

A comprehensive, 6-layer testing and validation framework designed for **OpenClaw** to ensure the reliability, security, and idempotency of automation scripts.

---

## 🌟 English Overview

This protocol establishes a "Golden Standard" for any automation project. It ensures that scripts are not only functional but also resilient to failures and safe to restart.

### 🧪 The 6-Layer Testing Strategy:
1. **Unit Testing (Logic):** Verifying individual functions and calculations.
2. **Integration Testing (Connectors):** Verifying API and SMTP connectivity.
3. **End-to-End (E2E) Flow:** Simulating the full automation lifecycle.
4. **Idempotency & Recovery:** Ensuring no side effects on script restarts.
5. **Regression Testing:** Guaranteeing stability after every code update.
6. **Observability & Logging:** Ensuring full visibility during execution and failures.

### ⚙️ How to Use
Agents in your OpenClaw environment will automatically follow this skill. You can manually run tests using:
```bash
python3 run_tests.py
```

---

## 🇪🇬 الملخص بالعربية

هذا البروتوكول يضع "المعيار الذهبي" لأي مشروع أتمتة في بيئة **OpenClaw**. يضمن أن السكربتات ليست فقط شغالة، بل قوية في مواجهة الأعطال وآمنة عند إعادة التشغيل.

### 🧪 استراتيجية الاختبار السداسية:
1. **اختبار الوحدة (Unit):** للتأكد من صحة الحسابات والمنطق البرمجي.
2. **اختبار التكامل (Integration):** للتأكد من الربط مع المنصات الخارجية (APIs).
3. **الاختبار الشامل (E2E):** محاكاة دورة العمل الكاملة من البداية للنهاية.
4. **إعادة التشغيل الآمن (Idempotency):** ضمان عدم تكرار العمليات عند فشل السكربت وإعادته.
5. **اختبار التراجع (Regression):** ضمان أن التعديلات الجديدة لم يفسد القديم.
6. **المراقبة والشفافية (Observability):** التأكد من وجود سجلات (Logs) واضحة لكل خطوة.

---

## 📄 License
This project is licensed under the MIT-0 License - see the [LICENSE](LICENSE) file for details.

## ✍️ Author
Created by **[Moamen Mohamed](https://github.com/VetMomen)**.


path: skill.json
content: {
  "name": "Automation Testing Protocol",
  "id": "automation-testing-protocol",
  "version": "1.1.0",
  "author": "Moamen Mohamed",
  "description": "A comprehensive framework for testing and validating automation projects in OpenClaw.",
  "category": "Quality Assurance",
  "tags": ["testing", "automation", "qa", "framework"],
  "repository": "https://github.com/VetMomen/openclaw-automation-testing.git",
  "license": "MIT-0"
}


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)