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

flow-next — скилл для Claude Code: задачи и установка

Скилл flow-next для Claude Code управляет задачами и спецификациями в .flow/: показывает списки и статусы, создаёт задачи и закрывает выполненные. Помогает разобраться, что запланировано и готово к работе.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает flow-next

flow-next читает состояние проекта через flowctl: можно вывести спецификации и задачи, отфильтровать их по статусу или спецификации, посмотреть готовые к работе задачи и открыть описание в Markdown. Новые задачи создаются внутри существующей спецификации; для них можно задать описание и критерии приёмки.

Скилл также запускает задачу и закрывает её через flowctl done, передавая сводку и JSON с подтверждениями. Изменять файлы .flow/ вручную нельзя: чтение и запись проходят через команды flowctl. Утилита поставляется внутри скилла, поэтому глобально установленный flowctl не требуется; для планирования и выполнения задач предусмотрены отдельные команды /flow-next:plan и /flow-next:work.

Какие задачи решает

  • показать задачи и спецификации проекта
  • найти задачи по статусу или спецификации
  • проверить, какие задачи готовы к работе
  • создать задачу с описанием и критериями приёмки
  • закрыть задачу со сводкой и подтверждениями

Примеры запросов агенту

  • Покажи все задачи проекта и их статусы.
  • Найди задачи, готовые к работе, в спецификации fn-1-add-oauth.
  • Создай задачу «Исправить вход» в спецификации fn-1-add-oauth.

Как установить flow-next

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

Команда ставит плагин flow-next целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gmickel/flow-next --skill flow-next -a claude-code

3Вручную: положить файлы

~/.claude/skills/flow-next/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flow-next/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flow-next

Как установить flow-next в Claude Code?

Выполните /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next. Это два шага установки через маркетплейс.

Что делает flow-next?

Скилл управляет задачами и спецификациями в .flow/: показывает их, создаёт задачи, запускает и закрывает их через flowctl.

Нужен ли установленный flowctl?

Нет. flowctl входит в состав скилла, а глобальная установка не требуется.

Исходный текст

SKILL.md · MIT
---
name: flow-next
description: "Manage .flow/ tasks and specs. Triggers: 'show me my tasks', 'list specs', 'what tasks are there', 'add a task', 'create task', 'what's ready', 'task status', 'show fn-1-add-oauth'. NOT for /flow-next:plan or /flow-next:work."
---

# Flow-Next Task Management

Quick task operations in `.flow/`. For planning features use `/flow-next:plan`, for executing use `/flow-next:work`.

## Preamble

**CRITICAL: flowctl is BUNDLED — NOT installed globally.** `which flowctl` will fail (expected). Define once; subsequent blocks use `$FLOWCTL`:

```bash
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
```

**Discover all commands/options:**
```bash
$FLOWCTL --help
$FLOWCTL <command> --help   # e.g., $FLOWCTL task --help
```

## Quick Reference

