Користувацький плагін: прототип, готовий для команди

Team-ready plugin починається з вузького прототипу

Plugin обʼєднує кілька skills, документацію та метадані в пакет, який можна передати іншим розробникам. Перший прототип має бути достатньо малим, щоб його можна було встановити, перевірити й відкотити без усних пояснень автора.

Приклад `team-review-kit` охоплює шлях від issue до PR: `issue-analysis`, `project-setup` і `pr-review`.

team-review-kit/
├── plugin.json
├── README.md
├── CHANGELOG.md
├── skills/
│   ├── issue-analysis/SKILL.md
│   ├── pr-review/SKILL.md
│   └── project-setup/SKILL.md
└── examples/
    ├── issue-analysis-example.md
    └── pr-review-example.md

Ролі компонентів

Версія та namespace

Версія показує, який саме варіант workflow встановлено. Для раннього прототипу можна почати з `0.1.0`, якщо це відповідає вашій схемі версіонування. Namespace зменшує ризик конфліктів назв у спільному середовищі.

review-kit:issue-analysis
review-kit:pr-review
review-kit:project-setup

Що залишити поза першою версією

• agents;
• hooks;
• MCP;
• shell-скрипти;
• неповʼязані компоненти для майбутніх ідей.

Критерій готовності для команди

Наявність структури й документації не робить plugin автоматично безпечним. Team-ready означає відтворюваність, зрозумілі межі та перевірений шлях відкату.

1. Інший розробник знаходить plugin у репозиторії.
2. Самостійно читає README і розуміє призначення.
3. Встановлює пакет у потрібному scope.
4. Викликає namespaced skill.
5. Отримує очікуваний результат без пояснень автора.
6. Знає owner, capability surface, версію, спосіб вимкнення та сумісність.