speckit.companion.living-coverage — команда для Claude Code
Команда speckit.companion.living-coverage проверяет, какие требования живой спецификации имеют закреплённые за ними тесты, а какие остаются без покрытия. Работает в режиме только для чтения и никогда не блокирует конвейер.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/speckit.companion.living-coverage.mdЧто делает speckit.companion.living-coverage
Команда читает файлы спецификации (.spec.md) и карту покрытия (.coverage.md) для каждого компонента, извлекает идентификаторы требований (вроде FR-NNN или NFR-NNN) и ищет их в карте покрытия. Если требование упомянуто в строке, где назван хотя бы один тест (путь вида .test.* или .spec.*, ссылка на tests/... или nodeid типа file::TestCase), оно считается закрытым; иначе — открытым. Требует Python 3: если python3 недоступен, команда выдаст предупреждение и завершится без ошибки.
Это сигнал, а не преграда. Если требование не покрыто, можно либо добавить тест и обновить карту, либо принять пробел. Команда не влияет на статус конвейера и работает параллельно с другими проверками.
Какие задачи решает
- найти требования спецификации без закреплённых тестов
- обновить карту покрытия требований для компонента
- проверить конкретный компонент на полноту покрытия тестами
- экспортировать отчёт о покрытии в машиночитаемом формате
Примеры запросов агенту
- Покажи покрытие требований по всем компонентам
- Проверь, какие требования в компоненте billing не имеют тестов
- Выведи отчёт о покрытии в JSON
Как установить speckit.companion.living-coverage
Вручную: положить файлы
.claude/commands/speckit.companion.living-coverage.mdВызов — /speckit.companion.living-coverage. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/speckit.companion.living-coverage.mdВызов — /prompts:speckit.companion.living-coverage. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/speckit.companion.living-coverage.prompt.mdВручную: положить файлы
.gemini/commands/speckit.companion.living-coverage.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о speckit.companion.living-coverage
Как установить speckit.companion.living-coverage в Claude Code?
Добавь файл speckit.companion.living-coverage.md в папку .claude/commands/ репозитория.
Что делает speckit.companion.living-coverage?
Проверяет для каждого требования живой спецификации, есть ли в карте покрытия закреплённый за ним тест. Выводит список требований с тестами и без.
Почему команда не работает, если нет файла .coverage.md?
Это нормально: все требования компонента будут показаны как открытые. Ошибки не будет — команда всегда завершается успешно.
Исходный текст
speckit.companion.living-coverage.md · MIT
--- description: "Report living-spec requirement→test coverage — per requirement, whether its coverage tier maps a test (opt-in, read-only, never halts)" --- # Spec Coverage Show, for each living-spec capability, which of its requirements have a test mapped in the capability's coverage-tier sibling (the `*.coverage.md` next to its spec — `spec.coverage.md` for a centralized `capabilities/<name>/<name>.spec.md`, or `<base>.coverage.md` for a colocated spec) and which are still uncovered. A living spec's requirements file says **what** the area must do; its coverage tier says **which test proves each one**. This command reads both and reports the gap. **Read-only** — it never edits anything — and it **never fails** (always exits success). It's the conformance on-ramp, a signal you act on, not a gate that blocks you (the same contract as `speckit.companion.living-drift`). This is **opt-in**. With living specs disabled (or no config), it reports nothing and exits clean. A capability that ships only a `.spec.md` with no `.coverage.md` sibling reports every requirement uncovered — never an error. ## 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 coverage`. Do not fail the host command. ## Execution Run the coverage checker from the repository root: ```bash python3 .specify/extensions/companion/scripts/check-coverage.py ``` The script reads the capability registry (`living-specs.yml`), reuses the resolver for the capability and tier paths, extracts each requirement id (`FR-NNN` / `NFR-NNN`) from the capability's `.spec.md`, and looks each id up in its `.coverage.md` map. A requirement is **covered** when its id appears in the coverage file on a line that also names at least one test (a `.test.` / `.spec.` path, a `tests/...` reference, or a `file::TestCase` nodeid); otherwise it's **uncovered**. Restrict to one capability by name, or get a machine-readable object: ```bash python3 .specify/extensions/companion/scripts/check-coverage.py --capability billing python3 .specify/extensions/companion/scripts/check-coverage.py --json ``` ## What to do with the report Coverage is a signal, not an error. For each uncovered requirement, either add a test and map it in the capability's `.coverage.md`, or accept the gap for now. The command never blocks the pipeline on its own.
© alfredoperez · MIT · alfredoperez/speckit-companion