Перейти к содержимому
F●RGEPLAN

forgeplan setup-skill

forgeplan setup-skill устанавливает навык /forge Claude Code глобально для пользователя, записывая один markdown-файл в ~/.claude/skills/forge/SKILL.md. После установки Claude Code может вызывать полный рабочий процесс Forgeplan (роутинг → Shape → Validate → ADI → Code → Evidence → Activate) с помощью одной слэш-команды /forge в любом проекте, при этом все правила методологии загружаются в качестве контекста через встроенное определение навыка.

Файл навыка встроен непосредственно в бинарный файл forgeplan во время компиляции - команда не выполняет сетевого доступа, не загружает ничего с маркетплейса и не изменяет каталоги .forgeplan/ или .claude/ текущего проекта.

Когда использовать

Заголовок раздела «Когда использовать»
  • При первом подключении Claude Code (или другого клиента Claude Agent SDK) к Forgeplan.
  • Один раз на машину - навык является глобальным для пользователя и после этого работает во всех проектах.
  • После обновления бинарного файла Forgeplan, если встроенное определение навыка изменилось (повторно запустите, чтобы получить обновления).
  • При адаптации члена команды, у которого уже есть Claude Code, но который никогда не запускал Forgeplan локально.

Когда НЕ использовать

Заголовок раздела «Когда НЕ использовать»
  • Если вы не используете Claude Code - навык специфичен для Claude Code и не влияет на использование CLI.
  • Если вы вручную настроили ~/.claude/skills/forge/SKILL.md и не хотите его перезаписывать (команда переустановит встроенную версию).
  • В качестве замены для forgeplan init - это только устанавливает файл навыка, он не создает рабочее пространство.
  • Если вам нужны плагины маркетплейса (/audit, /sprint, /fpf и т. д.) - они устанавливаются отдельно через /plugin install <name>@ForgePlan-marketplace (после /plugin marketplace add ForgePlan/marketplace). См. Обзор маркетплейса.

Использование

Заголовок раздела «Использование»
forgeplan setup-skill

Опции

Заголовок раздела «Опции»
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Заголовок раздела «Примеры»

Пример 1: Адаптация нового проекта

Заголовок раздела «Пример 1: Адаптация нового проекта»
Окно терминала
forgeplan init -y
forgeplan setup-skill

Типичная последовательность начальной загрузки: создайте рабочее пространство, затем установите навык Claude Code, чтобы /forge был немедленно доступен в следующей сессии чата.

Пример 2: Обновление навыка после апгрейда

Заголовок раздела «Пример 2: Обновление навыка после апгрейда»
Окно терминала
cargo install forgeplan  # или brew upgrade forgeplan
forgeplan setup-skill

Повторно запускает установщик, чтобы markdown навыка соответствовал новой бинарной версии. Безопасно запускать многократно - он перезаписывает ~/.claude/skills/forge/SKILL.md.

Пример 3: Проверка установки

Заголовок раздела «Пример 3: Проверка установки»
Окно терминала
forgeplan setup-skill
ls ~/.claude/skills/forge/
# -> SKILL.md

Подтверждает, что единственный файл навыка попал в глобальный для пользователя каталог навыков Claude Code.

Как это вписывается в рабочий процесс

Заголовок раздела «Как это вписывается в рабочий процесс»

Это одноразовая команда настройки, не являющаяся частью жизненного цикла артефакта. Она относится к начальной загрузке проекта наряду с:

  1. forgeplan init -y - создать рабочее пространство
  2. forgeplan setup-skill - установить интеграцию Claude Code
  3. Настроить .forgeplan/config.yaml - провайдер LLM + ключ API
  4. forgeplan health - проверка работоспособности
  5. Откройте Claude Code и вызовите /forge - запускается рабочий процесс, учитывающий методологию

Внутри Claude Code /forge предоставляет агентам ИИ ту же дисциплину роутинга, валидации и доказательств, описанную в руководстве по методологии.

Заметки по безопасности

Заголовок раздела «Заметки по безопасности»
  • Команда записывает в ~/.claude/skills/forge/SKILL.md в вашем домашнем каталоге (глобально для пользователя). Если у вас есть локальные изменения в этом файле, сначала сделайте их резервную копию.
  • Поскольку это глобальный файл для пользователя (не локальный для проекта), нечего добавлять в .gitignore - файл находится вне любого репозитория.
  • Данные рабочего пространства не затрагиваются; эта команда не изменяет .forgeplan/.

См. также

Заголовок раздела «См. также»