# установка Agent Skills и проведим задачу до релиза

Пошаговый процесс разработки с Agent Skills: от требований и спецификации до плана, реализации через тесты, код-ревью и проверки перед релизом. Подходит для Claude Code, Codex и других агентов с поддержкой скиллов.

## 1. Подготовить инструменты

- [ ] Выбрать агента для кода: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://github.com/openai/codex) или другой агент, поддерживающий скиллы. Пакет [Agent Skills](https://github.com/addyosmani/agent-skills) открыт под лицензией MIT: 24 скилла для этапов разработки и `using-agent-skills` для выбора подходящего скилла.
- [ ] Для Claude Code проверить доступ к платному плану или Anthropic Console и [доступность сервиса в своей стране](https://support.claude.com/en/articles/8461763-where-can-i-access-claude). Установка и запуск описаны в [документации Claude Code](https://code.claude.com/docs/en/setup).
- [ ] Для установки через [skills CLI](https://github.com/vercel-labs/skills) проверить Node.js командой `node -v`; если команды нет, [установить Node.js](https://nodejs.org/en/download).
- [ ] Для установки плагина из репозитория проверить наличие Git.

## 2. Установить пакет выбранным способом

## Claude Code: плагин

- [ ] Если Claude Code ещё не установлен, выбрать способ из [официальной инструкции](https://code.claude.com/docs/en/setup). Для macOS, Linux и WSL:

```bash
  curl -fsSL https://claude.ai/install.sh | bash
```

- [ ] Внутри Claude Code добавить маркетплейс и установить плагин [Agent Skills](https://github.com/addyosmani/agent-skills):

```text
  /plugin marketplace add addyosmani/agent-skills
  /plugin install agent-skills@addy-agent-skills
```

- [ ] Если появится запрос на перезагрузку плагинов, выполнить `/reload-plugins`. Открыть меню `/` и найти `spec`, `plan`, `build`, `test`, `review`, `ship`. Приставка `agent-skills:` в названии допустима.
- [ ] При ошибке SSH `Permission denied (publickey)` повторить добавление маркетплейса по HTTPS:

```text
  /plugin marketplace add https://github.com/addyosmani/agent-skills.git
  /plugin install agent-skills@addy-agent-skills
```

Если ошибка остаётся, выполнить в обычном терминале настройку Git и повторить установку. Команда меняет **глобальную** настройку Git:

```bash
  git config --global url."https://github.com/".insteadOf git@github.com:
```

## Codex: нативный плагин

- [ ] Проверить, что установлен Codex CLI версии **0.122 или новее**, и выполнить команды из [инструкции пакета для Codex](https://github.com/addyosmani/agent-skills/blob/main/docs/codex-setup.md):

```bash
  codex plugin marketplace add addyosmani/agent-skills
  codex plugin add agent-skills@agent-skills
```

- [ ] Открыть новую сессию Codex. Вызывать нужный скилл через `@`, например `@spec-driven-development`; слэш-команды Claude Code здесь не используются.

## Codex, Claude Code или другой агент: skills CLI

- [ ] При необходимости сначала посмотреть список скиллов, затем установить пакет через [skills CLI](https://github.com/vercel-labs/skills):

```bash
  npx skills add addyosmani/agent-skills --list
  npx skills add addyosmani/agent-skills
```

Установщик предложит выбрать агента. Дополнительные варианты:

```bash
  npx skills add addyosmani/agent-skills -g -a claude-code
  npx skills add addyosmani/agent-skills --skill code-review-and-quality
```

Первый вариант ставит пакет для Claude Code во все проекты; второй — только один скилл. При установке одного скилла общие чек-листы из корневой папки `references/` не копируются.

## 3. Провести задачу по этапам

- [ ] **Уточнить идею и требования.** Для сырой идеи использовать `interview-me`; для спецификации — `/spec` в Claude Code или `@spec-driven-development` в Codex. Зафиксировать цель, адресата, главный результат, стек, ограничения и критерии готовности в `SPEC.md`.
- [ ] **Один раз задать планку качества проекта**, если она нужна: `/constraints` создаёт `CONSTRAINTS.md`.
- [ ] **Разбить спецификацию на задачи.** В Claude Code вызвать `/plan`, в Codex — `@planning-and-task-breakdown`. Для каждой задачи указать критерий приёмки, проверку и зависимости; сохранить `tasks/plan.md` и `tasks/todo.md`.
- [ ] **Реализовывать задачи по одной.** В Claude Code вызвать `/build`: сначала падающий тест, затем минимальный код, все тесты, сборка, коммит и отметка задачи. `/build auto` использовать после одобрения плана для последовательного прохождения всего плана; на ошибках и рискованных шагах процесс останавливается. Для Codex выбирать соответствующий скилл `@incremental-implementation`.
- [ ] **При баге воспроизвести его тестом.** В Claude Code использовать `/test`; затем исправить баг и прогнать весь набор тестов. Соответствующий скилл пакета — `test-driven-development`.
- [ ] **Проверить изменения перед запуском.** `/review` — корректность, читаемость, архитектура, безопасность и производительность; `/code-simplify` — упрощение без изменения поведения; `/webperf` — аудит Core Web Vitals для веб-приложения.
- [ ] **Провести выпускную проверку.** `/ship` включает тесты, безопасность, производительность, доступность, инфраструктуру, документацию, решение о запуске и план отката. Для Codex соответствующий скилл — `@shipping-and-launch`.
- [ ] **Для большой работы начинать новый этап в новой сессии.** Передавать контекст через `SPEC.md` и `tasks/`, а не полагаться на историю чата.

## 4. Готовые промпты для Claude Code

Заменить текст в угловых скобках своими данными. Для Codex заменить слэш-команду вызовом соответствующего скилла через `@`; конкретные имена скиллов перечислены выше и в [репозитории пакета](https://github.com/addyosmani/agent-skills).

**Когда идея ещё сырая — `interview-me`:**

```text
interview me. Нужно сделать <что>. Задавай по одному вопросу за раз и к каждому давай свою догадку, пока не станет ясно, кому это нужно, зачем и как определить готовность. Код не пиши.
```

**Спецификация:**

```text
/spec Нужен <продукт> для <кого>. Главный результат: <что пользователь сможет сделать>. Стек: <стек или «предложи сам и объясни выбор»>. Нельзя: <ограничения>. Сохрани SPEC.md и покажи результат до начала кода.
```

**План:**

```text
/plan Разбей SPEC.md на маленькие задачи: у каждой критерии приёмки, проверка и зависимости. Рискованные задачи поставь в начало, после каждых 2-3 задач добавь точку проверки. Кода пока не пиши, сначала покажи план.
```

**Следующая задача:**

```text
/build Возьми следующую задачу из tasks/todo.md. Сначала тест, который падает, потом минимальный код, потом все тесты и сборка. Сделай коммит и отметь задачу выполненной.
```

**Весь одобренный план:**

```text
/build auto
```

**Баг и тест:**

```text
/test Баг: <что происходит и как повторить>. Сначала напиши тест, который воспроизводит баг и падает, потом почини и прогони весь набор тестов.
```

**Ревью:**

```text
/review Проверь последние изменения по 5 осям: корректность, читаемость, архитектура, безопасность, производительность. Каждую находку пометь Critical, Important или Suggestion, укажи файл и строку и предложи исправление.
```

**Подготовка к запуску:**

```text
/ship Прогони чек-лист перед запуском для текущих изменений: тесты, безопасность, производительность, доступность, инфраструктура, документация. Дай решение, запускать или нет, и план отката.
```

**Продолжение в новой сессии:**

```text
Прочитай SPEC.md, tasks/plan.md и tasks/todo.md, проверь git status и перепроверь то, что изменилось с последнего прогона тестов. Скажи, какая задача следующая и что осталось открытым, и остановись до подтверждения продолжения работы.
```

## 5. Проверить типовые сбои

- [ ] **Команды Claude Code не появились:** выполнить `/reload-plugins` или перезапустить Claude Code и снова открыть меню `/`.
- [ ] **`npx` не найден:** установить [Node.js](https://nodejs.org/en/download) и открыть новый терминал.
- [ ] **Codex не видит плагин:** проверить версию CLI (**0.122+**) и открыть новую сессию.
- [ ] **Агент пропускает этап:** явно назвать нужный скилл, например `test-driven-development`, или вызвать соответствующую команду.

---

Источник: https://localhost:3000/m/chek-list-ustanovit-agent-skills-i-provesti-zadachu-do-reliza