git-сервер доступен по https, а CLI `plugin marketplace add` не принимает ssh://…:2222 (только owner/repo, https, ./path). Переводим все примеры на https://git.vakhrushev.me/av/dev-skills.git; в JSON-блоке source-тип "git" (ровно то, что пишет команда add). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
75 lines
3.3 KiB
Markdown
75 lines
3.3 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-` (уникально в
|
|
маркетплейсе), имена **скилов** внутри — короткие. Вызов выходит вида
|
|
`/av-dev-<плагин>:<скилл>`.
|
|
|
|
## Структура
|
|
|
|
```
|
|
.claude-plugin/marketplace.json — манифест маркетплейса
|
|
<plugin>/.claude-plugin/plugin.json — манифест плагина
|
|
<plugin>/skills/<skill>/SKILL.md — скилы плагина (авто-обнаружение)
|
|
```
|