av
675061739a
- скилл commit кодирует личный стиль сообщений: русский, опциональный scope-префикс, первая строка «что сделано», тело 1–3 пункта, без co-authored - плагин добавлен в marketplace.json и в секцию README
78 lines
3.7 KiB
Markdown
78 lines
3.7 KiB
Markdown
# av-dev-skills
|
|
|
|
Личный маркетплейс плагинов и скилов для разработки — чтобы подключать их к
|
|
проектам по мере необходимости, а не держать в глобальном `~/.claude`.
|
|
|
|
## Подключение
|
|
|
|
Типичный способ — подключить плагин **на уровне проекта**, чтобы он был активен у
|
|
всех, кто открывает репозиторий. Флаг `--scope project` пишет прямо в
|
|
`.claude/settings.json` проекта (коммитится в репозиторий) — из интерактивной
|
|
сессии Claude Code:
|
|
|
|
```
|
|
/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
|
|
/plugin install av-dev-backlog@av-dev-skills --scope project
|
|
```
|
|
|
|
…или те же команды из терминала:
|
|
|
|
```
|
|
claude plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
|
|
claude plugin install av-dev-backlog@av-dev-skills --scope project
|
|
```
|
|
|
|
Обе формы дописывают в `.claude/settings.json` ровно то, что можно внести и
|
|
руками — маркетплейс в `extraKnownMarketplaces`, плагин в `enabledPlugins`:
|
|
|
|
```json
|
|
{
|
|
"extraKnownMarketplaces": {
|
|
"av-dev-skills": {
|
|
"source": {
|
|
"source": "git",
|
|
"url": "https://git.vakhrushev.me/av/dev-skills.git"
|
|
}
|
|
}
|
|
},
|
|
"enabledPlugins": {
|
|
"av-dev-backlog@av-dev-skills": true
|
|
}
|
|
}
|
|
```
|
|
|
|
При первом открытии проекта Claude Code попросит доверять воркспейсу; после
|
|
подтверждения маркетплейс и включённые плагины подгружаются автоматически. Ключ
|
|
включения — `"<плагин>@<маркетплейс>": true`.
|
|
|
|
Без `--scope project` те же команды пишут в user-конфиг — разовая установка
|
|
только себе, настройки проекта не трогаются:
|
|
|
|
```
|
|
/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git
|
|
/plugin install av-dev-backlog@av-dev-skills
|
|
```
|
|
|
|
## Плагины
|
|
|
|
- **av-dev-backlog** — ведение беклога задач как каталога markdown-файлов (одна
|
|
задача = один файл `<slug>.md` + строка в индексе `README.md`). Скилл
|
|
`backlog`: заведение задачи из диалога, разбор находок аудита/ревью, груминг,
|
|
приоритизация, декомпозиция, штурм идей. Реализацией не занимается. Вызов:
|
|
`/av-dev-backlog:backlog`.
|
|
- **av-dev-git** — git-обвязка для личных проектов. Скилл `commit`: сообщения
|
|
коммитов в личном стиле (русский, опциональный scope-префикс, первая строка
|
|
«что сделано», тело 1–3 пункта, без co-authored). Вызов: `/av-dev-git:commit`.
|
|
|
|
Соглашение об именах: имя **плагина** длинное с префиксом `av-dev-` (уникально в
|
|
маркетплейсе), имена **скилов** внутри — короткие. Вызов выходит вида
|
|
`/av-dev-<плагин>:<скилл>`.
|
|
|
|
## Структура
|
|
|
|
```
|
|
.claude-plugin/marketplace.json — манифест маркетплейса
|
|
<plugin>/.claude-plugin/plugin.json — манифест плагина
|
|
<plugin>/skills/<skill>/SKILL.md — скилы плагина (авто-обнаружение)
|
|
```
|