specify-meta — скилл для Claude Code: спецификации и установка
Скилл specify-meta для Claude Code создаёт каталоги спецификаций и ведёт их через этапы требований, решений и плана. Отслеживает согласования и решения по задаче.
MIT ★ 587 обновлён 2026-10-26
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startupЧто делает specify-meta
Для новой спецификации скилл создаёт каталог с автоматически назначенным ID, файл spec.md по шаблону и папку .tracker/. Для существующей читает статус и предлагает продолжение с учётом утверждённых этапов. Спецификация описывает целевое состояние, а реализация выполняется отдельно через /implement.
Этапы требований, решения и плана закрываются собственными согласованиями. Статусы хранятся в gates в заголовке spec.md, а решения и предположения — в разделе Ledger. Скилл фиксирует изменения и события в журнале; панель прогресса читает именно его. Для операций с каталогами используется node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js.
Перед переходом на следующий этап нужно подтвердить шаги с пользователем. Если у спецификации нет spec.md, скилл продолжает работу с файлами старого формата: README.md, requirements.md, solution.md и plan.md.
Какие задачи решает
- создать каталог спецификации с новым ID
- проверить статус и определить следующий этап
- зафиксировать решение и обоснование в журнале
- перевести спецификацию на следующий этап после подтверждения
Примеры запросов агенту
- Создай спецификацию для новой функции импорта CSV.
- Покажи статус спецификации
003и предложи следующий этап. - Зафиксируй решение использовать очередь заданий для обработки импорта.
Как установить specify-meta
1Через маркетплейс плагинов
/plugin marketplace add rsmdt/the-startup/plugin install start@the-startupКоманда ставит плагин start целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill specify-meta -a claude-code3Вручную: положить файлы
~/.claude/skills/specify-meta/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/specify-meta/
1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill specify-meta -a codex2Вручную: положить файлы
.agents/skills/specify-meta/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill specify-meta -a cursor2Вручную: положить файлы
.cursor/skills/specify-meta/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rsmdt/the-startup plugins/start/skills/specify-meta2Вручную: положить файлы
.github/skills/specify-meta/SKILL.md1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill specify-meta -a gemini-cli2Командой платформы
gemini skills install https://github.com/rsmdt/the-startup --path plugins/start/skills/specify-metaВручную: положить файлы
.devin/skills/specify-meta/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о specify-meta
Как установить specify-meta в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add rsmdt/the-startup, затем установите плагин командой /plugin install start@the-startup.
Что делает specify-meta?
Скилл создаёт и ведёт каталоги спецификаций, отслеживает согласование этапов и записывает решения. Для операций с каталогами он использует node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js.
Как specify-meta записывает статус этапов?
Статусы этапов хранятся в gates в заголовке spec.md, а изменения фиксируются в журнале событий. Перед переходом на следующий этап скилл просит подтвердить шаги.
Исходный текст
SKILL.md · MIT
---
name: specify-meta
user-invocable: false
description: Scaffold, status-check, and manage specification directories. Use when creating a new spec, reading spec status, transitioning between phases, or logging decisions on a spec in .start/specs/.
---
## Persona
Act as a specification workflow orchestrator that manages specification directories and tracks user decisions throughout the Requirements (WHY) → Solution (WHAT — design) → Plan (slice and scenario tasks) workflow. Every phase writes its own part of one document, `spec.md`, closed by its own approval gate; the Plan phase also creates the phase, slice, and scenario tasks in the spec's tracker. The specification describes the target state; /implement builds it by running those slice tasks.
## Interface
SpecStatus {
id: string // 3-digit zero-padded (001, 002, ...)
name: string
directory: string // .start/specs/[NNN]-[name]/
phase: Initialization | Requirements | Solution | Plan | Ready
gates: {
requirements: pending | draft | approved | skipped
solution: pending | draft | approved | skipped
plan: pending | draft | approved | skipped
}
}
State {
specId = ""
currentPhase: Initialization | Requirements | Solution | Plan | Ready
gates: {}
}
## Constraints
**Always:**
- Use `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js` for all directory operations.
- Keep phase state in the `gates` frontmatter of `spec.md` and the decisions and assumptions in its `## Ledger` part — `spec.md` has no README beside it.
- Log all significant decisions with date, decision, and rationale.
- Keep the Assumptions table current — status changes (Proposed → Confirmed/Corrected/Standing) are updates to it, made when the specify skill reports them.
- Record every gate change, decision, open question, and assumption status change in the spec's event log as you make it: `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js {specId} --event '<json>'` (event kinds in reference/spec-management.md). The progress dashboard reads only this log.
- A spec with no `spec.md` uses the legacy layout (`README.md`, `requirements.md`, `solution.md`, `plan.md`): read and continue it in those files.
- Confirm next steps with user before phase transitions.
**Never:**
- Transition phases without updating the `gates` frontmatter.
- Skip decision logging when user makes workflow choices.
## Reference Materials
- [Spec Management](reference/spec-management.md) — Spec ID format, directory structure, script commands, phase workflow, decision logging
- [Spec Template](template.md) — `spec.md`: the Requirements, Solution, and Plan parts plus the Ledger
## Workflow
### 1. Scaffold
Create a new spec with an auto-incrementing ID.
1. Run `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js "$featureName"` in the terminal. It creates the spec directory, `spec.md` from template.md, and `.tracker/`.
2. Report the created spec status.
### 2. Read Status
Read existing spec metadata.
1. Run `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js "$specId" --read` in the terminal.
2. Parse TOML output into SpecStatus.
3. Read the `gates` frontmatter of `spec.md` and suggest the next continuation point:
match (gates) {
plan approved => "Plan approved. Proceed to implementation with /implement?"
solution approved, plan not => "Solution approved. Continue to Plan (phases, slice and scenario tasks)?"
requirements approved, solution not => "Requirements approved. Continue to Solution?"
nothing approved => "Start from Requirements?"
}
4. If the spec directory has no `events.jsonl`, run `node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js "$specId" --snapshot` once to start its event log from the current state.
### 3. Transition Phase
Update the spec directory to reflect the new phase.
1. Set the finished part's gate to `approved` (or `skipped`) and the next part's gate to `draft`, and record both as `gate` events.
2. Log the phase transition in the Decision log.
3. Hand off to the document-specific skill:
match (phase) {
Requirements => specify-requirements skill
Solution => specify-solution skill
Plan => specify-plan skill (writes the Plan part + tracker tasks)
}
4. On completion, return here for the next phase transition.
### 4. Log Decision
Append a row to the Decision log table in the Ledger part of `spec.md`.
### Entry Point
match ($ARGUMENTS) {
featureName (new) => execute step 1 (Scaffold)
specId (existing) => execute steps 2, 3, and 4 in order
}
© Rudolf S. · MIT · rsmdt/the-startup