feat(skill): writing-skills v0.2.0 — placement rule: проектный скил → .agents/skills/ (cwd), не ~/.agents/skills/ и не каталог
This commit is contained in:
BIN
dist/writing-skills.skill
vendored
BIN
dist/writing-skills.skill
vendored
Binary file not shown.
@@ -1,7 +1,7 @@
|
||||
---
|
||||
name: writing-skills
|
||||
adapted-from: obra/superpowers @ 6.2.0 (MIT) — TDD-for-skills core; ideya 8 self-skill-authoring (workshop record)
|
||||
version: 0.1.1
|
||||
version: 0.2.0
|
||||
description: >
|
||||
Authoring agent skills TDD-style — RED-GREEN-REFACTOR applied to SKILL.md
|
||||
documents. Use when creating a new skill, editing an existing one, or
|
||||
@@ -89,9 +89,21 @@ content for hypothetical cases.
|
||||
### Skill structure (our catalog conventions)
|
||||
|
||||
```
|
||||
skills/<name>/SKILL.md
|
||||
skills/<name>/SKILL.md # общий каталог (catalog, версионируется, ставится install.sh)
|
||||
```
|
||||
|
||||
**Куда класть скил — определи ДО написания (три варианта, не путать):**
|
||||
|
||||
| Тип скила | Место | Когда |
|
||||
|---|---|---|
|
||||
| Общий каталог | `~/projects/skills/skills/<name>/SKILL.md` + deploy (lint/build/install) | полезен всем проектам/агентам |
|
||||
| **Проектный (зона проекта)** | `<project>/.agents/skills/<name>/SKILL.md` (pi грузит из cwd; Claude Code: `.claude/skills/`) | привязан к одному проекту/роли (пример: `.admin` ops-скилы, `books/.agents/skills/`) |
|
||||
| ~~Глобальная установка руками~~ | ~~`~/.agents/skills/`~~ | **НЕ сюда** — это установочная копия (перезапишется update-skills), не место разработки |
|
||||
|
||||
Правило: если скил про зону одного проекта (admin, books, …) — проектный путь
|
||||
(`.agents/skills/` в cwd проекта), НЕ общий каталог и НЕ `~/.agents/skills/`.
|
||||
Если скил общий — каталог `skills/` + deploy-цикл. При сомнении — спросить.
|
||||
|
||||
Frontmatter (YAML):
|
||||
|
||||
- `name` — letters, numbers, hyphens only. Verb-first, active voice:
|
||||
@@ -158,6 +170,8 @@ discipline skills.
|
||||
- [ ] Description = when to use only, no workflow summary
|
||||
- [ ] Frontmatter: name (verb-first, hyphens), description (triggers), version
|
||||
(bumped), provenance (author/adapted-from with real pin)
|
||||
- [ ] Placement decided: project skill → `<project>/.agents/skills/` (cwd), NOT
|
||||
`~/.agents/skills/`; catalog skill → `skills/<name>/` + deploy cycle
|
||||
- [ ] Lint passes (catalog: `scripts/lint-skills.py`), dist rebuilt
|
||||
(`scripts/build.sh`), installed (`scripts/install.sh <name>`)
|
||||
- [ ] README provenance table updated (catalog)
|
||||
|
||||
Reference in New Issue
Block a user