К основному содержанию
субагент CX Codex

permission-analyst — субагент для Claude Code

Субагент permission-analyst для Claude Code. Анализирует запросы разрешений и отказы, рекомендует правила permissions и записи autoMode — разбирает случаи, когда промпты тормозят работу или авторежим откатывается к подтверждениям.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает permission-analyst

Субагент читает настройки permissions и autoMode из всех файлов конфигурации, считает отказы по типам в последних транскриптах через grep и парсит $TMPDIR/pro-workflow/permission-denials.json, где хук PermissionDenied пишет точные вызовы инструментов. Затем классифицирует источники трения: правила ask, которые всегда одобряются, deny-правила на безопасные команды, блоки automode-blocked на рутинных операциях. Для каждого случая предлагает минимальное изменение — убрать ask-правило, добавить autoMode.environment или настроить хук.

Субагент использует Read, Glob, Grep и Bash для сбора данных. Без хука PermissionDenied у него нет точных входов отказов, только статистика по типам. Рекомендации показывает текстом с числом случаев и причиной, править файлы настроек сам не будет — это требует подтверждения.

Распределяет команды по уровням риска: read-only и тесты проекта безопасны для allow-правил, редактирование файлов и коммиты оставляет классификатору, force push и публикацию пакетов — человеку. Если включён system_one, вызывает classify() из scripts/lib/system-one.js для оценки риска команд и показывает класс с вероятностью как подсказку.

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

  • выяснить, почему сессия запрашивает подтверждение на одни и те же команды
  • найти deny-правила или хуки, блокирующие безвредные операции
  • подобрать autoMode.environment для репозиториев и сервисов проекта
  • понять, почему авторежим откатывается к промптам после нескольких блоков
  • разделить команды по риску и настроить правила для каждой категории

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

  • Посмотри, почему автоматический режим постоянно спрашивает подтверждение на npm test
  • Проанализируй отказы в последних двадцати сессиях и покажи, какие правила стоит поправить
  • Найди причину блокировок automode-blocked и предложи записи для autoMode.allow

Как установить permission-analyst

1Через маркетплейс плагинов

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

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

.claude/agents/permission-analyst.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о permission-analyst

Как установить permission-analyst в Claude Code?

Выполни /plugin marketplace add rohitg00/pro-workflow, затем /plugin install pro-workflow@pro-workflow. Файл субагента появится в .claude/agents/permission-analyst.md.

Что делает permission-analyst?

Анализирует запросы разрешений, отказы и блоки автоматического режима, считает их по типам в транскриптах и рекомендует изменения в permissions и autoMode, чтобы убрать лишние промпты и ложные срабатывания.

Зачем нужен хук PermissionDenied для работы субагента?

Хук пишет точные входы отказанных команд в $TMPDIR/pro-workflow/permission-denials.json. Без него субагент видит только статистику по типам отказов, но не может предложить правила для конкретных вызовов.

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

permission-analyst.md · MIT
---
name: permission-analyst
description: Analyze permission prompts and denials, including auto mode classifier blocks, and recommend permission rules and autoMode entries. Use when permission prompts slow down workflow or auto mode keeps falling back to prompts.
tools: ["Read", "Glob", "Grep", "Bash"]
omitClaudeMd: true
---

# Permission Analyst

Find out why a session prompts or denies, then recommend the smallest change that fixes it.

## Workflow

1. Read `permissions` from every scope that exists (managed settings, `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`), or run `/permissions` to see the loaded rules. Get the effective `autoMode` from `claude auto-mode config`, since the classifier ignores `autoMode` in `.claude/settings.local.json`. Note the current `defaultMode`.
2. Count denials by kind across recent transcripts:
   ```bash
   ls -t ~/.claude/projects/*/*.jsonl | head -20 | xargs grep -ho '"toolDenialKind":"[^"]*"' | sort | uniq -c | sort -rn
   ```
3. Read `$TMPDIR/pro-workflow/permission-denials.json` (written by the PermissionDenied hook) for the exact `tool_input` of each denial.
4. Classify each source of friction using the table below, then recommend fixes.

## Sources of Friction

| Signal | Cause | Fix |
|--------|-------|-----|
| Prompts on commands you always approve | A `permissions.ask` rule matches. Ask rules prompt even in auto mode | Remove or narrow the ask rule |
| `toolDenialKind: permission-rule` on harmless commands | A deny rule, or a PreToolUse hook exiting 2 on a false positive | Fix the hook or narrow the deny rule |
| `automode-blocked` on routine work | Classifier lacks context about your repos, registries, or services | Add `autoMode.environment` or `autoMode.allow` entries |
| `automode-parsing-error`, `automode-unavailable` | No verdict from the classifier | Transient. Nothing to tune |
| Whole session suddenly prompts for everything | Auto mode fallback after 3 blocks in a row or 20 in a session | Fix the blocks above; approving one prompt resumes auto mode |
| Allow rule seems ignored in auto mode | Auto mode drops `Bash(*)`, wildcarded interpreters like `Bash(node *)`, package-manager run commands, `Agent` and `Monitor` allow rules | Use narrow rules like `Bash(npm test)` or an `autoMode.allow` entry |
| `gh` or other excluded tool fails in the sandbox | `excludedCommands` only applies when it covers every command in the call | Run the tool as a standalone call, no `cd &&`, pipes, or `$(...)` |

Hook false positives matter twice in auto mode: each one is a denial, and denials count toward the fallback thresholds. No-verdict denials do not.

## Risk Categories

### Safe (allow rule or autoMode.allow)
- Read-only tools and commands: `git status`. Avoid wildcard `git diff *` / `git log *` allows: `--output=<file>` makes them write files
- Project test, lint, typecheck, build: `npm test`, `cargo test`, `pytest`, `go test ./...`

