Holochain Agent Skill
Soushi888/holochain-agent-skillСкилл по стандарту Agent Skills Open Standard для разработки Holochain hApp. Совместим с Claude Code, GitHub Copilot, Cursor и Augment. Охватывает полный цикл: архитектуру, проектирование, скаффолдинг, реализацию, тестирование и деплой.
Установка
git clone https://github.com/Soushi888/holochain-agent-skill.gitREADME
Holochain Agent Skill
Комплексный скилл по стандарту Agent Skills Open Standard для разработки Holochain hApp, совместимый с Claude Code, GitHub Copilot, Cursor, Augment и любым другим инструментом, поддерживающим этот стандарт. Охватывает полный цикл разработки: от архитектуры и проектирования до скаффолдинга, реализации, тестирования и деплоя.
Что охватывает скилл
| Область | Описание |
|---|---|
| Архитектура | Разделение coordinator/integrity zome, структура DNA, Cargo workspace, Nix dev environment, паттерн progenitor, multi-DNA, приватные записи |
| Проектирование | Моделирование данных DHT, проектирование типов записей и ссылок, стратегия обнаружения, правила валидации |
| Скаффолдинг | Настройка Holonix, Nix flake, CLI hc, команды hc scaffold, создание нового проекта и нового домена |
| Реализация | Типы записей, типы ссылок, CRUD-паттерны, cross-zome вызовы, сигналы, валидация, HDK 0.6 API |
| Тестирование | Настройка Tryorama + Vitest, сценарии с двумя агентами, dhtSync, паттерны обновления/удаления, организация тестов |
| Деплой | Упаковка Kangaroo-Electron, сборка .webhapp, CI/CD, семантика версионирования, автообновление |
Текущие версии: hdk = "=0.6.0" | hdi = "=0.7.0" | holonix ref=main-0.6
Установка
Скилл соответствует стандарту Agent Skills Open Standard. Универсальный путь установки .claude/skills/holochain/ распознаётся всеми совместимыми инструментами.
Совместимые инструменты
| Инструмент | Поддержка | Вызов |
|---|---|---|
| Claude Code | ✅ | /holochain |
| GitHub Copilot | ✅ | через agent skills |
| Cursor | ✅ | через agent skills |
| Augment Code | ✅ | через agent skills |
| OpenAI Codex CLI | ✅ | через agent skills |
Claude Code
Вариант A: Глобальная установка — доступна во всех проектах
cp -r holochain-agent-skill ~/.claude/skills/holochain
Вариант B: Локальная установка — ограничена одним проектом
mkdir -p your-project/.claude/skills
cp -r holochain-agent-skill your-project/.claude/skills/holochainВариант C: Символическая ссылка (рекомендуется — автообновление через git pull)
git clone https://github.com/Soushi888/holochain-agent-skill ~/holochain-agent-skill
ln -s ~/holochain-agent-skill ~/.claude/skills/holochainПосле установки вызывайте скилл командой /holochain или позвольте Claude автоматически определять задачи, связанные с Holochain.
Cursor, GitHub Copilot, Augment и другие
Установите скилл в директорию .claude/skills/ корня вашего проекта — все инструменты, совместимые с Agent Skills, ищут скиллы по этому пути:
mkdir -p .claude/skills
cp -r holochain-agent-skill .claude/skills/holochainИнструмент автоматически обнаружит скилл при следующем запуске. Пути для глобальной установки, специфичные для каждого инструмента, описаны в его документации.
Обновление со старой версии? Если ранее вы устанавливали скилл в
.claude/skills/Holochain/(с заглавной буквы), переименуйте директорию:mv ~/.claude/skills/Holochain ~/.claude/skills/holochain
Быстрый старт
# Проектирование новой модели данных
/holochain design data model for a marketplace listing with status transitions
# Скаффолдинг нового hApp с нуля
/holochain scaffold new happ called my-network
# Реализация полного CRUD zome
/holochain implement zome for Profile entry type
# Отладка нестабильного теста
/holochain my Tryorama test passes alone but fails when Bob reads Alice's entry
# Упаковка для распространения
/holochain deploy package my happ for desktop distribution
Триггеры рабочих процессов
| Фраза... | Запускает |
|---|---|
| "design data model", "model entries", "what entries" | Рабочий процесс DesignDataModel |
| "scaffold", "new happ", "new project", "setup environment" | Рабочий процесс Scaffold |
| "implement zome", "create zome", "write zome" | Рабочий процесс ImplementZome |
| "design access control", "cap grant", "who can call" | Рабочий процесс DesignAccessControl |
| "deploy", "package", "webhapp", "kangaroo" | Рабочий процесс PackageAndDeploy |
Дорожная карта экосистемы
Скилл развивается по спирали от ядра к периферии:
v1 (текущая): Полный цикл разработки — архитектура, проектирование, скаффолдинг, реализация, тестирование, деплой
v2 (планируется): Расширение экосистемы
- Суб-скилл hREA / ValueFlows
- Паттерны holochain-open-dev
- Интеграция ADAM (coasys)
- Нагрузочное тестирование Wind Tunnel
- Интеграция unyt
- Переносимость между LLM
v3 (видение): GUI и визуальный инструментарий
- Интерфейс no-code рабочих процессов
- Визуальный проводник по модели данных DHT
- Генерация диаграмм архитектуры
- Прогрессивное раскрытие (от junior до senior)
Участие в разработке
Вклад приветствуется. Скилл имеет следующую структуру:
SKILL.md Точка входа — таблица маршрутизации и краткий справочник
Architecture.md Основные концепции: разделение zome, DNA, Nix, progenitor
Patterns.md Паттерны реализации: типы записей, ссылки, CRUD, сигналы
Scaffold.md Среда разработки и скаффолдинг проекта
AccessControl.md Система capability grants
CellCloning.md Партиционирование данных через clone cells
ErrorHandling.md Паттерны thiserror + WasmError
Testing.md Паттерны Tryorama + Vitest
TypeScript.md holochain-client, сигналы, интеграция Svelte
Deployment.md Упаковка Kangaroo-Electron и дистрибуция
Workflows/ Пошаговые управляемые рабочие процессы
docs/ Требования, дорожная карта и проектные решения
При обновлении под новые версии Holochain обновляйте версии в разделе Quick Reference файла SKILL.md и во всех примерах кода во всех файлах.
Лицензия
Apache-2.0