mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-03 21:56:02 +08:00
37aa84df42
* Migrating Core Salesforce Skills * Updating pr comments * updat reference * Updating a skill * Migrating Datacloud skills * Migrating Industries cloud skills * Validating - skills fixing --------- Co-authored-by: Sandip Kumar Yadav <sandipkumar.yadav+sfemu@salesforce.com>
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
<!-- Parent: running-apex-tests/SKILL.md -->
|
|
|
|
# Agentic Test-Fix Loop Implementation
|
|
|
|
## How It Works
|
|
|
|
When the agentic loop is enabled, running-apex-tests will:
|
|
|
|
1. **Run tests** and capture results
|
|
2. **Parse failures** to identify error type and location
|
|
3. **Read source files** (test class + class under test)
|
|
4. **Analyze root cause** using the failure analysis decision tree
|
|
5. **Generate fix** by invoking sf-apex skill
|
|
6. **Re-run failing test** to verify fix
|
|
7. **Iterate** until passing or max attempts (3)
|
|
|
|
## Example Agentic Flow
|
|
|
|
```
|
|
User: "Run tests for AccountService with auto-fix enabled"
|
|
|
|
Claude:
|
|
1. sf apex run test --class-names AccountServiceTest --code-coverage --result-format json
|
|
2. Parse results: 1 failure - testBulkInsert line 45 NullPointerException
|
|
3. Read AccountServiceTest.cls (line 45 context)
|
|
4. Read AccountService.cls (trace the null reference)
|
|
5. Identify: Missing null check in AccountService.processAccounts()
|
|
6. Skill(sf-apex): Add null safety to AccountService.processAccounts()
|
|
7. Deploy fix
|
|
8. Re-run: sf apex run test --tests AccountServiceTest.testBulkInsert
|
|
9. ✅ Passing! Report success.
|
|
```
|
|
|
|
## Failure Analysis Decision Tree
|
|
|
|
| Error Type | Root Cause | Auto-Fix Strategy |
|
|
|------------|------------|-------------------|
|
|
| `System.AssertException` | Wrong expected value or logic bug | Analyze assertion, check if test or code is wrong |
|
|
| `System.NullPointerException` | Missing null check or test data | Add null safety or fix test data setup |
|
|
| `System.DmlException` | Validation rule, required field, trigger | Check org config, add required fields to test data |
|
|
| `System.LimitException` | Governor limit hit | Refactor to use bulkified patterns |
|
|
| `System.QueryException` | No rows returned | Add test data or adjust query |
|
|
| `System.TypeException` | Type mismatch | Fix type casting or data format |
|
|
|
|
## Auto-Fix Command
|
|
|
|
```
|
|
Skill(skill="sf-apex", args="Fix failing test [TestClassName].[methodName] - Error: [error message]")
|
|
```
|