需要运行 Apex 测试…

适用于 Salesforce Apex 单元测试执行、覆盖率分析和结构化 test-fix 循环。

适用场景

解决思路

1. 使用 sf apex run test 工作流执行 Apex 测试。
2. 询问或推断 target org alias、期望测试范围（single class、specific methods、suite 或 local tests）、覆盖率阈值期望、用户只要诊断还是 test-fix loop、是否已有相关测试数据 factories。
3. 发现测试范围：识别现有测试类、目标生产类、测试数据 factories / setup helpers。
4. 调试失败时先运行最小有用测试集；修复稳定后再扩大测试范围。
5. 分析结果时重点看：失败方法、异常类型与 stack traces、未覆盖行 / 薄弱覆盖区域、失败是否说明测试数据差、断言脆弱或生产逻辑损坏。
6. 运行有纪律的 fix loop：需要时把代码修复委托给 sf-apex；添加或改进测试；先重跑聚焦测试，再跑更广回归。
7. 有意提升覆盖率：覆盖正向路径、负向 / 异常路径、bulk 路径（适用时 251+ records）、callout 或 async 路径（相关时）。
8. 默认使用 SeeAllData=false。
9. 每个测试都应断言有意义的 outcomes。
10. 测试 bulk behavior，而不只是单记录 happy path。
11. 当 factories / @TestSetup 能提升清晰度和速度时使用它们。
12. 当 async behavior 重要时，将 Test.startTest() 与 Test.stopTest() 配对。
13. 不要把 flaky org dependencies 隐藏在测试中。
14. 结束时按顺序报告：1. 运行了哪些测试；2. 通过/失败摘要；3. 覆盖率结果；4. 根因发现；5. 修复或下次运行建议。
15. 使用建议输出格式：Test run: <scope>; Org: <alias>; Result: <passed / partial / failed>; Coverage: <percent / key classes>; Issues: <highest-signal failures>; Next step: <fix class, add test, rerun scope, or widen regression>。
16. 跨技能委派：修复生产代码或编写测试委托给 sf-apex。
17. 跨技能委派：创建 bulk / edge-case 数据委托给 sf-data。
18. 跨技能委派：部署更新后的测试委托给 sf-deploy。
19. 跨技能委派：检查详细 runtime logs 委托给 sf-debug。
20. 从 references/cli-commands.md、references/test-patterns.md、references/testing-best-practices.md、references/test-fix-loop.md 开始查阅。
21. 查阅 specialized guidance：references/mocking-patterns.md、references/performance-optimization.md、assets/。
22. 用评分指南判断测试置信度：108+ 为强生产级；96–107 为良好但有少量缺口；84–95 为可接受但需加强覆盖/断言；<84 为低于标准，依赖前先修订。

适用边界 · 注意事项

• 不要用于编写或重构生产 Apex 代码；应改用 sf-apex。
• 不要用于测试 Agentforce agents；应改用 sf-ai-agentforce-testing。
• 不要用于用 Jest 测试 LWC；应改用 sf-lwc。