speckit.companion.living-show — команда для Claude Code: установка
Команда speckit.companion.living-show для Claude Code показывает часть living spec: заголовки требований, одно требование целиком или правила для файла. Она запускается, когда нужно найти конкретное правило, не открывая весь документ.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/speckit.companion.living-show.mdЧто делает speckit.companion.living-show
Команда запускает скрипт, который читает living spec и выводит выбранный фрагмент. Режим --headings перечисляет заголовки требований возможности, --requirement печатает одно требование со сценариями, а --file находит требования, описывающие исходный файл. Результат передаётся без пересказа и обрезки; команда ничего не редактирует.
Для работы нужны включённые living specs и Python 3. Без конфигурации команда завершается без вывода. Скрипт запускается из корня репозитория по пути .specify/extensions/companion/scripts/resolve-spec-paths.py; --json возвращает объект вместо списка.
Какие задачи решает
- найти заголовки требований одной возможности
- прочитать требование вместе со сценариями
- выяснить, какие правила описывают исходный файл
Примеры запросов агенту
- Покажи заголовки требований возможности
billing. - Выведи требование «Refunds are recorded» вместе со сценариями.
- Найди правила, описывающие файл
src/billing.ts.
Как установить speckit.companion.living-show
Вручную: положить файлы
.claude/commands/speckit.companion.living-show.mdВызов — /speckit.companion.living-show. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/speckit.companion.living-show.mdВызов — /prompts:speckit.companion.living-show. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/speckit.companion.living-show.prompt.mdВручную: положить файлы
.gemini/commands/speckit.companion.living-show.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о speckit.companion.living-show
Как установить speckit.companion.living-show в Claude Code?
Скопируй файл команды в .claude/commands/speckit.companion.living-show.md.
Что делает speckit.companion.living-show?
Печатает выбранную часть living spec: заголовки требований, полное требование со сценариями или правила для указанного файла. Спецификации остаются без изменений.
Что нужно для работы speckit.companion.living-show?
Нужны Python 3 и включённые living specs. Скрипт запускается из корня репозитория.
Исходный текст
speckit.companion.living-show.md · MIT
--- description: "Print one slice of a living spec — a capability's requirement headings, one requirement in full, or the requirements that describe one file (opt-in, read-only, never halts)" --- # Show Print part of a living spec instead of opening it. A capability's spec runs to hundreds of lines, and almost every question about one is about a single requirement: what does it say, what are its scenarios, which rules describe this file I am editing. This is the terminal twin of the load steps' selective read — same parser, same counts, no viewer required. **Read-only** — it never edits anything, and it **never fails** (always exits success). Every unanswerable question is an answer: an unregistered capability, a missing spec file, a name that matches nothing, a file nothing claims. 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 the living spec slice`. ## Execution Run one of these from the repository root, whichever the request asks for: ```bash # every requirement heading in one capability python3 .specify/extensions/companion/scripts/resolve-spec-paths.py --headings <capability> # one requirement in full, including its scenarios python3 .specify/extensions/companion/scripts/resolve-spec-paths.py --requirement "<heading>" # the requirements that describe one source file python3 .specify/extensions/companion/scripts/resolve-spec-paths.py --file <path> ``` Add `--capability <name>` to `--requirement` to search one capability instead of all of them. Add `--json` when a caller needs the object rather than the list. ## What each mode answers | Mode | Answers | |---|---| | `--headings` | What rules does this capability state? One heading per line, in file order, with the count. | | `--requirement` | What does this one rule say, and how would anyone know it held? The heading, the normative prose, and the scenarios. | | `--file` | Which durable rules describe this file? Grouped by capability, most-specific capability first. | A requirement carrying no file marker is returned by `--file` for every file its capability claims — a marker can only narrow, never starve. ## Report Relay the script's own output. Do not summarize a requirement, paraphrase a scenario, or truncate a body: the point of the command is that a reader sees the spec's own words. Where the script reports that a capability is unregistered, has no spec file on disk, or that a name matched nothing, say that in the same terms and print the alternatives it listed. Do **not** edit any spec as part of this command.
© alfredoperez · MIT · alfredoperez/speckit-companion