К основному содержанию
скилл CX Codex

service-omni-supervisor-permset-assign — скилл для Claude Code

Скилл service-omni-supervisor-permset-assign для Claude Code, автоматизирующий назначение ContactCenterSupervisor пользователям в Salesforce. Запускает проверку и выдачу прав супервайзера в CI или окружении разработки.

Apache-2.0 102 установок ★ 1 183 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill service-omni-supervisor-permset-assign -a claude-code
Открыть на GitHub

Что делает service-omni-supervisor-permset-assign

Этот скилл назначает набор разрешений ContactCenterSupervisor пользователям в Salesforce через PermissionSetAssignment. Он проверяет существующие пары «пользователь-разрешение» и не создаёт дубликаты, что позволяет безопасно перезапускать скрипт.

Инструмент считывает активных супервайзеров и применяет права, опираясь на установленные в системе лицензии. Без sf CLI версии 2.139.6 и jq версии 1.6 скрипт не выполнится. Скилл блокирует любые операции на продуктовых организациях для безопасности, а для работы нужны права системного администратора в целевой org.

Какие задачи решает

  • назначить права супервайзера пользователям
  • проверить наличие разрешений в PermissionSet
  • автоматизировать выдачу доступов для Service Cloud

Примеры запросов агенту

  • Назначь права ContactCenterSupervisor для 3 пользователей в dev-org
  • Выполни scripts/verify-and-assign.sh для выдачи доступов в целевой организации

Как установить service-omni-supervisor-permset-assign

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-supervisor-permset-assign -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-omni-supervisor-permset-assign/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-omni-supervisor-permset-assign/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-omni-supervisor-permset-assign

Как установить service-omni-supervisor-permset-assign в Claude Code?

Выполните команду npx skills add forcedotcom/sf-skills --skill service-omni-supervisor-permset-assign -a claude-code в терминале проекта.

Что делает service-omni-supervisor-permset-assign?

Скилл автоматически назначает стандартный набор разрешений ContactCenterSupervisor пользователям Salesforce через DML-операции, исключая повторы при помощи SOQL-запросов.

Что нужно для работы service-omni-supervisor-permset-assign?

Необходимы установленные sf CLI (v2.139.6 и выше) и jq (v1.6 и выше), а также активные пользователи с лицензией Service Cloud и права администратора в Salesforce.

Исходный текст

SKILL.md · Apache-2.0
---
name: service-omni-supervisor-permset-assign
description: "Use to assign the Salesforce-shipped standard ContactCenterSupervisor PermissionSet (default) to N existing supervisor users via PermissionSetAssignment DML. Idempotent — SOQL detects existing (user, perm-set) pairs before POST, and DUPLICATE_VALUE is treated as reused. The standard set carries its own permission-set license and assigns cleanly on Service-Cloud-enabled orgs; a user whose license lacks the entitlement surfaces FIELD_INTEGRITY_EXCEPTION so the operator can fix the profile/license. Triggers: assign the supervisor permset, grant supervisor perms, complete supervisor provisioning. Do not use on production orgs or to assign agent permsets."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-supervisor-config-deploy"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-supervisor-permset-assign

Assign the Salesforce-shipped standard `ContactCenterSupervisor` PermissionSet to existing supervisor users via `PermissionSetAssignment`. The classic Omni-Channel Supervisor UI (Command Center) requires supervisors to hold contact-center supervisor permissions before `service-omni-supervisor-config-deploy` can bind them. The skill uses detect-before-POST idempotency and treats `DUPLICATE_VALUE` as an already-satisfied assignment.

**Licensing.** The supervisor system permissions (`IsContactCenterSupervisor`, `OmniSupervisorManageQueue`, `ViewOmnichnlAnlytDshbrd`) are gated by a permission-set license. The standard `ContactCenterSupervisor` set carries its own license linkage and assigns cleanly on a Service-Cloud-enabled org, so it is the default and supported path — a hand-rolled custom set that re-declares these permissions fails with `FIELD_INTEGRITY_EXCEPTION`. If a specific user's license lacks the underlying entitlement, the assignment surfaces that same exception so the operator can move the user to a profile/license that carries it.

