vitya
6204e8ca90
Convergent phase of the brainstorm flow: user says «хватит, к промоушену» → grill session (design tree, rounds, frontier, numbered Q's with recommended answers) → decision record. Adaptations to our conventions: - grill-with-docs writes .wiki/concepts/<topic>-decision.md (project-discipline Rule 1) or appends to .brainstorm/ running record in the workshop zone - grilling sub-agent line made cross-agent honest (look up facts directly when no subagent spawning) - disable-model-invocation: true on both user wrappers Provenance pinned to real commit 84fdeffd (not TBD). README table updated. lint: 0/0; ~/.claude/skills now 41.
108 lines
6.1 KiB
Markdown
108 lines
6.1 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 using-wiki caveman
|
||
```
|
||
|
||
Цель установки можно переопределить переменной `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 project wiki`, `use task management system`, `check across all projects`, `we're on Windows`)
|
||
- зафиксирует версии использованных скиллов в `.wiki/concepts/bootstrap-manifest.md`, чтобы дрифт раскладки между проектами оставался отлаживаемым
|
||
|
||
Два режима, выбирается автоматически: **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
|
||
|
||
## Суверенитет / провенанс
|
||
|
||
Каталог суверенный: каждый скилл либо **нашего авторства**, либо
|
||
**адаптированная вендорская копия**, которую поддерживаем сами. Никаких
|
||
сырых вендорских плагинов как зависимостей — всё заимствованное вендорится
|
||
в этот репо с явным маркером `adapted-from` во frontmatter.
|
||
|
||
| скилл | провенанс |
|
||
|---|---|
|
||
| `caveman`, `caveman-commit`, `caveman-compress`, `caveman-help`, `caveman-review` | `adapted-from: JuliusBrussee/caveman` (MIT) — вендорная копия, пин апстрима TBD |
|
||
| `find-skills` | `adapted-from: vercel-labs/skills` (MIT) — вендорная копия, пин апстрима TBD |
|
||
| `grilling`, `grill-me`, `grill-with-docs` | `adapted-from: mattpocock/skills @ 84fdeffd` (MIT) |
|
||
| остальные `skills/*` | `author: ours` |
|
||
|
||
Политика адаптации: клон переписывается под наши конвенции (доски `.tasks/`,
|
||
спеки `.wiki/concepts/`, имена скиллов `using-*`), вендорский мусор не
|
||
перетягивается, версионируется под нашим semver. Пины апстрима
|
||
пересматривает владелец каталога при обновлении; автосинка нет.
|
||
|
||
```
|
||
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).
|