CCPM (Claude Code Project Mgmt) (Claude Skill) — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

GitHub Issues как очередь работ
Git worktrees для каждого issue — настоящая параллельная работа агентов
Slash-команды /start /ship /abandon
Автоматическое создание PR, связанного с issue
Очистка при слиянии/отказе
Работает на любом GitHub-репозитории с установленным gh

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "ccpm-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "ccpm-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/automazeio/ccpm",
          "~/.claude/skills/ccpm"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add ccpm-skill -- git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: CCPM (Claude Code Project Mgmt)

Запустить 3 сессии Claude на 3 разных issue одновременно

👤 Одиночные основатели, инди-разработчики ⏱ ~60 min intermediate

Когда использовать: У вас 5 небольших issues; делать их последовательно медленно, а переключение веток ломает состояние.

Предварительные требования

gh CLI авторизован — gh auth login — проверьте через gh repo view
Навык установлен — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

Поток

Выбрать issues

Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ Скопировано

→ 3 issue с грубой оценкой, без блокировщиков между ними
Запустить их

Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ Скопировано

→ 3 worktree созданы в ../wt-42 и т.д.; каждая сессия знает, какой issue ей принадлежит
Отправить их

(В каждой сессии) When done — /ship — push branch and open PR linked to the issue.✓ Скопировано

→ PR создан, связан с issue, CI запущен

Итог: Три закрытых issue к концу дня без боли с переключением веток.

Подводные камни

Issues затрагивают пересекающиеся файлы → конфликты слияния — Навык предупреждает, когда выбранные issues имеют пересечение по файлам; выбирайте непересекающиеся для параллельной работы

Сочетать с: github

Превратить случайную идею в правильно оформленный issue

👤 Все с переполнением идей ⏱ ~5 min beginner

Когда использовать: Вы постоянно пишете «а ещё стоило бы...» в чат. Фиксируйте это как нормальные issues.

Поток

Зафиксировать

Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ Скопировано

→ Хорошо оформленный issue создан на GitHub
Связать

Link to related issues if any.✓ Скопировано

→ Связи добавлены

Итог: Идеи становятся issues, которые можно реально триажировать позже.

Подводные камни

Issues становятся слишком многословными — Навык устанавливает ограничение в 200 слов для тела

Сочетать с: github

Отказаться от начатого issue без осиротевших веток

👤 Все, кто начал что-то и передумал ⏱ ~2 min beginner

Когда использовать: Через 30 минут работы над issue вы понимаете, что подход неверный; хотите выйти чисто.

Поток

Отказаться

/abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ Скопировано

→ Worktree удалён, ветка удалена, issue закрыт с объяснением

Итог: Никаких заброшенных веток, преследующих репозиторий.

Подводные камни

Вы хотели сохранить часть работы — Навык сохраняет патч в /tmp/ccpm-stashes перед удалением — восстановимо ~7 дней

Сочетать с: github

Комбинации

Сочетайте с другими MCP — эффект x10

ccpm-skill + github

Синхронизировать CCPM и GitHub MCP по состоянию issue

ccpm-skill + memorix-mcp

Переносить контекст между worktrees

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать
list	filters	Найти работу
start	issue_number	Начать работу над issue
ship	issue_number?	Готово; время для PR
abandon	issue_number, reason	Чисто выйти

Стоимость и лимиты

Во что обходится

Квота API: Ограничен лимитами GitHub API (5000/ч для авторизованных)
Токенов на вызов: Легко — большинство операций это git + gh CLI
Деньги: Бесплатно
Совет: Не перевыпускайте issues — навык поощряет фиксацию мыслей, но не каждой микромысли

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: repo (для записи issue + PR)

Хранение учётных данных: Через gh auth

Исходящий трафик: GitHub API

Никогда не давайте: admin:org

/abandon удаляет ветки — нужен флаг подтверждения для общих репозиториев

Устранение неполадок

Частые ошибки и исправления

git worktree add fails: already used

Предыдущий worktree ещё существует; очистите через git worktree prune

Проверить: `git worktree list`

gh PR create ошибается с 'no commits between'

Сделайте хотя бы один коммит в ветке worktree перед /ship

Две сессии захватывают один issue

Навык пишет lockfile на issue — второй start завершается с чётким сообщением

Альтернативы

CCPM (Claude Code Project Mgmt) в сравнении

Альтернатива	Когда использовать	Компромисс
Linear MCP	Вы на Linear, а не на GitHub Issues	CCPM только для GitHub; Linear MCP — своя экосистема
Обычный `git worktree` + чеклист	Вы запускаете только 1 агента одновременно	Вручную; CCPM автоматизирует жизненный цикл

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills