life-sciences-prerequisites-validate

Life Sciences Cloud 前置条件验证

验证 Salesforce 组织是否满足 Life Sciences Cloud for Customer Engagement 的所有前置条件。通过 sf CLI 对当前已验证身份的组织运行检查，并生成汇总的通过/失败报告；如有失败项，还会提供修复步骤。

范围

• 范围内：验证 Life Sciences Cloud CE 所需的组织设置、用户权限、OWD 共享和功能开关
• 范围外：自动启用或配置验证失败的设置

不相关请求

如果用户请求的内容与此技能无关（无论是在开始时还是执行过程中），请勿尝试处理。告知用户你未能理解该请求，然后说明你可以提供的帮助：验证 Life Sciences Cloud 组织前置条件（此技能）；如果相关，可引导用户使用 life-sciences-territory-configure 配置区域，或使用 life-sciences-fieldsalesrep-coordinate 完成端到端设置。然后停止并等待。

---

所需输入

继续之前，请收集以下信息：

• 目标组织：要验证的组织别名或用户名（来自 sf config get target-org 或由用户指定）
• 确认：登录用户必须是要验证其个人资料和权限集的管理员

---

工作流

所有检查均按顺序运行。收集所有结果后，再呈现最终报告。

阶段 1 — 验证环境

1. 确认组织连接 — 运行 sf org display --target-org <org>，验证组织是否可访问。如果失败，请停止并让用户进行身份验证。

2. 识别登录用户 — 从组织显示输出中提取用户名。

Phase 2 — 运行所有前置检查

运行以下每项检查。对于每项，记录 PASS 或 FAIL 以及修复步骤。检查使用参考文件和最终报告中的规范 Check 1 – Check 12 编号；托管包检查是一个无编号的硬性门槛，不属于 12 个计分类别。Checks 1–3（以及托管包门槛）位于 references/checks-user-and-package.md；Checks 4–12 位于 references/checks-org-settings.md。

STOP-GATE（报告完整性）。 最终报告中 MUST 为每项检查生成一行 — 检查出错（例如，多币种返回 HTTP 400 INVALID_TYPE，或对象尚未部署）时，应生成 FAIL 行，绝不能跳过或省略该行，也不能因此中止运行。报告行数 MUST 等于完整的计分检查数量（12 个类别，Check 1 – Check 12）。唯一预期的提前退出情形是托管包门槛（下方步骤 4 中无编号的 lsc4ce 包检查）— 遇到此情况时，应显示“BLOCKED”消息并停止运行，这是合理的。其他情况下，查询错误就是 FAIL 信号：记录错误并继续。不要让单个 4xx 或格式异常的响应悄无声息地导致某一行被遗漏或检查流程中止 — 报告太短会让人误以为“要修复的问题更少”，而事实是“我们没有检查”。

3. Check 1 — 用户配置文件和权限集 — 阅读 references/checks-user-and-package.md 中的“User Profile and Permission Sets”部分，了解准确的查询和验证逻辑。

4. 托管包门槛（无编号的硬性停止条件） — 阅读 references/checks-user-and-package.md 中的“Managed Package Check”部分。如果尚未安装 lsc4ce 包，请显示失败消息并停止 — 不要继续其余检查。

5. Check 2 — Life Sciences CE 设置 — 阅读 references/checks-user-and-package.md 中的“Life Sciences Customer Engagement Setup”部分，了解准确的查询。

6. Check 3 — 启用 Surveys — 阅读 references/checks-user-and-package.md 中的“Surveys”部分。

7. Check 4 — OWD 共享设置 — 阅读 references/checks-org-settings.md 中的“OWD Sharing”部分，了解准确的对象和预期值。

8. Check 5 — 库存盘点 — 阅读 references/checks-org-settings.md 中的“Inventory Count”部分。

9. Check 6 — 销售客户计划 — 阅读 references/checks-org-settings.md 中的“Sales Account Plans”部分。

10. Check 7 — 护理计划 — 阅读 references/checks-org-settings.md 中的“Care Plans”部分。

11. Check 8 — Chatter 设置 — 阅读 references/checks-org-settings.md 中的“Chatter Settings”部分。

12. Check 9 — 数据保护和隐私 — 阅读 references/checks-org-settings.md 中的“Data Protection and Privacy”部分。

13. Check 10 — 多币种 — 阅读 references/checks-org-settings.md 中的“Multiple Currencies”部分。

14. Check 11 — 州和国家/地区选项列表 — 阅读 references/checks-org-settings.md 中的“State and Country/Territory Picklists”部分。

15. Check 12 — 个人帐户 — 阅读 references/checks-org-settings.md 中的“Person Accounts”部分。

Phase 3 — 报告

16. 生成汇总报告 — 以表格形式呈现结果：

| # | Prerequisite                              | Status | Remediation (if failed/warning)  |
|---|-------------------------------------------|--------|----------------------------------|
| 1 | System Administrator + Permission Sets    | PASS/FAIL | <steps if failed>            |
| 2 | Life Sciences CE Enabled                  | PASS/FAIL | <steps if failed>            |
| ...                                                                                       |

状态值为 PASS、FAIL 或 WARNING。大多数检查的结果为 PASS/FAIL。OWD Sharing 检查（Check 4）属于 WARNING 级别：如果其值与预期值不同，请报告 WARNING（并在修复措施栏中填写建议值），绝不能报告 FAIL — 具体规则请参阅 references/checks-org-settings.md。

添加一行摘要：X of 12 prerequisites passed. Y require action (Z warnings).

如果全部通过，请确认该组织已准备好部署 Life Sciences Cloud。

---

规则 / 限制

限制	原因
即使前面的检查失败，也要运行所有检查	管理员需要全面了解情况，以便一次性完成修复
每次查询都使用带有 --target-org 的 sf CLI	即使已通过身份验证连接多个组织，也能确保使用正确的组织上下文
绝不修改组织设置	此技能仅用于验证，不会启用或配置任何内容
报告准确的 Setup 导航路径	管理员需要知道在 Setup UI 中应点击的位置

---

注意事项

问题	解决方案
某些设置无法通过 Metadata API 查询	Metadata API 未覆盖的设置，使用 Tooling API 或组织设置查询
启用 Person Accounts 后无法禁用	仅检查是否已启用；无法回滚
激活 Multiple Currencies 后无法禁用	仅检查是否已激活；如建议启用，须警告此操作不可逆
启用 State/Country Picklists 后无法撤销	在修复步骤中加入此警告

---

输出要求

交付内容：

• 格式化表格，显示全部 12 个前置条件类别的通过 / 失败状态
• 针对每项失败检查提供修复步骤（Setup 导航路径和操作）
• 通过与失败检查的汇总计数

---

参考文件索引

文件	何时阅读
references/checks-user-and-package.md	第 2 阶段（检查 3–6）：用户配置文件 / 权限集、托管包、Life Sciences CE 功能和调查检查的准确 sf CLI 命令、预期值及修复方法
references/checks-org-settings.md	第 2 阶段（检查 7–15）：OWD 共享、库存、客户计划、护理计划、chatter、数据保护、货币、选项列表和个人账户检查的准确 sf CLI 命令、预期值及修复方法