That custom-permission-set warning does **not** mean assigning the existing Salesforce-shipped `ContactCenterSupervisor` set removes access or rewrites the set. This skill only creates a missing `PermissionSetAssignment`; it never creates, edits, or replaces the permission set itself.

## Inputs

```bash
bash scripts/verify-and-assign.sh <org-alias> [count=1] [permission-set-names-csv=ContactCenterSupervisor]
```

- `org-alias` (required).
- `count` (optional, default `1`, range `1..5`) — must match the supervisor user count.
- `permission-set-names-csv` (optional, default `ContactCenterSupervisor`) — comma-separated for multiple. Every supervisor gets every listed set (cross-product).

## Preconditions and safety

- Target org authenticated via `sf` CLI, Service Cloud license, `sf` CLI ≥ 2.139.6.
- The supervisor users exist and are active; fewer than `count` active users blocks with a remediation message.
- The `ContactCenterSupervisor` set is Salesforce-shipped and present on any Service-Cloud-enabled org; a custom name that is missing blocks with a Setup click-path.
- The executing user has `PermissionsAssignPermissionSets` (standard on System Administrator) — required even for org admins.
- The three-way `safe_to_write` production guard applies — assigning permission sets on a production org can escalate a real user's privileges, so it blocks with no override.

## Run

`verify-and-assign.sh` performs the whole cycle:

1. Compute `safe_to_write`; derive the 8-char org suffix.
2. Validate every supplied permission-set name as a well-formed DeveloperName (SOQL-injection guard) before any `sf` call.
3. Resolve the `supervisor{1..N}.<suffix>@example.com` users, filtered to `IsActive=true`; block if fewer than `count` are active (an inactive occupant does not satisfy the count).
4. Resolve each `PermissionSet` by name; block naming which is missing.
5. Query existing `PermissionSetAssignment` for the (user × set) cross-product; compute the missing pairs.
6. POST one assignment per missing pair (individual POSTs, no `allOrNone`); treat `DUPLICATE_VALUE` as reused.
7. Re-query to confirm final state and emit the report.

## Behavior

**Cross-product.** Every supervisor gets every listed set; a partial assignment is a failure, not a feature.

**Idempotency.** `PermissionSetAssignment` has a uniqueness constraint on (AssigneeId, PermissionSetId), so a re-POST raises `DUPLICATE_VALUE`; the skill detects existing pairs first and treats that as reused for concurrent-run safety. POSTs are individual so one error never rolls back its siblings, and it re-queries after all POSTs — a 201 only means the write was accepted; a SOQL confirms it is active.

**Non-destructive.** Create-only; it never deletes existing assignments (supervisors may hold out-of-band permissions) and derives users from the supervisor pattern rather than an explicit id list.

## Output contract

A single JSON object with `status` ∈ `assigned` | `reused` | `partial` | `blocked`, the resolved `permission_sets`, `org_suffix`, `requested_count`, `expected_assignment_count` (= `requested_count × len(permission_sets)`), a `before` snapshot, `assigned_this_run`/`assigned_count`, `reused_count`, an `after` snapshot, `manual_actions`, and `blocking_issue`.

- `assigned` — at least one new assignment created; all expected pairs exist after.
- `reused` — all expected pairs already existed; nothing POSTed.
- `partial` — some POSTs failed; final count is below expected.
- `blocked` — precondition failed (production org, missing set, missing/inactive users, or a license that does not allow the permission).

`assigned_count + reused_count == expected_assignment_count` unless `partial`; `blocking_issue` is non-null only for `blocked`/`partial`.

## Limitations

