Files

vitya 68fe9a8c1c feat(project-bootstrap): v1.3.0 — idempotent CLAUDE.md merge on upgrade

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>

2026-04-30 15:06:06 +03:00

4.9 KiB

Raw Permalink Blame History

claude-skills

English version: README.md.

Совместное хранилище и мастерская навыков для Claude.

About

Здесь мы с Claude вместе разрабатываем, отлаживаем и храним скиллы:

skills/ — редактируемые исходники (markdown + ассеты), source of truth
dist/ — собранные .skill архивы, закоммичены в репо
scripts/ — утилиты: build.sh (исходник → .skill), install.sh (исходник → ~/.claude/skills/)
.wiki/, .tasks/ — рабочие материалы и доска задач

Quick start

Установить скиллы на новом компе

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. Скажи агенту «bootstrap» или «настрой проект» в папке проекта — он за один проход:

инициализирует git (если ещё нет) и положит вменяемый .gitignore
создаст стартовый README.md
развернёт .wiki/ по паттерну Karpathy LLM Wiki (делегируется в setup-wiki)
развернёт .tasks/ с канонической доской задач (делегируется в 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 после обновления шаблона подтягивает новые триггеры, не дублируя старые.

Отредактировать скилл

# 1. Правишь skills/<name>/SKILL.md (или ассеты)
# 2. Раскатываешь правки в живые скиллы:
bash scripts/install.sh <name>
# 3. Пересобираешь архив (опц., но удобно делать перед коммитом):
bash scripts/build.sh <name>

Собрать `.skill` архивы

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.

4.9 KiB Raw Permalink Blame History Unescape Escape