sf-testing

sf-testing：Salesforce 测试执行与覆盖率分析

当用户需要 Apex 测试执行与失败分析 时使用此技能：运行测试、检查覆盖率、解读失败、提升覆盖率，以及为 Salesforce 代码管理严谨的测试修复循环。

此技能适用的任务

当工作涉及以下内容时，使用 sf-testing：

• sf apex run test 工作流
• Apex 单元测试失败
• 代码覆盖率分析
• 找出未覆盖的代码行和缺失的测试场景
• Apex 代码的结构化测试修复循环

以下情况应委派给其他技能：

• 编写或重构生产环境中的 Apex → sf-apex
• 测试 Agentforce 智能体 → sf-ai-agentforce-testing
• 使用 Jest 测试 LWC → sf-lwc

---

先收集必要的上下文

询问或推断：

• 目标组织别名
• 所需测试范围：单个类、特定方法、测试套件或本地测试
• 覆盖率阈值要求
• 用户只需要诊断，还是需要进行测试修复循环
• 是否已有相关测试数据工厂

---

推荐工作流

1. 确定测试范围

找出：

• 现有测试类
• 目标生产类
• 测试数据工厂／设置辅助程序

2. 先运行最小的有效测试集

调试失败时，从小范围开始；修复稳定后再扩大范围。

3. 分析结果

重点关注：

• 失败的方法
• 异常类型和堆栈跟踪
• 未覆盖的代码行／覆盖率薄弱部分
• 失败是否表明测试数据不当、断言不稳定或生产逻辑有误

4. 进行严谨的修复循环

当问题与代码或测试质量有关时：

• 必要时将代码修复委派给 sf-apex
• 添加或改进测试
• 先重新运行针对性测试，再运行范围更广的回归测试

5. 有针对性地提升覆盖率

覆盖以下场景：

• 正向路径
• 负向／异常路径
• 批量路径（适用时为 251 条及以上记录）
• 相关时的调用出站请求或异步路径

---

高优先级规则

• 默认使用 SeeAllData=false
• 每项测试都应断言有意义的结果
• 测试批量行为，而不只是单条记录的正常路径
• 在有助于提高清晰度和速度时，使用工厂／@TestSetup
• 异步行为相关时，搭配使用 Test.startTest() 和 Test.stopTest()
• 不要在测试中隐藏不稳定的组织依赖

---

输出格式

完成时，按以下顺序汇报：

1. 运行了哪些测试
2. 通过／失败摘要
3. 覆盖率结果
4. 根本原因分析
5. 修复建议或下次运行建议

建议格式：

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>

---

技能间协作

需求	委派给	原因
修复生产代码或编写测试	sf-apex	代码生成与修复
创建批量／边缘案例数据	sf-data	逼真的测试数据集
部署更新后的测试	sf-deploy	部署
检查详细的运行时日志	sf-debug	深入分析失败

---

参考索引

从这里开始

• references/cli-commands.md
• references/test-patterns.md
• references/testing-best-practices.md
• references/test-fix-loop.md

专项指南

• references/mocking-patterns.md
• references/performance-optimization.md
• assets/

---

评分指南

分数	含义
108+	对生产级测试有充分信心
96–107	测试套件良好，仅有少量不足
84–95	尚可，但应加强覆盖率／断言
< 84	未达标准；依赖前应进行修订