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

speckit.companion.living-drift — команда для Claude Code

Команда speckit.companion.living-drift показывает, какие файлы возможностей living spec изменились с момента последнего коммита их спецификаций. Помогает найти изменения, которые не попали обратно в спецификацию.

MIT ★ 110 обновлён 2026-10-19

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/speckit.companion.living-drift.md
Открыть на GitHub

Что делает speckit.companion.living-drift

Команда сравнивает файлы каждой возможности из реестра living-specs.yml с последним коммитом её спецификации и классифицирует расхождения. tracked означает, что файл прошёл через Companion, но изменение не внесли в living spec; unspeced — файл менялся вне этого процесса. Пути из списка exempt отфильтровываются.

Отчёт только для чтения: команда не меняет файлы и всегда завершается с кодом 0. По умолчанию она проверяет историю коммитов; флаг --working добавляет незакоммиченные изменения, удаления и новые файлы, а --json выдаёт машиночитаемый результат. Если living specs отключены или конфигурации нет, команда ничего не сообщает. Нужен Python 3: без python3 проверка пропускается, поэтому сначала проверьте его наличие.

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

  • найти файлы, изменённые после коммита спецификации
  • отличить пропущенную синхронизацию от изменений вне Companion
  • проверить незакоммиченные изменения вместе с историей коммитов
  • передать отчёт о расхождениях в формате JSON инструментам или CI

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

  • Проверь, какие файлы разошлись с living specs.
  • Учти незакоммиченные изменения и покажи расхождения.
  • Выведи результат проверки living specs в формате JSON.

Как установить speckit.companion.living-drift

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

.claude/commands/speckit.companion.living-drift.md

Вызов — /speckit.companion.living-drift. Для всех проектов — ~/.claude/commands/

Вопросы о speckit.companion.living-drift

Как установить speckit.companion.living-drift в Claude Code?

Добавьте файл команды в .claude/commands/speckit.companion.living-drift.md.

Что делает speckit.companion.living-drift?

Команда находит изменённые файлы по каждой возможности living spec и сообщает, как возникло расхождение. Она ничего не редактирует и не останавливает процесс.

Нужен ли Python для работы команды?

Да, требуется python3. Если он недоступен, проверка пропускается; команда хоста не завершается с ошибкой.

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

speckit.companion.living-drift.md · MIT
---
description: "Report living-spec drift — per capability, the source files changed since the spec was last committed (opt-in, never halts)"
---

# Spec Drift

Show, for each living-spec capability, the source files that changed since that capability's spec was last committed — and **how** each one slipped. A living spec only stays honest if changes to its area flow back into it; this command surfaces the ones that didn't. **Read-only** — it never edits anything, and it **never fails** (always exits success). A surrounding workflow or CI may treat findings as a gate; the command itself does not.

This is **opt-in**. With living specs disabled (or no config), it reports nothing and exits clean.

## Prerequisites

- Verify Python is available by running `python3 --version`.
- If `python3` is not available, warn the user and skip:
  `[companion] Warning: python3 not detected; skipped drift`.
  Do not fail the host command.

## Execution

Run the drift detector from the repository root:

```bash
python3 .specify/extensions/companion/scripts/drift.py
```

The script reads the capability registry (`living-specs.yml`), reuses the
resolver for capability membership, and uses git to find what changed since each
capability's `capabilities/<name>/<name>.spec.md` was last committed. Each drifted file
is classified:

- **`tracked`** — the file went through the Companion pipeline (it appears in a
  `specs/*/.spec-context.json` changed set) but was never folded back into the
  living spec → a missed sync.
- **`unspeced`** — the file changed entirely outside the pipeline; the living spec
  never saw it. The more concerning of the two.

Files matching any glob in the registry's `exempt` list (default `*.config.*`, `*.test.*`, `**/migrations/**`) are filtered out. A capability whose spec is not yet committed is skipped with an informational note, and the run ends on a counts line — e.g. `0 checked, 2 skipped (spec.md not yet committed)` — so a check that examined nothing never reads as clean. The `✓ All N checked capabilities in sync.` line is reserved for a run that checked at least one capability and found it clean.

Add `--working` (opt-in) to also see the **working tree**: uncommitted edits, deletions, and untracked files then count as drift alongside the committed history. The contract is unchanged — same checked/skipped counts semantics, same never-fails exit `0` — and without the flag the report reads committed history only, exactly as before:

```bash
python3 .specify/extensions/companion/scripts/drift.py --working
```

Add `--json` for a machine-readable object (used by tooling/CI). It carries a `checked` count alongside the `capabilities` and `skipped` lists, so a caller can tell "clean" from "did not run" — the exit code stays `0` either way — plus a `working` boolean naming which mode produced it:

```bash
python3 .specify/extensions/companion/scripts/drift.py --json
```

## What to do with the report

Drift is a signal, not an error. To fold the reported changes back in one pass, run `speckit.companion.living-sync` — the write-side twin of this report (it consumes the same `--working` computation). Otherwise, for each `unspeced` or `tracked` row, either fold the change into the living spec by hand (e.g. run `speckit.companion.living-adopt` for the area, or write a delta spec) or add the path to the registry's `exempt` list if it shouldn't be tracked. The command never blocks the pipeline on its own.

© alfredoperez · MIT · alfredoperez/speckit-companion

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

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
speckit.implement Chat2AnyLLM Команда speckit.implement выполняет задачи из tasks.md, сверяясь с планом и проектными документами. Она пригодится, когда нужно пройти план реализации по шагам. CX Codex +1 ★ 117звёзд репо speckit-analyze github-spec-kit Скилл speckit-analyze для Claude Code проводит анализ согласованности файлов spec.md, plan.md и tasks.md. Запускается строго в режиме чтения перед началом кодинга. CX Codex +1 1 600установок speckit.specify Chat2AnyLLM Команда speckit.specify для Claude Code генерирует или обновляет спецификацию функциональности по текстовому описанию задачи. Структурирует требования до написания кода. CX Codex +1 ★ 117звёзд репо docs-drift-editor VoltAgent Community Субагент docs-drift-editor обновляет Markdown-страницы, которые разошлись с кодом, и не выдумывает команды и ссылки, которых нет в диффе. CX Codex ★ 26 718звёзд репо launchdarkly-flag-drift launchdarkly Скилл launchdarkly-flag-drift для Claude Code выявляет расхождения между запасным значением флага в коде и правилом по умолчанию в LaunchDarkly. Помогает обновить дефолтные аргументы SDK без удаления проверок флага. CX Codex +1 259установок speckit-taskstoissues github-spec-kit Скилл speckit-taskstoissues превращает задачи из tasks.md в issues GitHub с учётом зависимостей. Скилл помечен как устаревший — есть замена в виде расширения. CX Codex +1 1 600установок

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

Весь набор →
speckit.plan Промпт speckit.plan запускает процесс планирования реализации по спецификации: собирает research.md, data-model.md и схемы API в папку contracts/. CX Codex GP ChatGPT ★ 110звёзд репо sandbox Команда sandbox создаёт временный SpecKit-проект по рецепту или показывает доступные рецепты и уже созданные песочницы. Работает в Claude Code и Codex. CX Codex +1 ★ 110звёзд репо release-qa Команда release-qa для Claude Code проверяет код перед выпуском: сравнивает его с последним тегом версии, запускает тесты и ручные проверки, пишет отчёт с вердиктом ship или fix-first. Блокирует /publish до прохождения проверок. CX Codex +1 ★ 110звёзд репо install-local Команда install-local собирает и ставит локальные версии расширений VS Code и spec-kit из репозитория speckit-companion, автоматически повышая patch-версию для сброса кэша. CX Codex +1 ★ 110звёзд репо speckit.companion.resume Команда speckit.companion.resume для Claude Code восстанавливает состояние spec-driven разработки после перерыва. Она переносит записанные решения в контекст и запускает следующий шаг пайплайна. CX Codex +1 ★ 110звёзд репо speckit.git.commit Команда speckit.git.commit для Claude Code добавляет изменения в индекс Git и создаёт коммит после команд Spec Kit по настройкам конфигурации проекта. CX Codex +1 ★ 110звёзд репо speckit-git-commit Скилл speckit-git-commit автоматически добавляет и коммитит изменения после команд Spec Kit. Он пригодится, когда историю Git нужно обновлять через настройки проекта. CX Codex +1 ★ 110звёзд репо bench-capture Команда bench-capture для Claude Code и Codex, которая фиксирует результаты трёх ячеек бенчмарка после прохода по одному размеру, добавляет их в историю, перестраивает отчёт и очищает ячейки для следующего раунда. CX Codex +1 ★ 110звёзд репо

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

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