CocoaSkills

Установщик csk управляет локальными пакетами скиллов для AI-агентов. Инструмент загружает скиллы из git-репозиториев и подготавливает файлы для шести сред: Claude Code, Codex CLI, Cursor, Gemini, OpenCode и Windsurf.

Зачем

Ручное управление скиллами в нескольких проектах создаёт проблемы при командной разработке. Содержимое файлов на компьютерах разработчиков расходится со временем. Без фиксации версий по тегам и коммитам обновления ломают рабочие окружения. Вспомогательные файлы, такие как README, тесты и файлы сборки, попадают в контекст агента и расходуют лимиты токенов. При удалении скилла из конфигурации неиспользуемые файлы остаются на диске.

Установщик csk решает эти проблемы декларативным описанием скиллов в Skillfile.json. Инструмент фиксирует версии git-репозиториев, копирует в контекст агента только SKILL.md и объявленные каталоги (references/, assets/, agents/, data/), исключая tests, README, файлы сборки и метаданные git, и удаляет устаревшие файлы при обновлении состава скиллов.

Рынок и позиция CocoaSkills

Публичные инструменты закрывают отдельные этапы работы с агентскими навыками. Корпоративный контур требует единой системы управления локальным окружением и цепочкой поставок.

Установщик csk работает на уровне локальной инфраструктуры проекта. Инструмент воспроизводимо и безопасно управляет агентскими навыками со следующими свойствами:

• Детерминированный граф зависимостей выявляет конфликты версий до начала установки.
• Поддержка закрытых источников позволяет ограничить загрузку разрешёнными git-репозиториями.
• Трёхуровневая изоляция разделяет контекст модели, исполняемую среду и артефакты сборки.
• Транзакционная установка гарантирует откат к исходному состоянию при ошибках.
• Каноническое состояние проекта не зависит от выбранного агента или среды разработки.
• Локальная проверка правил безопасности работает без обязательной связи с внешними сервисами.

Существующие инструменты решают задачи каталогизации и проверки навыков; csk закрывает соседний уровень: детерминированную и воспроизводимую установку скиллов внутри закрытого корпоративного контура.

Почему CocoaSkills, а не альтернативы

Ручное копирование папок или создание symlink:

• Где ломается: требует повторного копирования во всех проектах при обновлениях и переносит лишние файлы репозитория в контекст модели.
• Что делает csk: автоматизирует загрузку, фильтрует содержимое до разрешённых каталогов и обновляет файлы одной командой.

Подключение через git submodules или git subtree:

• Где ломается: сохраняет полную историю репозиториев, требует команд git при переключении веток и не формирует адаптеры для агентов.
• Что делает csk: скачивает репозитории в локальный кэш, извлекает файлы скиллов и строит конфигурации для каждого агента.

Встроенные маркетплейсы плагинов внутри конкретных агентов:

• Где ломается: привязывает скиллы к одному агенту и не позволяет использовать единый манифест в командах с разными инструментами.
• Что делает csk: хранит единый Skillfile.json и раскладывает скиллы по адаптерам Claude Code, Codex CLI, Cursor и Gemini; OpenCode и Windsurf читают .agents/skills/ напрямую.

Общая директория скиллов с синхронизацией кастомными скриптами:

• Где ломается: требует поддержки собственных скриптов, не проверяет контрольные суммы и не управляет транзитивными зависимостями.
• Что делает csk: вычисляет граф зависимостей скиллов, фиксирует точные хеши содержимого и изолирует сгенерированные файлы.

Инструмент CocoaSkills доставляет скиллы и записывает объявления MCP в native project configs. csk не запускает MCP-серверы и не выполняет аутентификацию. Публичный реестр пакетов и runtime-среда агента остаются вне его задач.

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

1. Установите CocoaSkills одним из способов. На macOS предпочтителен Homebrew:

   Homebrew (рекомендуется на macOS; также Linux)

   brew tap ivanopcode/csk
   brew install cocoaskills
   

   uv tool

   UV_SYSTEM_CERTS=1 uv tool install cocoaskills
   

   pipx

   pipx install cocoaskills
   

   mise

   mise use -g pipx:cocoaskills@latest
   

   pip

   python -m pip install --user cocoaskills
   

   Для установки из Python-экосистемы нужны uv 0.13.4+ или pip 26.2.2+, включая pip в shared venv pipx. Обновление: uv self update, python3 -m pip install --upgrade pip, pipx upgrade-shared.

   One-liner на macOS загружайте актуальным Homebrew curl (при необходимости brew install curl):

   "$(brew --prefix)/opt/curl/bin/curl" -fsSL https://cocoaskills.org/install.sh | sh
   

   Скрипт проверяет версии и выбирает uv, затем pipx, затем pip; uv запускается с UV_SYSTEM_CERTS=1. install.sh предназначен только для POSIX shell на macOS и Linux, не для установки на Windows. На Linux используйте актуальный curl. Пока macOS не обновит /etc/ssl/cert.pem, не используйте /usr/bin/curl для этой загрузки, а Apple git настройте на обновлённый bundle Homebrew:

   git config --global http.sslCAInfo "$(brew --prefix)/etc/ca-certificates/cert.pem"
   

   На Linux обновите пакет ca-certificates средствами дистрибутива: системные curl, git и Python читают его хранилище. Go-бинарники без встроенного x509 blocklist при проверке доверия полагаются только на этот системный bundle.

   На Windows Git for Windows по умолчанию использует OpenSSL и собственный bundle. Предпочтителен Schannel, чтобы применялось уже обновлённое хранилище Windows:

   git config --global http.sslBackend schannel
   

   Python с python.org использует хранилище Windows; минимумы uv 0.13.4+ и pip 26.2.2+ остаются теми же. Устанавливайте через Python-инструменты выше, без install.sh.

   Для приватных HTTPS-репозиториев сборки csk передаёт токен оператора в git на время fetch. На macOS перед использованием HTTPS build token убедитесь, что git доверяет обновлённому bundle; настройка обычных вызовов git показана выше (http.sslCAInfo). Изолированный fetch csk не читает пользовательскую и системную Git-конфигурацию; csk выбирает bundle самостоятельно, удаляет CA из встроенного списка отказа и закрепляет приватную PEM-копию. Для явного выбора используйте CSK_GIT_CA_BUNDLE или git.https_ca_bundle. Доступ к сборкам по SSH это не затрагивает.

   Подробности проверки клиентов и доверия хоста — в справочнике.

   Результат: команда csk --version выводит версию CocoaSkills.

2. Перейдите в каталог проекта и инициализируйте конфигурацию:

   cd /path/to/project
   csk init
   

   Результат: команда создаёт манифест Skillfile.json с начальной конфигурацией проекта и записывает блок директорий .agents/, .claude/skills/, .codex/skills/, .cursor/rules/, .gemini/skills/ и файла Skillfile.dev.json в локальный $GIT_COMMON_DIR/info/exclude. .gitignore не меняется. Linked worktrees используют общий exclude-файл.

3. Добавьте объявление скилла в проект:

   csk add skill-tracker --git git@gitlab.example.com:skills/skill-tracker.git --tag v1.0.0
   

   Результат: команда записывает объект скилла с именем skill-tracker, указанным репозиторием и тегом v1.0.0 в массив skills файла Skillfile.json.

4. Выполните установку объявленных скиллов:

   csk install
   

   Результат: установщик скачивает репозиторий, извлекает файлы скилла в .agents/skills/skill-tracker/, генерирует адаптеры для указанных агентов и создаёт исполняемые шимы в .agents/bin/ для скиллов с командами.

5. Проверьте доступность скилла в подключённом агенте:

   claude
   

   Результат: агент считывает инструкции из адаптера .claude/skills/ и применяет правила скилла skill-tracker в текущей сессии.

Приватные репозитории сборки: за один Enter

Скомпилированные команды скилла могут собираться из отдельно запиненного git-репозитория. Если репозиторий приватный, при первой установке csk показывает обнаруженные варианты (ssh-agent, ваши *.pub): вы выбираете вариант на терминале (по умолчанию предлагается вариант "агент + пин ключа"), указываете скоуп, и выбор сохраняется в конфиг. В CI то же самое задаётся заранее:

csk config build-ssh add gitlab.example.com/portals/infra \
    --agent auto --identity ~/.ssh/work.pub

Приватный репозиторий сборки работает и по SSH, и по HTTPS. Для HTTPS ничего заводить не нужно, если вы уже клонируете по HTTPS: csk предложит переиспользовать ваши собственные креды Git при первой установке за один Enter. Для неинтерактивного случая выполните команду:

csk config build-https add gitlab.example.com/portals/infra --token-source git-credentials

В CI задайте переменную CSK_BUILD_HTTPS_TOKEN (и CSK_BUILD_HTTPS_HOST, если репозитории сборки живут на разных хостах).

Пакет скилла выбрать креды не может: выбор делает только оператор и только явно. Подробности устройства брокеров кредов и скоупов описаны в docs/external-build-repositories.md.

Режимы установки скиллов

Установщик поддерживает три режима установки скиллов в зависимости от зоны ответственности и способа распространения файлов.

Проектный режим

Проектный режим фиксирует скиллы в файле Skillfile.json в корне репозитория. Разработчики коммитят этот файл в систему контроля версий. Вызов csk install на любой машине разворачивает одинаковый набор скиллов для всех участников команды.

Проектный Skillfile.json поддерживает schema 1, 2 и 3.

Схема 2 является основным форматом проектного Skillfile. Она объявляет источники и выбирает скиллы через селекторы. Команды csk check, csk install, csk upgrade и csk status поддерживают её по умолчанию.

Пример Skillfile.json схемы 2:

{
  "schema_version": 2,
  "project": { "alias": "demo-ios" },
  "agents": ["claude_code", "codex_cli", "cursor"],
  "sources": {
    "local": { "path": "." }
  },
  "skills": [
    {
      "name": "skill-tracker",
      "from": "local",
      "directory": "skills/skill-tracker"
    }
  ]
}

При работе со схемой 2 команда csk install выполняет начальную установку или устанавливает по файлу Skillfile.lock.json, команда csk upgrade явно обновляет лок, а csk status показывает актуальность манифеста и лока без записи. Команда csk check проверяет Skillfile без установки. Сетевые источники подчиняются файлу source-policy.json, который находится в ~/.cocoaskills/source-policy.json (путь переопределяется через CSK_SOURCE_POLICY). Подробное описание работы со схемой 2 приведено в docs/skillfile-sources.md.

Коммитьте Skillfile.lock.json вместе со Skillfile.json. На новой машине csk install восстанавливает отсутствующий снимок. Для path команда читает текущие байты. Для git и repository она получает точный commit из лока. Установка продолжится при совпадении идентичности и content_sha256. Расхождение вызывает source_snapshot_changed. Недоступный источник вызывает source_snapshot_unavailable и указывается в сообщении. Восстановление не меняет лок и не разрешает теги или ветки. csk upgrade явно обновляет лок по текущим источникам.

Схема 1 остаётся поддерживаемым legacy-форматом. Она напрямую объявляет список скиллов в секции skills:

{
  "schema_version": 1,
  "project": { "alias": "demo-ios" },
  "agents": ["claude_code", "codex_cli", "cursor"],
  "skills": [
    {
      "name": "skill-tracker",
      "git": "git@gitlab.example.com:skills/skill-tracker.git",
      "tag": "v1.0.0"
    }
  ]
}

Как добавить MCP-сервер

Schema 3 добавляет к schema 2 поле mcp_servers. MCP-сервер даёт агенту (Claude Code, Codex CLI, Cursor) доступ к внешней системе. Сервер описывается в project Skillfile со "schema_version": 3, а csk install записывает его в конфиги агентов в проекте.

{
  "schema_version": 3,
  "agents": ["claude_code", "codex_cli", "cursor"],
  "skills": [],
  "mcp_servers": { "docs": "https://mcp.example.com/mcp" }
}

1. Добавьте сервер в mcp_servers: строку с URL или объект server/install, если нужен токен или локальная программа.
2. Запустите csk check: он проверяет объявления без записи и без сети.
3. Запустите csk install в терминале. Если сервер запускает программу на вашей машине или передаёт токен, csk покажет точную команду и спросит согласие [y/N]. Без терминала согласие дать нельзя.
4. csk status покажет current для каждой записи.
5. Войдите в сервис в самом агенте. csk не запускает серверы, не выполняет вход и не хранит токены: в Skillfile указывается только имя переменной окружения.

Stdio host admission observes bounded current-platform native headers without executing commands. Windows checks both modeled libuv and Rust PATH choices, including quoted entries and dotted-name fallback. The 1024-byte selected-file and 2-byte opaque-interpreter reads do not prove full loader or architecture validity; implicit Windows search directories remain outside the model. See the command admission boundary.

server.environments accepts the canonical ids claude_code, codex_cli, opencode, pi, muse. Without this selector, csk writes Claude Code, Codex CLI and csk-local Cursor independently of skill agents. Use "environments": ["claude_code"] to narrow it; add a separately approved Cursor destination with csk mcp local-target add cursor --server docs. Legacy Cursor selectors require csk mcp migrate before normal Skillfile edits. See the local-target and migration commands.

Ignore placement is project-local. In 0.21.x, a legacy top-level ignore_mode field continues to determine the effective mode until explicit migration removes it. Without that field, a managed CocoaSkill block in .gitignore selects gitignore; otherwise csk uses $GIT_COMMON_DIR/info/exclude. show names the source as a deprecated field, a managed block, or the default. Run csk ignore-mode show to inspect it, or csk ignore-mode set exclude / csk ignore-mode set gitignore to move the managed rules. User rules are preserved. The legacy top-level ignore_mode is input-only in schema 2/3: every load warns that other managers reject it, and ordinary Skillfile writers refuse with skillfile_deprecated_form. An explicit mode switch removes only that member without reformatting the Skillfile. Invalid legacy values still report ignore_mode_invalid; schema 1 cannot contain the field. A Skillfile is portable only after its deprecated forms have been migrated; 0.22 stops reading them. Outside a Git worktree, a switch refuses.

CocoaSkill хранит отдельный блок для каждого проекта/worktree между # CocoaSkill project <key> и # End CocoaSkill project <key>. Непрозрачный ключ определяется метаданными worktree и путём к корню проекта относительно репозитория. При обновлении меняется только собственный блок; остальные блоки и пользовательские байты остаются без изменений. Все операции записи выполняются по очереди под OS lock в постоянном файле $GIT_COMMON_DIR/csk-exclude.lock. При завершении процесса ОС освобождает lock; replay и rollback транзакции объединяют с текущим файлом только записанный блок проекта. Не удаляйте lock-файл, пока csk работает. Старые exclude-блоки без ключа сохраняются как существующие правила; удаляйте устаревшие записи вручную.

HTTP headers задаются в install.headers. Для токена используйте env reference, для несекретной настройки — literal:

{
  "install": {
    "headers": {
      "Authorization": { "env": "API_TOKEN", "prefix": "bearer" },
      "X-Scope": { "value": "issues,merge_requests" }
    },
    "auth": { "kind": "oauth" }
  }
}

OAuth совместим с headers. Env reference требует consent, одни literals — нет. Literal values ограничены 1024 UTF-8 bytes; секретные имена, совпадения secret scanner, $ и управляющие символы запрещены. Допустимые префиксы: none, bearer (только для Authorization), api-token и token. Codex отклоняет последние два с mcp_header_prefix_unsupported; для них явно выберите Claude Code/Cursor. См. recipes Allure и GitLab и полные ограничения.

Для stdio-серверов действуют ограничения:

• Точная версия пакета. npx принимает только пакет@1.2.3, uvx только пакет==1.2.3.
• Менеджеры пакетов и интерпретаторы только как сама команда. npx, node, python, sh и подобные не могут стоять в аргументах. Поэтому обёртки вроде find -exec npx pkg отклоняются.
• Системные программы ОС не могут быть MCP-сервером. Исключения: xcrun mcpbridge и safaridriver --mcp.
• На Windows .cmd и .bat не поддерживаются. Нужна обычная программа .exe или .com.
• Остальные программы запускаются как есть. csk показывает их точную команду, но не может проверить, что они делают внутри.

Для MCP helper внутри приложения укажите идентичность издателя и расположение для каждой платформы вместо абсолютного пути. Например, добавьте в mcp_servers:

{
  "proxyman": {
    "server": {
      "transport": "stdio",
      "launcher": {
        "macos": {
          "bundle_id": "com.proxyman.NSProxy",
          "team_id": "3X57WP8E8V",
          "executable": "Contents/MacOS/mcp-server"
        },
        "windows": {
          "install_dir": "%LOCALAPPDATA%\\Programs\\Proxyman",
          "executable": "mcp-server.exe",
          "publisher": "TablePlus Inc",
          "trust": "allow-unverified"
        },
        "linux": {
          "path": "${XDG_CONFIG_HOME:-~/.config}/Proxyman/bin/mcp-server",
          "trust": "allow-unverified"
        }
      }
    }
  }
}

Сначала установите Proxyman, затем выполните csk check, csk install в терминале и csk status --check. csk показывает path/publisher/trust перед consent и пишет абсолютный путь прямо в native configs, без запуска приложения. Windows recipe — шаблон: проверьте точный Subject CN установленного helper. Другая подпись не разрешается через allow-unverified.

Windows roots определяются через OS known-folder API, включая перенесённые каталоги. Противоречащие им значения env отклоняются с mcp_launcher_root_conflict; ошибка API даёт mcp_launcher_known_folder_unavailable без env fallback. Trust определяется разрешённым каталогом, содержащим helper; при пересечении каталогов LocalAppData имеет приоритет над Program Files.

Изменение только содержимого при прежних path/trust/publisher информационное, включая разрешённый unverified helper. Изменение path/publisher или trust downgrade требует согласия. Невалидная подпись macOS/Windows блокирует установку и даёт untrusted в status, --check возвращает 1; bad signature нельзя понизить до unsigned. Crash recovery повторно проверяет сохранённую launcher observation до публикации. Старые command/HTTP journals восстанавливаются по записанным ledger targets без выдуманного launcher approval. Отсутствие launcher observation или неклассифицируемый сохранённый plan приостанавливает recovery; csk recover --rollback TRANSACTION_ID отменяет незавершённую публикацию, затем csk install рассматривает новый plan. Используйте тот же manager home и сохраняйте journal sidecars до успешного rollback. Rollback восстанавливает journaled file/symlink preimages. Пустые каталоги установки могут остаться, прежние directory modes не восстанавливаются: например, consent directory после сужения с 0750 до 0700 может остаться 0700. Rollback не расширяет directory permissions. transaction_cleanup_deferred означает committed install и необходимость повторить cleanup; transaction_rollback_deferred — необходимость recovery для rollback. Оба сохраняют journal, сообщают сохранённое состояние и возвращают 1; повторите csk install после восстановления затронутого приложения или publication boundary. См. launcher grammar и ограничения.

Примеры для GitLab и Allure TestOps и то, чего пока нельзя: примеры и ограничения.

Все поля, проверки и коды ошибок: MCP в project Skillfile и Troubleshooting.

Глобальный режим

Глобальный режим устанавливает скиллы один раз на компьютере пользователя в каталог ~/.cocoaskills/global/. Глобальные скиллы работают во всех каталогах вне зависимости от наличия git-репозитория и файла Skillfile.json.

Команда добавляет глобальный скилл в конфигурацию пользователя:

csk global add skill-metrics --git git@gitlab.example.com:skills/skill-metrics.git --tag v2.1.0

Команда csk global install скачивает репозиторий и записывает адаптеры в пользовательские директории агентов в домашнем каталоге.

Гибридный режим

Гибридный режим объявляет скиллы один раз на машине в файле ~/.cocoaskills/hybrid/Skillfile.json и активирует их для целевых проектов по алиасу, пути или глоб-шаблону. Установщик создаёт адаптеры в директориях агентов проекта (.claude/skills/, .codex/skills/) и шимы команд в .agents/bin/, но не требует коммитов в git-репозиторий. Платформенные команды используют гибридный режим для раскатки процессных правил и рабочих процессов на выбранные репозитории.

Команда связывает гибридный скилл с проектом по его алиасу:

csk hybrid add workflow-lint --git git@gitlab.example.com:skills/workflow-lint.git --tag v1.2.0 --target "demo-ios"

При запуске csk install внутри проекта demo-ios установщик проверяет правила в ~/.cocoaskills/hybrid/Skillfile.json, находит совпадение по алиасу demo-ios и подключает скилл workflow-lint в локальный контекст агентов.

Порядок перекрытия скиллов

При совпадении имён скиллов в разных режимах установщик применяет следующий порядок приоритета: проектный режим перекрывает гибридный режим, а гибридный режим перекрывает глобальный режим (проектный > гибридный > глобальный).

Команды

Раздел содержит обзор основных команд csk по пяти функциональным группам.

csk init [path]                     # Инициализирует Skillfile.json и локальные Git excludes
csk add <name>                      # Добавляет или обновляет объявление скилла в Skillfile.json
csk remove <name>                   # Удаляет объявление скилла из Skillfile.json
csk status [target]                 # Показывает статус установленных скиллов и манифеста
csk check [target]                  # Проверяет Skillfile без установки
csk list                            # Выводит список зарегистрированных проектов и скиллов
csk project add <alias> <path>      # Регистрирует путь проекта в глобальной конфигурации
csk project resolve [target]        # Показывает резолюцию манифеста и целевых путей

csk install [target]                # Устанавливает объявленные скиллы по локальным git-ссылкам
csk update                          # Выполняет git fetch для всех источников в skills_root
csk upgrade [target]                # Подтягивает обновления источников и выполняет установку
csk skill check <dir>               # Проверяет валидность структуры скилла и SKILL.md

csk global init                     # Создаёт глобальный манифест ~/.cocoaskills/global/Skillfile.json
csk global add <name>               # Добавляет объявление скилла в глобальный манифест
csk global remove <name>            # Удаляет скилл из глобального манифеста
csk global list                     # Выводит список объявленных глобальных скиллов
csk global status                   # Показывает статус установки глобальных скиллов
csk global install                  # Устанавливает глобальные скиллы в профиль пользователя
csk global update                   # Подтягивает git-источники глобальных скиллов
csk global upgrade                  # Подтягивает git-источники и устанавливает глобальные скиллы
csk hybrid add <name>               # Связывает гибридный скилл с целевыми проектами
csk hybrid remove <name>            # Удаляет объявление гибридного скилла
csk hybrid list                     # Выводит список гибридных скиллов и привязок
csk hybrid status                   # Показывает статус гибридных скиллов и хранилища

csk audit [target]                  # Запускает статический аудит безопасности скиллов
csk gc                              # Очищает неиспользуемые runtime-записи и кэш сборок

csk bootstrap                       # Создаёт глобальную конфигурацию ~/.cocoaskills/config.json
csk config show                     # Выводит путь и содержимое текущей конфигурации
csk shell-init                      # Генерирует или устанавливает код хука shell для PATH

Полное описание команд, флагов, позиционных аргументов и примеров использования находится в файле docs/cli.md.

Источники Skillfile schema 2

Схема 2 является основным форматом проектного Skillfile и поддерживается командами csk check, csk install, csk upgrade и csk status без дополнительной настройки. Схема 1 остаётся поддерживаемым legacy-форматом.

Настройка experimental.skillfile_sources и переменная CSK_EXPERIMENTAL_SKILLFILE_SOURCES сохраняют совместимость со старыми конфигурациями и не влияют на выбор схемы.

Команды переиспользуют общий интерфейс: csk install выполняет начальную установку или установку по локу, csk upgrade явно обновляет лок, csk status показывает актуальность без записи, а csk check проверяет Skillfile без установки. Команды установки читают источники path с диска, а источники git и repository получают через ограниченный транспорт по машинной политике source-policy.json. Руководство для авторов и операторов находится в docs/skillfile-sources.md. Историческое решение зафиксировано в RFC 0009.

Development tools

Перед каждым запуском git csk выбирает и проверяет CA bundle, затем закрепляет приватную копию оставшихся исходных PEM-блоков на время операции. CA из встроенного списка отказа удаляются; предупреждение git_trust_anchor_distrusted один раз за процесс называет CA и исходный путь. Пустой после фильтрации или повреждённый bundle вызывает git_trust_anchor_invalid. Проверка охватывает SSH, локальные команды и URL rewrites, которые могут привести к HTTPS. Собственный актуальный PEM-файл задаётся через CSK_GIT_CA_BUNDLE или git.https_ca_bundle глобальной конфигурации. Порядок выбора и отказы.

• uv installs the development environment and builds release artifacts. Run uv sync --extra dev and uv build --out-dir .temp/dist; build outputs stay under .temp/dist/.
• pytest and pytest-xdist run the test suite. Run uv run pytest -q for the full suite or focused test paths; temporary output belongs under .temp/ or an external short-lived temp directory.
• Go собирает команды go-v1 выбранным оператором go из PATH; проверьте его командой go version. Квалифицированы семейства 1.26 (от 1.26.10) и 1.27 (от 1.27.3). Более ранние и prerelease-версии этих семейств отклоняются с insecure_go_release, семейства 1.25 и старше — с unsupported_go_family. Строка remediation: предлагает поставить Go 1.27.3 или новее первым в PATH: например, go = "1.27.3" в проектном .mise.toml либо brew upgrade go. Порог нужен для исправленной проверки TLS-сертификатов: собранные CLI включают стандартную библиотеку выбранного Go. Новая версия тулчейна меняет cache key; следующая установка или обновление пересобирает CLI. Семейства новее 1.27 принимаются с предупреждением; строгий отказ задаётся через builds.go_future_families = "refuse" или CSK_GO_FUTURE_FAMILIES=refuse. CI закрепляет Go 1.26.10 и 1.27.3 через actions/setup-go@v7 в .github/workflows/ci.yml; кэш сборок находится в <csk-home>/builds/go-v1/.
• mypy performs strict source type checking. Run uv run mypy; it writes no persistent artifact unless output is redirected to .temp/.
• uv run python tests/audit_secrets_mutants.py runs the audit security narrowing mutants in disposable copies, including review regressions, and names each failing regression. Select a focused set with uv run python tests/audit_secrets_mutants.py raw-echo-if or run uv run pytest -q tests/test_usage_error_closure.py for the parser closure regressions. Save output under .temp/<TASK-ID>/.
• uv run python tests/repointed_tags_mutants.py checks fetch and strict-tag narrowing mutants against the real CLI regressions in disposable copies. Logs and the named failing tests go under .temp/repointed-tags-mutants/.
• Launcher PATH has a manager-owned prefix and a dependency suffix. The prefix holds only the skill bin directory and the manager interpreter directory and never depends on manifest content. Dependency directories resolve through the manager's tool_paths resolver and are appended after the inherited PATH, so the caller's PATH always wins. Run uv run pytest -q tests/test_launcher_tool_paths.py tests/test_tool_paths.py tests/test_tool_paths_symlinks.py tests/test_shims.py to check prefix independence, shim exclusion, symlink chains, refusal before publication, suffix order, and legitimate dependency launch. Save validation logs under .temp/.
• /usr/bin/codesign — системный macOS trust verifier для app-bundled MCP launchers; Xcode CLT не требуется. Запускайте uv run pytest -q tests/test_mcp_launchers.py tests/test_mcp_launcher_lifecycle.py для grammar, trust и consent controls. macOS test с csk_e2e_native проверяет установленный Proxyman и меняет bytes только в disposable copy. Сохраняйте logs в .temp/; поиск приложения и проверка signature не записывают project state.
• Windows использует системные wintrust.dll/crypt32.dll через ctypes для Authenticode; Linux — абсолютные /usr/bin/dpkg или /usr/bin/rpm для package ownership. Запускайте uv run pytest -q tests/test_mcp_authenticode.py tests/test_mcp_launcher_platforms.py tests/test_mcp_launcher_platform_lifecycle.py для переносимых controls, а uv run pytest -q -m csk_e2e_native tests/test_mcp_launcher_platform_native.py на Windows/Linux — для проверки реальных системных механизмов. Native tests пропускаются только на другой платформе; храните logs в .temp/ и явно отмечайте недоступные платформы.
• csk recover --rollback TRANSACTION_ID восстанавливает записанные preimages незавершённой transaction под manager lock; committed transactions отклоняются. Пустые каталоги установки могут остаться, прежние directory modes не восстанавливаются и не расширяются. Запускайте uv run pytest -q tests/test_mcp_legacy_recovery.py tests/test_transaction_commit_guard.py в обычном Git checkout для crash fixtures released CLI и rollback controls; сохраняйте logs в .temp/.
• PyYAML используется только в dev extra как независимый oracle для дифференциальных тестов frontmatter. Запускайте uv run pytest -q tests/test_frontmatter_differential.py; постоянные артефакты теста не создаются.
• actionlint validates GitHub Actions workflows. Run actionlint .github/workflows/ci.yml; validation logs belong under .temp/.
• .scripts/release.sh cuts and publishes signed stable releases. Run .scripts/release.sh 0.18.4 --wb-notes .temp/wb-release-0.18.4.md from a clean, current main checkout; use --dry-run to print every release step. Use .scripts/release.sh 0.20.0 --no-wb to defer the mirror without requiring glab or notes, then publish only that stage later with .scripts/release.sh 0.20.0 --resume-from wb --wb-notes .temp/wb-release-0.20.0.md. If distribution smoke fails, run its printed gh run rerun <run-id> --failed command manually, then resume with .scripts/release.sh 0.18.4 --resume-from verify. It requires gh, delivery, a loaded SSH signing key, curl, and mise; glab is required only when publishing the mirror stage. See RELEASING.md for the gates, Wildberries steps, and output behavior. It creates a local release branch and signed tag; published build artifacts stay in GitHub Actions and no local release log is retained.
• GitHub Actions runs the cross-platform CI matrices. The merge protocol lane keeps full Linux/macOS coverage and uses the checked-in .research/ manifest, classification, and verifier for six deterministic Windows shards. Each Windows shard uploads its collected inventory, selected node IDs, verifier provenance, and JUnit XML as a workflow artifact.

Дальше

Документация и справочные материалы CocoaSkills:

• docs/cli.md: справочник команд csk, флагов и кодов завершения.
• docs/reference.md: справочник по матрице установки, зависимостям скиллов, манифестам и аудиту безопасности.
• docs/external-build-repositories.md: устройство внешних репозиториев сборки, брокеров кредов SSH/HTTPS и моделей доступа.
• docs/design/linux-go-v1.md: Linux source-build design proposal, protocol requirements, qualification gates, and pending native probes.
• docs/skillfile-sources.md: источники Skillfile schema 2, машинная транспортная политика и семантика лока.
• docs/v0.16-design.md: RFC 0009, запись проектного решения о формате источников schema 2 (на английском).
• ARCHITECTURE.md: описание внутренней архитектуры, схемы работы конвейера установки, формата хранилищ и модели безопасности.
• SECURITY.md: политика безопасности, границы изоляции и рекомендации по настройке.
• docs/skill-authoring.md: руководство по структурированию пакетов скиллов, объявлению команд и настройке манифеста agent-skill.json.
• docs/authoring-cli-commands.md: руководство по поставке CLI-утилит в скиллах (Go, скрипт-команды, ограничения компилятора и планируемые языки).
• docs/troubleshooting.md: диагностика ошибок установки, миграция со старых версий и решение частых проблем.
• CHANGELOG.md: история релизов и список изменений по версиям.

Лицензия

Проект распространяется на условиях лицензии Apache 2.0.

MCP alias inventory tool

Run PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=src uv run python .scripts/scan_mcp_evaluator_aliases.py > .temp/macos-evaluator-aliases.json from the repository to audit system executable aliases without running them. The scanner reads /usr/bin, /bin, /usr/sbin and /sbin; its dated output records symlink, inode, shebang and literal exec evidence, plus unreadable-file limits. Reviewed snapshots and package source links live in tests/fixtures/mcp/macos-evaluator-aliases.json and tests/fixtures/mcp/packaged-evaluator-aliases.json. Restricted editor aliases and scripts interpreted by a refused program are conservatively refused too.

Run PYTHONDONTWRITEBYTECODE=1 uv run python .scripts/scan_mcp_base_commands.py > .temp/macos-base-commands.json for a name/stat-only base-system snapshot. Review it with the documented package families in tests/fixtures/mcp/base-system-commands.json; runtime policy data is committed in src/csk/mcp_base_commands.py. Neither scanner executes programs.