vitya
68fe9a8c1c
Step 5 was binary on upgrade (append whole template / leave alone), so projects bootstrapped before v1.2.0 silently missed new canonical triggers (`check across all projects`, `we're on Windows`) on re-run. Now upgrade reads existing CLAUDE.md, substring-diffs vs template, preserves a deliberately-pinned platform line, and appends only missing lines after explicit confirm. Re-runs are no-ops. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
90 lines
4.9 KiB
Markdown
90 lines
4.9 KiB
Markdown
# claude-skills
|
||
|
||
> English version: [README.md](README.md).
|
||
|
||
Совместное хранилище и мастерская навыков для Claude.
|
||
|
||
## About
|
||
|
||
Здесь мы с Claude вместе разрабатываем, отлаживаем и храним скиллы:
|
||
|
||
- **`skills/`** — редактируемые исходники (markdown + ассеты), source of truth
|
||
- **`dist/`** — собранные `.skill` архивы, закоммичены в репо
|
||
- **`scripts/`** — утилиты: `build.sh` (исходник → `.skill`), `install.sh` (исходник → `~/.claude/skills/`)
|
||
- **`.wiki/`**, **`.tasks/`** — рабочие материалы и доска задач
|
||
|
||
## Quick start
|
||
|
||
### Установить скиллы на новом компе
|
||
|
||
```bash
|
||
git clone <repo> claude-skills
|
||
cd claude-skills
|
||
bash scripts/install.sh # копирует все skills/* в ~/.claude/skills/
|
||
# или конкретные:
|
||
bash scripts/install.sh caveman wiki-maintainer
|
||
```
|
||
|
||
Цель установки можно переопределить переменной `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh`.
|
||
|
||
### Использование в проектах
|
||
|
||
Когда скиллы установлены, проще всего раскатить их на новый (или
|
||
существующий) проект через скилл [`project-bootstrap`](skills/project-bootstrap/).
|
||
Скажи агенту **«bootstrap»** или **«настрой проект»** в папке проекта — он
|
||
за один проход:
|
||
|
||
- инициализирует `git` (если ещё нет) и положит вменяемый `.gitignore`
|
||
- создаст стартовый `README.md`
|
||
- развернёт `.wiki/` по [паттерну Karpathy LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (делегируется в [`setup-wiki`](skills/setup-wiki/))
|
||
- развернёт `.tasks/` с канонической доской задач (делегируется в [`setup-tasks`](skills/setup-tasks/))
|
||
- запишет `CLAUDE.md` со скилл-триггерами (`use superpowers`, `use project wiki`, `use task management system`, `check across all projects`, `we're on Windows`)
|
||
- зафиксирует версии использованных скиллов в `.wiki/concepts/bootstrap-manifest.md`, чтобы дрифт раскладки между проектами оставался отлаживаемым
|
||
- проверит, установлен ли официальный плагин `superpowers@claude-plugins-official`, и если нет — выведет команду установки (без плагина триггер `use superpowers` мёртвый)
|
||
|
||
Два режима, выбирается автоматически: **init** для пустой папки и **upgrade**
|
||
для существующего проекта (скилл только дозаполняет пробелы и ничего не
|
||
перезаписывает без явного подтверждения). В режиме upgrade `CLAUDE.md`
|
||
сливается идемпотентно — только канонические триггер-строки, которых ещё
|
||
нет в файле, дописываются после явного подтверждения, поэтому повторный
|
||
запуск `project-bootstrap` после обновления шаблона подтягивает новые
|
||
триггеры, не дублируя старые.
|
||
|
||
### Отредактировать скилл
|
||
|
||
```bash
|
||
# 1. Правишь skills/<name>/SKILL.md (или ассеты)
|
||
# 2. Раскатываешь правки в живые скиллы:
|
||
bash scripts/install.sh <name>
|
||
# 3. Пересобираешь архив (опц., но удобно делать перед коммитом):
|
||
bash scripts/build.sh <name>
|
||
```
|
||
|
||
### Собрать `.skill` архивы
|
||
|
||
```bash
|
||
bash scripts/build.sh # все
|
||
bash scripts/build.sh caveman # один
|
||
```
|
||
|
||
`build.sh` использует `zip` если он есть (Linux/macOS) или делегирует в
|
||
`scripts/build.ps1` через PowerShell (Windows без `zip`). На Windows
|
||
можно сразу запускать `powershell scripts/build.ps1`.
|
||
|
||
## Layout
|
||
|
||
```
|
||
claude-skills/
|
||
├── skills/ ← исходники (по папке на скилл)
|
||
├── dist/ ← .skill архивы (коммитятся)
|
||
├── scripts/
|
||
│ ├── build.sh / build.ps1
|
||
│ └── install.sh
|
||
├── .wiki/ ← дизайн-доки, заметки
|
||
├── .tasks/ ← STATUS.md
|
||
├── CLAUDE.md
|
||
└── README.md
|
||
```
|
||
|
||
Подробнее про принципы и решения — в [`.wiki/concepts/repo-layout.md`](.wiki/concepts/repo-layout.md).
|