- Provisioning the user license that the supervisor permset requires is the users-create skill's responsibility, not this one.
- Assigns individual PermissionSets only — a `PermissionSetGroup` is a different sObject and is out of scope.
- Create-only; it does not remove assignments.

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | Before the POST loop — PermissionSetAssignment schema, `DUPLICATE_VALUE` semantics, and why users are derived from the supervisor pattern rather than an explicit id list |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
salesforce-automation davepoon Скилл salesforce-automation для Claude Code автоматизирует работу с Salesforce через Composio. Создаёт и ищет лиды, контакты, аккаунты и сделки, выполняет SOQL-запросы. CX Codex +1 128установок salesforce-flow-design официальный github Скилл salesforce-flow-design проверяет архитектуру Salesforce Flow: выбор типа, bulk-безопасность и обработку ошибок. Подходит для проектирования и ревью Flow перед активацией. CX Codex +1 839установок Salesforce Apex & Triggers Development официальный github Субагент Salesforce Apex & Triggers Development генерирует надёжный Apex-код и триггеры для Salesforce с учётом лимитов платформы. Субагент проверяет архитектуру проекта, избегает догадок и сразу пишет тесты. CX Codex +1 ★ 41 430звёзд репо enterprise-integration-architect Alysson Franklin Субагент enterprise-integration-architect проектирует B2B-интеграции с корпоративными платформами вроде Salesforce, SAP и Microsoft 365. Помогает настроить обмен данными, авторизацию и обработку лимитов API. CX Codex ★ 1 013звёзд репо enterprise-integrator-architect Alysson Franklin Плагин enterprise-integrator-architect для Claude Code проектирует и реализует интеграции B2B-приложений с внешними корпоративными системами. Вызывается для настройки API, синхронизации данных и вебхуков сторонних сервисов. ★ 1 013звёзд репо crm-integration-wasp-drone Legion Code Inc. Субагент crm-integration-wasp-drone проектирует архитектуру интеграции с CRM, схему полей и двусторонний обмен данными. Помогает связать сервис с HubSpot, Salesforce, Attio или Pipedrive без потери записей. CX Codex ★ 96звёзд репо

Из того же набора232

Весь набор →
service-omni-presence-status-deploy Скилл service-omni-presence-status-deploy для Claude Code развёртывает статусы доступности Omni-Channel. Запускается при настройке Available-статусов для Case, Incident, Messaging или Voice и стандартного Busy. CX Codex +1 103установок service-omni-base-settings-configure Скилл service-omni-base-settings-configure для Claude Code и других ассистентов настраивает базовые параметры Omni-Channel в Salesforce через Metadata API. Включает пять главных флагов маршрутизации перед созданием очередей. CX Codex +1 103установок service-omni-supervisor-surface-deploy Скилл service-omni-supervisor-surface-deploy для Claude Code заполняет интерфейс Omni-Channel Supervisor в Salesforce стандартными кнопками и вкладками через Data API. Запускается при настройке панели супервизора. CX Codex +1 102установок service-omni-supervisor-users-create Скилл service-omni-supervisor-users-create для Claude Code создаёт учётные записи супервайзеров Omni-Channel в Salesforce. Запускается по запросу создать или подготовить таких пользователей. CX Codex +1 102установок service-omni-presence-user-config-deploy Скилл service-omni-presence-user-config-deploy для Claude Code разворачивает конфигурацию присутствия Omni для агентов. Он включает отказ от работы с причиной и таймер ACW, затем назначает конфигурацию пользователям. CX Codex +1 102установок service-omni-agent-users-create Скилл service-omni-agent-users-create для Claude Code создаёт пользователей-агентов Salesforce для настройки Omni-Channel и проверки маршрутизации. Запускается по запросам на создание или восстановление тестовых агентов. CX Codex +1 101установок education-cloud-domain-configure Скилл education-cloud-domain-configure для Claude Code настраивает домены Education Cloud в Salesforce через диалог. Запускается, когда нужно включить функции домена. CX Codex +1 100установок service-agentforce-contact-center-coordinate Скилл service-agentforce-contact-center-coordinate для Claude Code автоматизирует настройку голосового канала Agentforce Contact Center. Запускается при запросе на создание голосового канала и подключение агента. CX Codex +1 100установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой