中文 | English

aelf Skills

Единая точка обнаружения и начальной загрузки для экосистемы навыков aelf.

Данный репозиторий предоставляет:

1. Двуязычную документацию для людей и AI-агентов.
2. Машиночитаемый каталог: skills-catalog.json.
3. Начальную загрузку одной командой: bootstrap.sh.

Быстрый промпт для AI (OpenClaw / Codex / Cursor / Claude Code)

Repository: https://github.com/AElfProject/aelf-skills
This is a client-agnostic prompt for OpenClaw, Codex, Cursor, and Claude Code.
Read first: skills-catalog.json, docs/SKILL_ROUTING_MATRIX.md, docs/AI_E2E_SCENARIOS.md.
Then run:
1) ./bootstrap.sh --source github --dest ./downloaded-skills
2) bun run health:check -- --skills-root ./downloaded-skills
3) read `clientInstall.openclaw` / `clientInstall.ironclaw` from `skills-catalog.json`; if `installCommand` exists, execute it locally instead of treating a GitHub tree URL as the final install input
Routing rule: follow SKILL_ROUTING_MATRIX; if ambiguous, output Recommended/Alternative/Reason.
Failure rule: use Common Recovery Template in docs/AI_E2E_SCENARIOS.md.

Область применения

Данный хаб сосредоточен на обнаружении, загрузке, установке и индексировании возможностей.

Он не заменяет логику клиентской интеграции каждого отдельного репозитория навыков. Настройка под конкретный клиент (OpenClaw, Cursor, Claude Desktop, IronClaw, Codex, Claude Code) остаётся внутри каждого репозитория навыка. AI-агентам: перейдите к разделу Навигация для AI для руководств по маршрутизации и выполнению.

Обнаружение и активация

Распространение навыков разделено на два этапа:

1. discovery (обнаружение): URL репозитория GitHub / npm-пакет / ClawHub slug помогают хосту найти навык.
2. activation (активация): хост или агент выполняет машиночитаемый контракт установки из skills-catalog.json.

Правила:

1. URL дерева/репозитория GitHub являются только источниками обнаружения. Не используйте их как финальный артефакт установки IronClaw.
2. Для IronClaw предпочтительно использовать clientInstall.ironclaw.installCommand с ожидаемым доверенным локальным шагом установки.
3. Для OpenClaw предпочтительно использовать ClawHub / управляемую установку, если существует distributionSources.clawhubId; в противном случае используйте clientInstall.openclaw.installCommand.

Требования

• bun >= 1.1.0 (обязательное требование)
• npm >= 10
• git >= 2.39
• tar (GNU tar / bsdtar)

Настройка локального окружения

Пути в workspace.json используют плейсхолдеры ${SKILLS_BASE} для переносимости. workspace.json — локальная конфигурация рабочего пространства Codex; внешние потребители должны использовать skills-catalog.json как источник данных.

Пример:

• ${SKILLS_BASE}/AElf/aelf-node-skill
• ${SKILLS_BASE}/awaken/awaken-agent-skills

Установка

npm install @blockchain-forever/aelf-skills
# или
bun add @blockchain-forever/aelf-skills

Быстрый старт

# 1) Генерация публичного каталога и синхронизация таблиц README
bun run catalog:generate

# 2) Генерация локального каталога с sourcePath (для локальной загрузки/проверки)
bun run catalog:generate:local

# 3) Запуск базовых проверок
bun run health:check
bun run readme:check
bun run security:audit

# 4) Начальная загрузка выбранных навыков
./bootstrap.sh --only aelf-node-skill --skip-install

# 5) Проверка расхождений обновлений хаба/каталога (неблокирующая)
bun run update:check

Bootstrap CLI

./bootstrap.sh [--catalog <path>] [--dest <dir>] [--source auto|npm|github|local] [--skip-install] [--skip-health] [--only <csv>]

Значения по умолчанию:

1. --source auto (сначала npm, затем github как запасной вариант)
2. установка включена
3. проверка работоспособности включена
4. skills-catalog.json как источник каталога

Самопроверка обновлений

aelf-skills включает встроенные напоминания об обновлениях для bootstrap, health:check и catalog:generate. Проверки неблокирующие и кэшируются (TTL по умолчанию 24ч). Вывод напоминаний ограничен одним разом за окно TTL через lastNotifiedAt.

Команды:

1. bun run update:check
2. bun run update:check -- --force
3. bun run update:check:json

Переменные окружения:

1. AELF_SKILLS_UPDATE_CHECK=0|1 (по умолчанию 1)
2. AELF_SKILLS_UPDATE_TTL_HOURS=24 (по умолчанию 24)
3. AELF_SKILLS_UPDATE_CACHE_PATH=<path> (по умолчанию ~/.aelf-skills/update-check-cache.json)

Генерируемый каталог

skills-catalog.json — стабильный машинный интерфейс.

Основные поля для каждого навыка:

1. id, displayName
2. npm (name, version)
3. repository.https
4. distributionSources (githubRepo, npmPackage, опциональный clawhubId)
5. description, capabilities
6. artifacts (skillMd, mcpServer, openclaw)
7. setupCommands (команды отображения совместимости: claudeDesktop, cursor, openclaw, ironclaw)
8. clientSupport (матрица поддержки: claude_desktop, cursor, ironclaw, codex)
9. clientInstall (машиноисполняемый контракт активации для openclaw / ironclaw)
10. dependsOn (опционально, схема 1.3.0)

Ссылки на схемы:

1. docs/schemas/workspace.schema.json
2. docs/schemas/skill-frontmatter.schema.json
3. docs/schemas/openclaw.schema.json
4. docs/schemas/skills-catalog.schema.json

Политика эволюции схемы:

1. patch (1.3.x): исправления формулировок/документации, семантика полей не меняется.
2. minor (1.x.0): обратно совместимые добавления полей.
3. major (x.0.0): только критические изменения.

Навигация для AI

1. Семантика полей каталога: docs/CATALOG_SCHEMA.md | docs/CATALOG_SCHEMA.zh-CN.md
2. Матрица маршрутизации по намерениям: docs/SKILL_ROUTING_MATRIX.md | docs/SKILL_ROUTING_MATRIX.zh-CN.md
3. Сценарии выполнения end-to-end (с восстановлением): docs/AI_E2E_SCENARIOS.md | docs/AI_E2E_SCENARIOS.zh-CN.md
4. Базовый уровень типобезопасности и статус внедрения: docs/TYPE_SAFETY_MATRIX.md | docs/TYPE_SAFETY_MATRIX.zh-CN.md

Текущий снимок навыков

Данный раздел автоматически синхронизируется командой bun run catalog:generate.