sf-permissions

このスキルは、ユーザーが権限の分析とアクセス監査を必要とする場合に使用します：Permission Set / Permission Set Group の階層ビュー、「誰が X にアクセスできるのか？」の調査、ユーザー権限の分析、またはパーミッションセットメタデータのレビュー。

このスキルがタスクを担当する場合

以下の作業が含まれる場合は sf-permissions を使用します：

• permission set / permission set group の分析
• ユーザーアクセスの調査
• どの権限が object / field / Apex / flow / tab / custom permission へのアクセスを付与しているかの確認
• 権限設定の監査またはエクスポート
• 権限メタデータの影響をレビュー

ユーザーが以下を行う場合は他へ委譲します：

• 新しいメタデータ定義を作成 → sf-metadata
• permission sets をデプロイ → sf-deploy
• Apex マネージド共有ロジックを分析 → sf-apex

---

最初に収集すべき必須コンテキスト

以下を確認または推測します：

• 対象の org のエイリアス
• 質問が object、field、Apex class、flow、tab、custom permission、または特定のユーザーについてのものであるかどうか
• ゴールが階層ビジュアライゼーション、アクセス検出、エクスポート、またはメタデータ生成であるかどうか
• 出力がターミナル中心か、ドキュメント中心かどうか

---

推奨ワークフロー

1. リクエストを分類する

リクエストの形式	デフォルト機能
「誰が X にアクセスできるのか？」	permission detector
「このユーザーは何を持っているのか？」	user analyzer
「階層を表示してください」	hierarchy viewer
「このパーミッションセットをエクスポート」	exporter
「分析からメタデータを生成」	generator または委譲

2. 正しい org に接続する

権限分析を実行する前に sf auth を確認します。

3. 最も適切なクエリを使用する

ユーザーが明確に全体監査を望まない限り、広い org 全体のスキャンより焦点を絞った分析を優先します。

識別子を選ぶ際は、安定したメタデータ名を最優先します：

• PermissionSet.Name
• PermissionSetGroup.DeveloperName
• CustomPermission.DeveloperName
• Account や Account.AnnualRevenue などの object および field API 名
• ユーザー中心のチェック用の Assignee.Username / メール

Salesforce record ID は以下の場合のみ使用します：

• 基になるオブジェクトモデルが ParentId または SetupEntityId を必要とする場合、または
• 同じ調査内での先行する読み取り専用クエリから返されたレコードをドリルダウンする場合

4. 結果を明確にレンダリング

以下を使用します：

• ターミナルの作業用に ASCII ツリーまたはテーブル出力
• ドキュメント上の利点が明らかな場合のみ Mermaid
• どの権限ソースがアクセスを付与するかの簡潔なサマリー

5. 作成またはデプロイメント作業を委譲する

以下を使用します：

• sf-metadata より豊かなメタデータ生成用
• sf-deploy デプロイメント用

---

高信号ルール

• Permission Set Group 経由の権限付与から直接 Permission Set の権限付与を区別する
• 最初のパス調査クエリでは、org 固有の record ID より Name / DeveloperName / API 名を優先する
• アクセスが object レベル、field レベル、class レベル、flow レベル、または custom permission ベースであるかについて明示的である
• setup entities と高度な可視性質問に必要な場合は Tooling API を使用する
• エージェントアクセスの質問については、権限メタデータで正確なエージェント名マッチングを確認する
• フォローアップの子クエリが ParentId または SetupEntityId を必要とする場合、コピーした ID で始める代わりに先行する結果から ID を解決する

---

出力形式

完了時は、この順序で報告します：

1. 何を分析したか
2. Org / 対象のスコープ
3. どの権限がアクセスを付与するか
4. アクセスが直接か継承されているか
5. 推奨される次のステップ

提案される形式：

Permission analysis: <hierarchy / detect / user / export>
Scope: <org, user, permission target>
Findings: <permsets / groups / access level>
Source: <direct assignment or via group>
Next step: <export, generate metadata, or deploy changes>

---

クロススキル統合

必要な作業	委譲先	理由
権限メタデータの生成または変更	sf-metadata	メタデータ作成
権限変更のデプロイ	sf-deploy	ロールアウト
権限が必要な Apex classes の特定	sf-apex	実装コンテキスト
大規模ユーザー割当分析	sf-data	より大きなデータ操作

---

リファレンスマップ

ここから始める

• references/permission-model.md
• references/soql-reference.md
• references/workflow-examples.md

特別な分析

• references/agent-access-guide.md
• references/usage-examples.md

---

スコアガイド

スコア	意味
90+	明確なアクセスソースを伴う強力な権限分析
75–89	軽微なギャップを伴う有用な監査
60–74	部分的な可視性のみ
< 60	十分な証拠なし；分析を拡張する