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

plan-attest — команда для Claude Code: что делает и как установить

Команда plan-attest фиксирует содержимое task_plan.md с помощью хэша SHA-256. Хуки блокируют инъекцию плана в модель, если файл изменился без повторного подтверждения.

MIT ★ 28 179 обновлён 2026-11-04

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

Что делает plan-attest

Команда передаёт выполнение скрипту attest-plan.sh или attest-plan.ps1 из репозитория planning-with-files и сохраняет контрольную сумму текущего плана. Вызов самой языковой модели для этой операции отключён. Функция появилась в релизе v2.37.0.

После фиксации хуки UserPromptSubmit и PreToolUse сверяют task_plan.md с сохранённым значением. При расхождении хук выводит [PLAN TAMPERED — injection blocked] вместо передачи плана в контекст сессии.

В PowerShell работают флаги -Show и -Clear, но параметра -Target нет. Если скрипт обнаружит несколько активных планов, он откажется выбирать автоматически и потребует точный PLAN_ID.

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

  • Защитить task_plan.md от несанкционированных правок во время сессии
  • Заблокировать подачу изменённого плана в промпты и вызовы инструментов
  • Проверить сохранённый хэш плана и путь к файлу фиксации
  • Снять блокировку плана для внесения изменений

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

  • /plan-attest
  • /plan-attest --show
  • /plan-attest --clear

Как установить plan-attest

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

/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

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

.claude/commands/plan-attest.md

Вызов — /plan-attest. Для всех проектов — ~/.claude/commands/

Вопросы о plan-attest

Как установить plan-attest в Claude Code?

Выполните в терминале /plugin marketplace add OthmanAdi/planning-with-files, а затем запустите /plugin install planning-with-files@planning-with-files. Также файл команды можно сохранить в .claude/commands/plan-attest.md.

Что делает команда plan-attest?

Она вычисляет SHA-256 хэш для текущего task_plan.md и сохраняет его. До повторного подтверждения хуки сверяют файл с этим слепком при каждом сообщении.

Что произойдёт, если изменить task_plan.md после фиксации?

Хуки зафиксируют несовпадение контрольной суммы и выдадут [PLAN TAMPERED — injection blocked]. Чтобы продолжить работу с новым содержимым, запустите /plan-attest заново или снимите защиту через /plan-attest --clear.

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

plan-attest.md · MIT
---
description: "Lock the current task_plan.md content with a SHA-256 attestation. Hooks then refuse to inject plan content if the file diverges from the attested hash, blocking silent tampering. Use --show to print the stored hash, --clear to remove the attestation. Available since v2.37.0."
disable-model-invocation: true
allowed-tools: "Bash"
---

Run the plan attestation helper for the active plan.

Steps:
1. Forward the requested operation to the installed helper: `--show` or `--clear` for `attest-plan.sh`, `-Show` or `-Clear` for `attest-plan.ps1`, or no flag to attest.
2. Let that helper resolve the selected plan and storage path. Do not reproduce its selection logic or write an attestation manually.
3. If it reports an invalid explicit selector or multiple named plans, stop and ask for the exact `PLAN_ID`; do not substitute another task.
4. Report the helper's result and storage path to the user, including `Multiple plans are available` when it refuses ambiguity. The shared pointer does not bind a parallel session.

An explicit `${PLAN_ID}` or `${PWF_PLAN_ROOT}` that does not resolve exits with an error. It never falls back to another plan.

Implementation:
- On Linux/macOS/Git Bash: `sh ${CLAUDE_PLUGIN_ROOT}/scripts/attest-plan.sh`
- On Windows PowerShell plugin installs: `& "$env:CLAUDE_PLUGIN_ROOT\scripts\attest-plan.ps1"`
- On Windows PowerShell standalone installs: `& "$env:USERPROFILE\.claude\skills\planning-with-files\scripts\attest-plan.ps1"`

