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

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

Команда speckit.companion.living-coverage проверяет, какие требования живой спецификации имеют закреплённые за ними тесты, а какие остаются без покрытия. Работает в режиме только для чтения и никогда не блокирует конвейер.

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

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

Что делает 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/

Вопросы о 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

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

Все слэш-команды по теме «Тесты и QA» →
speckit-analyze github-spec-kit Скилл speckit-analyze для Claude Code проводит анализ согласованности файлов spec.md, plan.md и tasks.md. Запускается строго в режиме чтения перед началом кодинга. CX Codex +1 1 600установок qe-coverage-analysis proffesor-for-testing Скилл qe-coverage-analysis разбирает отчёты Istanbul, c8 и lcov, выявляя пробелы в тестах с учётом критичности кода. Помогает приоритизировать покрытие и блокировать проблемные PR. CX Codex +1 127установок meticulous-increase-coverage alwaysmeticulous Скилл meticulous-increase-coverage для Meticulous: находит файлы без покрытия, привязывает их к реальному действию в интерфейсе и подтверждает рост покрытия сравнением с базой. CX Codex +1 3 000установок test-coverage cognitedata Скилл test-coverage находит пробелы в покрытии тестами приложения на Flows и закрывает их: настраивает инструменты, пишет недостающие тесты, правит код ради тестируемости. CX Codex +1 1 900установок coverage-analysis kindlmann Скилл coverage-analysis для Claude Code разбирает отчёты о покрытии по риску и задаёт порог в CI. На каждом PR проверяет, чтобы покрытие не падало. CX Codex +1 1 400установок dart-collect-coverage dart-lang Скилл dart-collect-coverage настраивает сбор тестового покрытия в проектах на Dart и Flutter через пакет coverage и генерирует отчёт в формате LCOV. Помогает отслеживать метрики тестов. CX Codex +1 20 400установок

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

Весь набор →
speckit.companion.after-specify Команда speckit.companion.after-specify для Claude Code и Codex, которая записывает текущий шаг spec-kit в .spec-context.json для GUI Companion. Запускается из корня репозитория после завершения этапа specify. CX Codex +1 ★ 110звёзд репо speckit.companion.after-implement Команда speckit.companion.after-implement записывает прогресс этапа implement из tasks.md в .spec-context.json для GUI Companion. CX Codex +1 ★ 110звёзд репо speckit.companion.after-tasks Команда speckit.companion.after-tasks фиксирует завершение задач в файле .spec-context.json для Companion GUI. Запускается в корне репозитория после завершения рабочего этапа. CX Codex +1 ★ 110звёзд репо speckit.companion.before-step Команда speckit.companion.before-step записывает начало шага spec-kit в .spec-context.json для Companion GUI. Она нужна перед specify, plan, tasks или implement. CX Codex +1 ★ 110звёзд репо bench-sync Команда bench-sync для Claude Code и Codex, которая запекает ячейки бенчмарка и измеряет текущую версию spec-kit и расширения Companion. Нужна, чтобы отследить, как меняется производительность инструмента при обновлениях. CX Codex +1 ★ 110звёзд репо speckit.companion.living-show Команда speckit.companion.living-show для Claude Code показывает часть living spec: заголовки требований, одно требование целиком или правила для файла. Она запускается, когда нужно найти конкретное правило, не открывая весь документ. CX Codex +1 ★ 110звёзд репо speckit.companion.status Команда speckit.companion.status для Claude Code и Codex показывает шаг, статус, решения и следующее действие активной спеки из .spec-context.json. Она работает только на чтение. CX Codex +1 ★ 110звёзд репо speckit.plan Промпт speckit.plan запускает процесс планирования реализации по спецификации: собирает research.md, data-model.md и схемы API в папку contracts/. CX Codex GP ChatGPT ★ 110звёзд репо

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

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