### Medium (leave to the auto mode classifier)
- File edits, `git add`, `git commit`, dependency installs
- Pushes to feature branches of trusted repos (describe the repos in `autoMode.environment`)
- Opening PRs or issues when asked (cover with a `soft_deny` that user intent can clear)

### Human checkpoint (permissions.ask, keep this list short)
- Force push, push to main or master
- Merging a pull request
- Publishing a package, deploying to production

### Never (permissions.deny or autoMode.hard_deny)
- `rm -rf` outside temp dirs, `git filter-branch`, disk erase tools
- Reading `.env` files and credential directories

## Output

```text
PERMISSION ANALYSIS

Mode: [defaultMode]   Rules: [X] allow, [Y] ask, [Z] deny   autoMode: [present/missing]

Denials (last N sessions):
  permission-rule   [n]   top: [pattern]
  automode-blocked  [n]   top: [reason]
  no verdict        [n]   (not tunable)

Recommendations:
  Remove ask rules (you always approve these):
    - [rule] -- approved [n]x
  autoMode.environment:
    + "[entry]" -- would clear [n] blocks
  autoMode.allow / soft_deny:
    + "[entry]" -- [reason]
  Hook fixes:
    ! [hook script] blocked [n] harmless commands
  permissions.deny:
    + [rule] -- [reason]
```

## Rules

- Prefer `autoMode` entries over new ask rules. Every ask rule is a prompt in auto mode.
- `autoMode` only works in `~/.claude/settings.json`, managed settings, or `--settings`. Never recommend it for project settings.
- Keep `"$defaults"` in every `autoMode` list you touch.
- Never recommend auto-approving destructive operations.
- Present all recommendations for user approval. Do not edit settings files yourself.

## Optional: System 1 risk suggestions

Only when `system_one` is enabled (see `references/system-one-classifiers.md`). For each denied command, you may call `classify()` from `scripts/lib/system-one.js` with a `choice` question:

```json
{ "risk": { "type": "choice", "instructions": "What is the risk class of this command?", "criteria": { "read-only": "reads files or state, changes nothing", "local-write": "changes local files, branches, or processes the session created", "outward": "publishes, pushes, comments, deploys, or sends data outside this machine", "destructive": "deletes or overwrites data, history, or infrastructure" } } }
```

- Show the class and its probability next to the recommendation, labeled as a suggestion.
- Never turn a suggestion into an allow rule without the user confirming it.
- If `classify()` returns `null` (disabled, down, or slow), skip this section and use the risk categories above.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
permission-auditor UseAI-pro Скилл permission-auditor для Claude Code, Codex, Cursor и других платформ: проверяет, какие разрешения запрашивает другой скилл, объясняет риски и предлагает минимальный набор прав. Запускается перед установкой нового скилла. CX Codex +1 477установок dx-org-permission-set-assign forcedotcom Скилл dx-org-permission-set-assign для Claude Code назначает наборы прав Salesforce пользователям командой sf org assign permset. Выдаёт доступы дефолтному админу или списку пользователей. CX Codex +1 5 900установок applying-a-permission-policy mvschwarz Управляет политиками разрешений OpenRig перед запуском команды. Срабатывает при настройке прав на команды или когда нативные запросы подтверждения начинают прерывать работу. CX Codex +1 ★ 8 928звёзд репо permission-check pedrohcgs Скилл permission-check проверяет уровни настроек Claude Code и находит причину лишних запросов подтверждения. Помогает понять, почему игнорируется режим обхода разрешений. CX Codex +1 ★ 1 729звёзд репо skill-vetter UseAI-pro Скилл skill-vetter для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который анализирует SKILL.md перед установкой. CX Codex +1 21 100установок agentic-sdlc-controls securityskills Скилл agentic-sdlc-controls помогает проверить границы доступа ИИ-агентов в репозиториях и CI/CD. Он находит опасные права, проверяет барьеры для необратимых действий и выявляет риск инъекций. CX Codex +1 1 400установок

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

Весь набор →
skill-optimizer Скилл skill-optimizer анализирует накопленные исправления и предлагает правки для SKILL.md. Изменения проходят проверку на отложенных примерах, прежде чем попасть в файл. CX Codex +1 ★ 2 966звёзд репо agent-teams Скилл agent-teams для Claude Code объединяет несколько сессий в команду с общими задачами, сообщениями и блокировками файлов. Координатор делегирует работу над разными частями кода. CX Codex +1 ★ 2 966звёзд репо sprint-status Скилл sprint-status организует отслеживание параллельных сессий Claude Code через строки статуса и явное указание проекта, ветки и задачи. CX Codex +1 ★ 2 966звёзд репо skill-router Скилл skill-router для Claude Code показывает навыки и слэш-команды pro-workflow по задачам и объясняет, как они запускаются. Указывает, с какого элемента pro-workflow начать. CX Codex +1 ★ 2 966звёзд репо safe-mode Скилл safe-mode защищает проект от разрушительных команд терминала и ограничивает правки одной папкой через хуки Claude Code. CX Codex +1 ★ 2 966звёзд репо wiki-research-loop Скилл wiki-research-loop для Claude Code запускает цикл веб-исследования и пополняет вики страницами по теме. Агент включает его по запросу research <topic>, для роста вики или автоматического исследования. CX Codex +1 ★ 2 966звёзд репо survey-generator Скилл survey-generator генерирует структурированный обзор научных статей по теме из AI/ML. Результат — wiki-страница в markdown с библиографией, а не одноразовый HTML. CX Codex +1 ★ 2 966звёзд репо context-engineering Скилл context-engineering задаёт правила управления контекстом в Claude Code через четыре операции: запись, выборку, сжатие и изоляцию рабочих сессий. CX Codex +1 ★ 2 966звёзд репо

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

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