fix-codesign-error — команда для Codex: разбор ошибок подписи macOS
Разбирает сбой подписи или entitlements на macOS и показывает минимальный путь починки. Пригодится, когда сборка не запускается или не проходит проверку.
~/.codex/prompts/fix-codesign-error.mdЧто делает fix-codesign-error
Команда смотрит на .app-бандл, исполняемый файл, данные подписи и entitlements. Дальше определяет класс проблемы: identity, provisioning, hardened runtime, sandboxing или trust policy. Вы получаете объяснение обычными словами и последовательность команд для починки либо проверки.
Аргументы необязательные: app — путь к бандлу или бинарнику, identity — подсказка по идентичности подписи, mode — inspect или repair-plan. По умолчанию стоит inspect, то есть сначала только диагностика, без правок.
Внутри есть ограничения, и они полезные. Entitlements команда читает из бинарника или исходников, а не придумывает. Локальные проблемы разработки она отделяет от сбоев распространения и нотаризации. Для проверки берёт codesign -d, spctl и plutil вместо догадок. Если у вас сломался именно локальный запуск, а не релизная сборка, это повод сразу указать mode как repair-plan.
Какие задачи решает
- понять, почему
.appне запускается после сборки - отличить проблему подписи от сбоя нотаризации
- прочитать entitlements из бинарника, а не угадывать их
- получить минимальную последовательность команд для починки
- проверить подпись через
codesign -dиspctl
Примеры запросов агенту
- /fix-codesign-error app=build/MyApp.app
- /fix-codesign-error app=build/MyApp.app mode=repair-plan
- /fix-codesign-error app=build/MyApp.app identity="Developer ID Application"
Как установить fix-codesign-error
Вручную: положить файлы
~/.codex/prompts/fix-codesign-error.mdВызов — /prompts:fix-codesign-error. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.claude/commands/fix-codesign-error.mdВызов — /fix-codesign-error. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
.github/prompts/fix-codesign-error.prompt.mdВручную: положить файлы
.gemini/commands/fix-codesign-error.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о fix-codesign-error
Как установить fix-codesign-error в Claude?
Положите файл промпта по пути ~/.codex/prompts/fix-codesign-error.md.
Что делает fix-codesign-error?
Проверяет бандл, бинарник, подпись и entitlements, называет класс сбоя и даёт минимальный набор команд для исправления или проверки.
Какие аргументы принимает команда?
app с путём к бандлу или бинарнику, identity как подсказку по подписи и mode со значениями inspect или repair-plan. Без аргументов работает в режиме inspect.
Исходный текст
fix-codesign-error.md · MIT
# /fix-codesign-error Inspect a macOS signing or entitlement failure and explain the minimum fix path. ## Arguments - `app`: path to `.app` bundle or binary (optional) - `identity`: signing identity hint (optional) - `mode`: `inspect` or `repair-plan` (optional, default: `inspect`) ## Workflow 1. Inspect the app bundle, executable, signing info, and entitlements. 2. Determine whether the problem is identity, provisioning, hardened runtime, sandboxing, or trust policy. 3. Summarize the exact failure class in plain language. 4. Provide the minimal repair sequence or validation command. ## Guardrails - Never invent entitlements; read them from the binary or source files. - Distinguish local development signing problems from distribution or notarization failures. - Prefer verifiable commands like `codesign -d`, `spctl`, and `plutil` over guesswork.
© OpenAI · MIT · openai/plugins