```bash
# Check if .flow exists
$FLOWCTL detect --json

# Initialize (if needed)
$FLOWCTL init --json

# List everything (specs + tasks grouped)
$FLOWCTL list --json

# List all specs
$FLOWCTL specs --json

# List all tasks (or filter by spec/status)
$FLOWCTL tasks --json
$FLOWCTL tasks --spec fn-1-add-oauth --json
$FLOWCTL tasks --status todo --json

# View spec with all tasks
$FLOWCTL show fn-1-add-oauth --json
$FLOWCTL cat fn-1-add-oauth              # Spec markdown

# View single task
$FLOWCTL show fn-1-add-oauth.2 --json
$FLOWCTL cat fn-1-add-oauth.2            # Task spec

# What's ready to work on?
$FLOWCTL ready --spec fn-1-add-oauth --json

# Create task under existing spec
$FLOWCTL task create --spec fn-1-add-oauth --title "Fix bug X" --json

# Set task description and acceptance (combined, fewer writes; unique per-task temp paths)
$FLOWCTL task set-spec fn-1-add-oauth.2 --description "${TMPDIR:-/tmp}/flow-desc-fn-1-add-oauth.2.md" --acceptance "${TMPDIR:-/tmp}/flow-accept-fn-1-add-oauth.2.md" --json

# Or use stdin with heredoc (no temp file):
$FLOWCTL task set-description fn-1-add-oauth.2 --file - --json <<'EOF'
Description here
EOF

# Start working on task
$FLOWCTL start fn-1-add-oauth.2 --json

# Mark task done (unique per-task temp paths)
echo "What was done" > "${TMPDIR:-/tmp}/flow-summary-fn-1-add-oauth.2.md"
echo '{"commits":["abc123"],"tests":["npm test"],"prs":[]}' > "${TMPDIR:-/tmp}/flow-evidence-fn-1-add-oauth.2.json"
$FLOWCTL done fn-1-add-oauth.2 --summary-file "${TMPDIR:-/tmp}/flow-summary-fn-1-add-oauth.2.md" --evidence-json "${TMPDIR:-/tmp}/flow-evidence-fn-1-add-oauth.2.json" --json

# Validate structure (one spec; repo-wide through a counts-and-errors projection)
$FLOWCTL validate --spec fn-1-add-oauth --json
$FLOWCTL validate --all --json | jq '{valid, total_specs, total_tasks, total_errors, total_warnings, root_errors, failing: [.specs[] | select(.errors | length > 0) | {spec, errors}]}'
```

## Common Patterns

### "Add a task for X"

1. Find relevant spec:
   ```bash
   # List all specs
   $FLOWCTL specs --json

   # Or show a specific spec to check its scope
   $FLOWCTL show fn-1 --json
   ```

2. Create task:
   ```bash
   $FLOWCTL task create --spec fn-N --title "Short title" --json
   ```

3. Add description + acceptance (combined):
   ```bash
   # Unique per-task temp paths — written + consumed in this one block
   cat > "${TMPDIR:-/tmp}/flow-desc-fn-N.M.md" << 'EOF'
   **Bug/Feature:** Brief description

   **Details:**
   - Point 1
   - Point 2
   EOF
   cat > "${TMPDIR:-/tmp}/flow-accept-fn-N.M.md" << 'EOF'
   - [ ] Criterion 1
   - [ ] Criterion 2
   EOF
   $FLOWCTL task set-spec fn-N.M --description "${TMPDIR:-/tmp}/flow-desc-fn-N.M.md" --acceptance "${TMPDIR:-/tmp}/flow-accept-fn-N.M.md" --json
   ```

### "What tasks are there?"

```bash
# All tasks, projected (add --spec fn-1-add-oauth for one spec)
$FLOWCTL tasks --json | jq -c '[.tasks[] | {id, title, status, spec}]'

# Ready tasks for a spec
$FLOWCTL ready --spec fn-1-add-oauth --json
```

### "What's next?"

```bash
$FLOWCTL brief
```

`brief` is orientation only: it omits blocked and dependency-waiting tasks, so never answer a task listing from it.

### "Show me task X"

```bash
$FLOWCTL show fn-1-add-oauth.2 --json   # Metadata
$FLOWCTL cat fn-1-add-oauth.2           # Full spec
```

(Legacy `fn-1.2` / `fn-1-xxx.2` still works.)

### Create new spec (rare - usually via /flow-next:plan)

```bash
$FLOWCTL spec create --title "Spec title" --json
# Returns: {"success": true, "id": "fn-N-spec-title", ...}
```

### Close a spec as won't-do

```bash
$FLOWCTL spec close fn-1-add-oauth --retire superseded --by fn-2-sso --json
```

Pick the reason that is true: `superseded` (another spec replaced it), `delivered-elsewhere` (it shipped
under another spec or pull request) or `moot` (it is no longer needed, including a decision not to build
it). Name each successor with `--by`. Its never-run tasks read `retired`, not `done`.

Before closing any spec: read [references/declined.md](references/declined.md); it decides whether the
close earns a `.flow/memory/declined/` file.

## ID Format

- Spec: `fn-N-slug` where slug is derived from title (e.g., `fn-1-add-oauth`, `fn-2-fix-login-bug`)
- Task: `fn-N-slug.M` (e.g., `fn-1-add-oauth.1`, `fn-2-fix-login-bug.2`)

Legacy formats `fn-N` and `fn-N-xxx` (random 3-char suffix) are still supported.

## Notes

- Run `$FLOWCTL --help` to discover all commands and options
- **Every write goes through a flowctl subcommand**, except the `.flow/memory/declined/*.md` file above, which has no flowctl verb. A session that edits `.flow/` JSON or task markdown by hand has broken this.
- **Every read comes from `.flow/` state**, via `--json` (`detect`, `list`, `specs`, `tasks`, `show`, `ready`) or `cat` for markdown. An answer assembled from files skimmed by hand has broken this.
- **A task marked complete is closed with `flowctl done` carrying both `--summary-file` and `--evidence-json`.** A bare status flip has broken this.
- **Requests that need real planning or execution are handed off**, to `flow-next:flow-next-plan` and `flow-next:flow-next-work`. Improvising them here has broken this.

© Gordon Mickel · MIT · gmickel/flow-next

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
om-prepare-issue open-mercato Скилл om-prepare-issue оформляет задачу в трекере по краткому описанию без написания кода. Он находит дубликаты и добавляет план реализации с SDLC-метками. CX Codex +1 3 700установок spec-workflow TencentCloudBase Скилл spec-workflow для Claude Code структурирует разработку средних и крупных задач через артефакты требований, дизайна и плана. Включается перед написанием кода при нечётких критериях приёмки. CX Codex +1 1 200установок plan owainlewis Скилл plan делит спецификацию на законченные вертикальные срезы, каждый из которых агент сдаёт в одном pull request. Срабатывает при планировании крупной задачи перед написанием кода. CX Codex +1 788установок groove-work-spec andreadellacorte Скилл groove-work-spec формирует спецификацию задачи в .groove/memory/specs/ перед написанием кода. Агент изучает структуру репозитория, опрашивает вас и разбивает крупные фичи на части. CX Codex +1 543установок project-creator itechmeat Скилл project-creator разворачивает структуру технической документации в папке .project/ и ведёт интервью, по шагам создавая спецификации, архитектуру и пользовательские истории. CX Codex +1 113установок planning-and-task-breakdown addyosmani Скилл planning-and-task-breakdown разбивает спецификацию на небольшие проверяемые задачи с явными критериями приемки. Помогает агенту спланировать архитектуру до написания кода и избежать путаницы. CX Codex +1 80 700установок

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

Весь набор →
practice-scout Субагент practice-scout ищет свежие практики сообщества, антипаттерны и примеры на GitHub под вашу задачу без изменения файлов проекта. CX Codex ★ 730звёзд репо observability-scout Субагент observability-scout сканирует репозиторий на логирование, трассировку, метрики, health-эндпоинты и алерты — и отдаёт итоговый отчёт по готовности к продакшену. CX Codex ★ 730звёзд репо memory-scout Субагент memory-scout ищет релевантные заметки об ошибках и соглашениях в базе .flow/memory/ перед планированием новой задачи. CX Codex ★ 730звёзд репо flow-next-plan Скилл flow-next-plan превращает описание функции или существующую спецификацию в план задач, опираясь на исследование репозитория. Он пригодится до начала реализации: код скилл не пишет. CX Codex +1 ★ 730звёзд репо github-scout Субагент github-scout для Claude Code ищет на GitHub примеры кода, реализации библиотек и открытые issues. Находит решения для изучения перед написанием своего кода. CX Codex ★ 730звёзд репо flow-next-prospect Скилл flow-next-prospect для Claude Code придумывает и ранжирует идеи развития на основе файлов репозитория. Запускается по просьбе обсудить, что строить дальше. CX Codex +1 ★ 730звёзд репо flow-next-map Скилл flow-next-map оборачивает clawpatch map, чтобы построить индекс функций и модулей репозитория на ~20 языках. По умолчанию работает без LLM-вызовов. CX Codex +1 ★ 730звёзд репо security-scout Субагент security-scout проверяет настройки безопасности репозитория GitHub, защиту веток, CODEOWNERS и автообновление зависимостей перед запуском агентов. CX Codex ★ 730звёзд репо

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

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