speq-skill — плагин
speq ведет разработку по спецификациям в Claude Code и Codex: миссия, план, реализация и запись в постоянную библиотеку.
- 54 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установка запускает скрипт из интернета и ставит бинарный файл в домашний каталог.
- Агент пишет и меняет код проекта по спецификациям, результат нужно проверять.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/exasol-labs/speq-skill/main/install.sh | bashСтавит `speq` в `~/.local/bin`, плагин в `~/.speq-skill/` и регистрирует скиллы.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка запускает скрипт из интернета и ставит бинарный файл в домашний каталог.
- Агент пишет и меняет код проекта по спецификациям, результат нужно проверять.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`speq-skill` задает повторяемый цикл «план, реализация, запись» вокруг библиотеки спецификаций. Сначала `/speq:mission` изучает проект и пишет `specs/mission.md` и `specs/architecture.md`. Затем `/speq:plan` читает существующие спецификации, задает уточняющие вопросы и готовит план с дельтами, `/speq:implement` пишет код по правилам качества и тестов, а `/speq:record` вливает дельты в постоянную библиотеку. К скиллам добавлена утилита `speq` на `Rust`: она перечисляет и читает спецификации, чтобы агент брал в контекст только нужные. Для мелких правок есть `/speq:patch` без плана и `/speq:patch-pr` с готовым запросом на слияние. Каждый скилл опирается на смысловые якоря вроде `London School TDD`, `BLUF` и `ADR.`
Для кого. Разработчикам, которые ведут проект с агентом и хотят держать требования в небольших спецификациях, не раздувая контекст.
Подходит, если
- Новый проект начинают с миссии и архитектуры, которые агент собирает в интервью.
- Перед крупной задачей агент читает только нужные спецификации и согласует план.
- После реализации дельты сливаются в постоянную библиотеку требований.
- Мелкую правку выпускают одним запросом на слияние через `/speq:patch-pr`.
Не подходит, если
- Нужен готовый процесс без установки бинарного файла: утилита `speq` ставится в `~/.local/bin`.
- Платформа не из списка `Linux x86_64`, `ARM64` и `macOS` на `Apple Silicon`: сборку придется делать из исходников.
- Требований у проекта нет, а спецификации писать не планируют.
Пример запроса к агенту
Запусти миссию проекта, потом по спецификациям составь план добавления экспорта в `CSV` и задай вопросы, прежде чем писать код.Ограничения
Установщик скачивает готовый бинарный файл для `Linux x86_64`, `ARM64` и `macOS` на `Apple Silicon`, на других платформах останавливается и отсылает к сборке из исходников. Файлы плагина ложатся в `~/.speq-skill/`, а скиллы регистрируются в `Claude Code` и `Codex`, если эти агенты найдены. Спецификации и планы создаются в вашем репозитории и требуют ревью, как любой код. Рабочий цикл рассчитан на агента, который задает вопросы, поэтому в полностью автоматических запусках он будет замедляться.
Как отключить. Следуйте разделу об удалении в `docs/installation.md`: он убирает бинарный файл из `~/.local/bin`, каталог `~/.speq-skill/` и регистрацию скиллов. Каталог `specs/` в проекте удалите сами, если спецификации не нужны.
Частые вопросы
С какой команды начать?
В `Claude Code` с `/speq:mission`, в `Codex` с `$speq:mission`. Команда исследует проект и создает `specs/mission.md`.
Что делает установщик?
Скачивает бинарный файл `speq`, кладет его в `~/.local/bin/speq`, ставит файлы плагина в `~/.speq-skill/` и регистрирует скиллы для `Claude Code` и `Codex.`
Где хранятся спецификации?
В `specs/<домен>/<функция>/spec.md`, архитектура лежит в `specs/architecture.md`, а планы в `specs/_plans/`.
Нужен ли план для мелкой правки?
Нет, `/speq:patch` применяет правку сразу, а `/speq:patch-pr` дополнительно оформляет один готовый запрос на слияние.
Что такое смысловые якоря?
Это названия известных методик, например `London School TDD`, `BLUF` и `ADR.` Скиллы ссылаются на них, чтобы направить агента к описанным практикам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныДва скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам
Скилл расспрашивает про проект и пишет requirements.md, design.md и tasks.md, чтобы Claude Code и Cursor работали по одному плану
Навыки Spec Kit для Claude Code, Codex, Cursor, Copilot и OpenCode: спецификация, план, задачи, реализация и база по готовому коду
CLI spxa и набор скиллов для разработки по спецификациям в Claude Code, Codex и Cursor: от предложения изменения до архива
Плагин для Claude Code: разработка через спецификацию по одному файлу SPEC.md, цикл из семи команд без под-агентов
CLI, MCP-сервер и скилл для разработки по спецификациям: короткие спеки в markdown, доска задач и поиск, понятные агенту.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| speq-skill (эта карточка) | нет | 54 | |
| OpenSpec | нет | 74 686 | различие: `openspec` описывает собственный формат изменений, `speq` держит постоянную библиотеку спецификаций и утилиту на `Rust` |
| Spec Kit | нет | 149 434 | различие: `spec-kit` ведет через этапы `GitHub`, `speq` сжимает цикл до плана, реализации и записи с чтением только нужных спецификаций |
Коротко о README
В README объяснены цикл «миссия, план, реализация, запись», установщик, структура папок `specs/` и команды быстрых правок. Подробности вынесены в каталог `docs/`.