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

service-omni-permission-set-assign — скилл для Claude Code

Скилл service-omni-permission-set-assign для Claude Code назначает агентам наборы разрешений Omni. Запускается по просьбе выдать доступ к Omni-Channel или исправить назначения для виджета Omni.

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

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

Что делает service-omni-permission-set-assign

Скилл находит пользователей-агентов и назначает им наборы разрешений через PermissionSetAssignment. По умолчанию это Omni_Agent: скилл проверяет существующие назначения и создаёт только недостающие, затем повторно сверяет результат. Он работает с отдельными PermissionSet, а не с PermissionSetGroup, и не удаляет уже выданные права.

Нужны аутентифицированная целевая org, лицензия Service Cloud, sf CLI версии не ниже 2.139.6, jq версии не ниже 1.6 и право PermissionsAssignPermissionSets у запускающего пользователя. Пользователи-агенты должны быть созданы заранее; перед самовосстановлением Omni_Agent нужен хотя бы один статус присутствия Omni, который развёртывает связанный скилл service-omni-presence-status-deploy.

Назначения в production org блокируются без возможности обхода: выдача прав может повысить привилегии реального пользователя. Автоматическое развёртывание касается только встроенного Omni_Agent; другие наборы должны уже существовать. Скилл ставит назначения отдельными запросами и подтверждает их повторным запросом к Salesforce.

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

  • выдать агентам доступ к виджету Omni
  • добавить агентам разрешения Omni-Channel
  • найти и создать недостающие назначения Omni_Agent
  • назначить несколько наборов разрешений всем агентам

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

  • Назначь Omni_Agent трём созданным агентам.
  • Исправь назначения разрешений Omni для агентов и выдай им доступ к Omni-Channel.
  • Подготовь агентов к работе с виджетом Omni, назначив Omni_Agent.

Как установить service-omni-permission-set-assign

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-permission-set-assign -a claude-code

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

~/.claude/skills/service-omni-permission-set-assign/SKILL.md

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

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

Вопросы о service-omni-permission-set-assign

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

Выполни npx skills add forcedotcom/sf-skills --skill service-omni-permission-set-assign -a claude-code. Файл скилла находится по пути ~/.claude/skills/service-omni-permission-set-assign/SKILL.md.

Что делает service-omni-permission-set-assign?

Скилл назначает агентам Omni_Agent или другие существующие PermissionSet, пропуская уже выданные права. После отправки запросов он сверяет назначения через Salesforce.

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

Нужны аутентифицированная org с лицензией Service Cloud, sf CLI версии 2.139.6 или выше, jq версии 1.6 или выше и право PermissionsAssignPermissionSets. Пользователи-агенты и хотя бы один статус присутствия Omni должны существовать заранее.

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

SKILL.md · Apache-2.0
---
name: service-omni-permission-set-assign
description: "Assign the required Omni permission sets to provisioned agent users. TRIGGER when users ask to assign Omni permissions to agents, grant Omni-Channel access, add Omni_Agent permissions, repair missing Omni permission assignments, or prepare agents to use the Omni widget. DO NOT TRIGGER for arbitrary permission-set authoring, agent creation, or queue membership."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-agent-users-create"
    - "service-omni-presence-status-deploy"
    - "service-omni-queue-members-assign"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-permission-set-assign

Assign one or more PermissionSets to N agent users via `PermissionSetAssignment` Data API POSTs. The default target is `Omni_Agent`, the permission set granting the OmniChannel widget, presence-status access, and demo-queue visibility — without an assignment row, agents cannot open the widget or receive routed work. Detection is SOQL-based, so the skill only creates the assignments that are missing. Agent users come from `service-omni-agent-users-create`, and it runs alongside `service-omni-presence-status-deploy` so assigned agents can both open the widget and select a status.

## Inputs

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

- `org-alias` (required).
- `count` (optional, default `3`, range `1..10`) — must match the agent user count.
- `permission-set-names-csv` (optional, default `Omni_Agent`) — comma-separated for multiple. Every user gets every listed set (cross-product): `count=3` × 2 sets = up to 6 assignments.

## Preconditions and safety

- Target org authenticated via `sf` CLI, Service Cloud license, `sf` CLI ≥ 2.139.6.
- The agent users exist (`service-omni-agent-users-create`); a count mismatch blocks with a pointer back to that skill.
- The executing user has `PermissionsAssignPermissionSets` (standard on System Administrator) — required even for org admins; `ModifyAllData` alone is insufficient.
- At least one Omni presence status exists before `Omni_Agent` self-heals — the bundled set grants agent capability via `servicePresenceStatusAccesses` for whichever curated statuses exist (e.g. `Available_Case`/`Available_Voice` + `Busy`), generated at deploy time. Run `service-omni-presence-status-deploy` first; the coordinator sequences presence before permset for this reason.
- The three-way `safe_to_write` guard applies — assigning permission sets on a production org can escalate a real user's privileges, so it blocks with no override.

**Self-heal (run mode only).** When the default `Omni_Agent` set is absent, the skill deploys the bundled `Omni_Agent` metadata once, then assigns. In `--plan` mode it never deploys — it reports `action_needed` and exits read-only. This covers only the bundled `Omni_Agent` asset; any other permission set must already exist or the run blocks with a click-path.

