Документация
Spec-Flow
echoVic/spec-flowClaude Code скилл для структурированной разработки по спецификациям. Превращает сложные фичи в управляемый пятиэтапный процесс: Proposal → Requirements → Design → Tasks → Implementation. Создаёт живую документацию в `.spec-flow/`, поддерживает командную работу через Git.
Установка
terminal
bash
git clone https://github.com/echoVic/spec-flow.gitREADME
Spec-Flow
Рабочий процесс разработки по спецификациям для AI-агентов
Spec-Flow превращает разработку сложных фич в управляемый пошаговый процесс с живой документацией. Работает с любым AI-агентом, поддерживающим формат Skills.
Возможности
- Пошаговый процесс: Proposal → Requirements → Design → Tasks → Implementation
- Интерактивное подтверждение: каждый этап ожидает вашего одобрения перед продолжением
- Живая документация: создаёт директорию
.spec-flow/с Markdown-документами, которые сопровождают реализацию - Требования в формате EARS: отраслевой стандарт Easy Approach to Requirements Syntax
- 3 режима выполнения: Step (по умолчанию), Batch, Phase — выбирайте удобный темп
- Командная работа: Git-совместимые спецификации, которые можно коммитить вместе с проектом
Установка
bash
# Claude Code
cd ~/.claude/skills && git clone https://github.com/echoVic/spec-flow.git
# OpenClaw
cd ~/.openclaw/workspace/skills && git clone https://github.com/echoVic/spec-flow.git
# Blade
cd ~/.blade/skills && git clone https://github.com/echoVic/spec-flow.git
# Или директория skills любого другого агентаБыстрый старт
Запускается по ключевым словам: spec-flow, spec mode, need a plan, structured development, 写个方案, 做个规划
Пользователь: spec-flow — добавить аутентификацию пользователей
AI: [Создаёт proposal.md] → ожидает подтверждения
Пользователь: continue
AI: [Создаёт requirements.md] → ожидает подтверждения
Пользователь: continue
AI: [Создаёт design.md] → ожидает подтверждения
Пользователь: continue
AI: [Создаёт tasks.md] → ожидает подтверждения
Пользователь: execute all tasks
AI: [Реализует всё]
Параметры: --fast (пропустить подтверждения), --skip-design (для простых фич)
Пятиэтапный процесс
┌──────────┐ ┌──────────────┐ ┌────────┐ ┌───────┐ ┌────────────────┐
│ Proposal │ → │ Requirements │ → │ Design │ → │ Tasks │ → │ Implementation │
└──────────┘ └──────────────┘ └────────┘ └───────┘ └────────────────┘
ЗАЧЕМ ЧТО КАК ВЫПОЛНИТЬ ПОСТРОИТЬ
| Этап | Цель | Результат |
|---|---|---|
| Proposal | Определить ЗАЧЕМ | Контекст, цели, ограничения, риски |
| Requirements | Определить ЧТО | FR/NFR в формате EARS, критерии приёмки |
| Design | Определить КАК | Архитектура, API, модель данных (Mermaid) |
| Tasks | Декомпозиция | Детальные задачи с зависимостями |
| Implementation | Реализация | Код, тесты, документация |
Режимы выполнения
| Режим | Триггер | Поведение |
|---|---|---|
| Step (по умолчанию) | start implementation | Одна задача → подтверждение → следующая |
| Batch | execute all / 全部执行 | Все задачи последовательно |
| Phase | execute setup phase | Все задачи одного этапа → подтверждение |
Структура директорий
.spec-flow/
├── steering/ # Опционально: глобальный контекст проекта
│ ├── constitution.md
│ ├── product.md
│ ├── tech.md
│ └── structure.md
├── active/ # Текущие задачи
│ └── <feature>/
│ ├── proposal.md
│ ├── requirements.md
│ ├── design.md
│ └── tasks.md
└── archive/ # Завершённые фичи
Структура файлов скилла
spec-flow/
├── SKILL.md # Чеклист процесса
├── references/
│ ├── ears-format.md # Синтаксис требований EARS
│ ├── task-decomposition.md # Паттерны декомпозиции задач
│ ├── workflow.md # Подробное руководство по процессу
│ ├── interaction-rules.md # Правила подтверждений
│ ├── execution-modes.md # Режимы Step/Batch/Phase
│ └── examples/
├── templates/ # Шаблоны документов
│ ├── proposal.md.template
│ ├── requirements.md.template
│ ├── design.md.template
│ ├── tasks.md.template
│ └── steering/
└── scripts/
├── init-spec-flow.sh # Инициализация директории spec
├── validate-spec-flow.py # Проверка полноты документации
└── execute-task.sh # Выполнение задачи
Язык
- Инструкции процесса: английский
- Генерируемые документы: китайский (中文) по умолчанию
Лицензия
MIT