mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-07-30 03:09:50 +08:00
3.0 KiB
3.0 KiB
platform-apex-test-run
Comprehensive Salesforce testing skill with test execution, code coverage analysis, and agentic test-fix loops. Run tests, analyze coverage, and automatically fix failing tests.
Features
- Test Execution: Run Apex tests via sf CLI with coverage analysis
- Coverage Analysis: Parse reports, identify untested code paths
- Failure Analysis: Parse failures, identify root causes, suggest fixes
- Agentic Test-Fix Loop: Automatically fix failing tests and re-run
- 120-Point Scoring: Validation across 6 categories
- Bulk Testing: Validate with 251+ records for governor limits
Quick Start
1. Invoke the skill
Skill: platform-apex-test-run
Request: "Run all tests and show coverage report for org dev"
2. Common operations
| Operation | Example Request |
|---|---|
| Run class | "Run AccountServiceTest in org dev" |
| Run all | "Run all local tests with coverage" |
| Coverage report | "Show code coverage for AccountService" |
| Fix loop | "Run tests and fix failures automatically" |
| Generate tests | "Create tests for AccountService class" |
Key Commands
# Run single test class
sf apex run test --class-names MyClassTest --code-coverage --result-format json --target-org [alias]
# Run all local tests
sf apex run test --test-level RunLocalTests --code-coverage --result-format json --target-org [alias]
# Run specific methods
sf apex run test --tests MyClassTest.testMethod1 --target-org [alias]
# Run with output directory
sf apex run test --class-names MyClassTest --output-dir test-results --target-org [alias]
Scoring System (120 Points)
| Category | Points | Focus |
|---|---|---|
| Coverage | 25 | Overall and per-class coverage |
| Assertions | 25 | Meaningful assertions, edge cases |
| Bulk Testing | 20 | 251+ records, governor limits |
| Data Isolation | 20 | @TestSetup, test data factories |
| Negative Tests | 15 | Error paths, exceptions |
| Documentation | 15 | Test descriptions, clear naming |
Test Thresholds
| Level | Coverage | Purpose |
|---|---|---|
| Production | 75% minimum | Required for deployment |
| Recommended | 90%+ | Best practice target |
| Critical paths | 100% | Business-critical code |
Cross-Skill Integration
| Related Skill | When to Use |
|---|---|
| sf-apex | Fix failing Apex code |
| platform-apex-logs-debug | Analyze test failures with debug logs |
| platform-data-manage | Generate 251+ bulk test records |
| platform-metadata-deploy | Validate before deployment |
Agentic Test-Fix Loop
When enabled, the skill will:
- Run tests and capture failures
- Analyze error messages and stack traces
- Generate fixes for common issues
- Apply fixes and re-run tests
- Repeat until all tests pass or max iterations reached
Documentation
Requirements
- sf CLI v2
- Target Salesforce org
- Test classes in org or local project