## Run

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

1. Compute `safe_to_write`; derive the 8-char org suffix.
2. Resolve the agent users by the `agent{1..N}.<suffix>@example.com` pattern; block if any are missing.
3. Resolve each `PermissionSet` by name; self-heal `Omni_Agent` if absent, else block naming which is missing.
4. Query existing `PermissionSetAssignment` for the (user × set) cross-product; compute the missing pairs.
5. POST one assignment per missing pair (individual POSTs, no `allOrNone`).
6. Re-query to confirm final state and emit the report.

## Behavior

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

**Idempotency.** `PermissionSetAssignment` has a database uniqueness constraint on (AssigneeId, PermissionSetId), so a re-POST raises `DUPLICATE_VALUE`; the skill detects existing pairs first and treats `DUPLICATE_VALUE` as a safety net for concurrent races. It POSTs individually so one duplicate or error never rolls back its successful siblings, and it re-queries after all POSTs — a 201 only means Salesforce accepted the write; a subsequent SOQL confirms the assignment is active.

**Non-destructive.** The skill is create-only; it never deletes existing assignments (users may hold out-of-band permissions from other admins) and derives users from the agent pattern rather than accepting an explicit user-id list, so it never assigns demo permissions to real named users.

## 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 users, missing permissions).

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

## Limitations

- Assigns individual PermissionSets only — a `PermissionSetGroup` is a different sObject and is out of scope.
- Self-heal covers only the bundled `Omni_Agent`; it is not a general-purpose permission-set authoring surface.
- Create-only; it does not remove assignments.

## References

| File | When to read |
|---|---|
| `assets/package.xml` | Load when the default `Omni_Agent` permission set is missing and the run-mode self-heal path must deploy the bundled metadata |
| `references/api-notes.md` | Before the POST loop — PermissionSetAssignment schema, its `DUPLICATE_VALUE` semantics, and why users are derived from the agent pattern rather than an explicit id list |

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

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

Каталог скиллов SKILL.md →
permission-auditor UseAI-pro Скилл permission-auditor для Claude Code, Codex, Cursor и других платформ: проверяет, какие разрешения запрашивает другой скилл, объясняет риски и предлагает минимальный набор прав. Запускается перед установкой нового скилла. CX Codex +1 477установок terraform-azurerm-set-diff-analyzer официальный github Скилл terraform-azurerm-set-diff-analyzer разбирает JSON-план Terraform для AzureRM и отделяет перестановку элементов Set от реальных изменений ресурсов. Нужен при ревью шумных diff. CX Codex +1 8 900установок icon-set-generator jezweb Скилл icon-set-generator для Claude Code генерирует для проекта набор SVG-иконок в едином стиле, на общей сетке и с одинаковым штрихом. CX Codex +1 2 000установок assign-offline-profile Microsoft Скилл assign-offline-profile привязывает пользователей и команды к профилю Mobile Offline в Dataverse, чтобы включить офлайн-синхронизацию в мобильных приложениях. CX Codex +1 ★ 1 167звёзд репо assign-unowned-contacts tomgranot Скилл assign-unowned-contacts для Claude Code и Codex, проставляет владельца маркетинговым контактам HubSpot без владельца. Контакты без владельца получают рассылки, но их ответы никто не видит и не появляются в отчётах. CX Codex +1 ★ 81звёзд репо jetson-set-target Jetson Team Скилл jetson-set-target меняет активную целевую плату Jetson на уже готовый профиль из target-platform/. Нужен перед настройкой клоков, nvpmodel, вентилятора или памяти. CX Codex +1 1 100установок

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

Весь набор →
platform-metadata-discovery-get Скилл platform-metadata-discovery-get для Claude Code выясняет, какие метаданные уже есть в Salesforce org. Он подключается перед изменением метаданных или написанием кода, который на них ссылается. CX Codex +1 107установок service-omni-service-channel-configure Скилл service-omni-service-channel-configure для Claude Code находит или создаёт ServiceChannel для Case, Incident, MessagingSession или VoiceCall. Запускается при настройке Omni-Channel. CX Codex +1 106установок service-omni-queue-members-assign Скилл service-omni-queue-members-assign для Claude Code привязывает агентов к очередям Salesforce через Data API. Наполняет очереди Case и Voice участниками для распределения нагрузки в Omni-Channel. CX Codex +1 106установок service-omni-skills-based-routing-configure Скилл service-omni-skills-based-routing-configure для Claude Code связывает Omni Skill с активными пользователями агентов. Запускается при настройке маршрутизации Omni по навыкам. CX Codex +1 106установок service-omni-supervisor-config-deploy Скилл service-omni-supervisor-config-deploy для Claude Code разворачивает конфигурацию классического Omni-Channel Supervisor в Salesforce. Запускается по просьбе настроить Omni Supervisor или Supervisor Command Center. CX Codex +1 104установок service-omni-sidebar-configure Скилл service-omni-sidebar-configure для Claude Code включает и проверяет боковую панель Omni-Channel в консольных приложениях Lightning. Активирует закреплённую область оператора через метаданные CustomApplication. CX Codex +1 103установок 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установок

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

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