Flags:
- `--show` — print the currently stored hash and where it lives.
- `--clear` — remove the attestation (re-open the plan to free editing).
- Shell `--target root` or `--target <plan-id>` selects an explicit attestation target for this call; forward it when requested. PowerShell has `-Show` and `-Clear`, but no `-Target` parameter.

After running an attestation, every UserPromptSubmit and PreToolUse hook fire compares `task_plan.md` against the stored hash. If they diverge, the hook emits `[PLAN TAMPERED — injection blocked]` instead of feeding plan content into the model. Re-run `/plan-attest` whenever you intentionally edit and re-approve the plan.

© OthmanAdi · MIT · OthmanAdi/planning-with-files

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
speckit.plan Chat2AnyLLM Команда speckit.plan запускает процесс проектирования архитектуры фичи и генерирует проектные артефакты в репозитории. CX Codex +1 ★ 117звёзд репо task_plan_withdraw nwverse Субагент task_plan_withdraw для Claude Code снимает с ожидания план, который ещё не начали. Он срабатывает, когда план этой беседы больше не нужен. CX Codex ★ 395звёзд репо edge-ai-tasks официальный Awesome Copilot Community Плагин edge-ai-tasks для GitHub Copilot исследует проект и планирует задачи реализации. Он предназначен для работы с крупными кодовыми базами и рассчитан на пользователей среднего и экспертного уровня. ★ 41 430звёзд репо oma-pm First Fluke Скилл oma-pm для Claude Code и Codex декомпозирует требования к продукту в дерево задач с зависимостями и критериями приёмки. Готовит артефакты планирования для субагентов и оркестратора. CX Codex +1 ★ 1 472звёзд репо careful garrytan Скилл careful для Claude Code ставит хук, который проверяет команды Bash и PowerShell до запуска. На каждый rm -rf, DROP TABLE или git push --force агент спрашивает подтверждение. CX Codex +1 417установок nightshift Orwa Mahmoud Хук nightshift для Claude Code и Codex организует сессии Codex с ограничением времени, списком задач, фиксацией отложенных решений и историей запусков. CX Codex ★ 1 596звёзд репо

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

Весь набор →
pwf Команда pwf запускает рабочий процесс planning-with-files: создаёт план задачи, файл находок и файл прогресса для текущего проекта. CX Codex +1 ★ 28 179звёзд репо status Команда status показывает текущую фазу проекта, процент готовности и ошибки из task_plan.md. Команда запускается для быстрой проверки прогресса без перечитывания всех рабочих файлов. CX Codex +1 ★ 28 179звёзд репо plan-doctor Команда plan-doctor проверяет, не молчат ли хуки planning-with-files: находится ли план, срабатывает ли инжект, в каком состоянии аттестация. Запускайте, когда хуки притихли. CX Codex +1 ★ 28 179звёзд репо plan-goal Команда plan-goal собирает условие завершения из task_plan.md и подставляет его в /goal, чтобы агент не остановился на середине плана. CX Codex +1 ★ 28 179звёзд репо plan-loop Команда plan-loop для Claude Code запускает регулярные проверки через /loop и отслеживает файлы плана. Автоматизирует работу по фазам без ручного контроля. CX Codex +1 ★ 28 179звёзд репо planning-with-files Скилл planning-with-files держит план многошаговой задачи в трёх markdown-файлах и возвращает к ним агента каждый ход — контекст не разваливается на длинной сессии. CX Codex +1 ★ 28 179звёзд репо planning-with-files Скилл planning-with-files сохраняет план задач, ход работы и находки в markdown-файлах проекта. Выручает в длинных задачах от пяти вызовов инструментов, защищая контекст от стирания. CX Codex +1 ★ 28 179звёзд репо planning-with-files Скилл planning-with-files для Claude Code и Codex, который сохраняет план, находки и журнал сессии в файлы на диске. При следующем запуске агент читает task_plan.md, findings.md и progress.md и продолжает с того места, где остановился. CX Codex +1 ★ 28 179звёзд репо

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

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