deepseek-harness-adapter

Адаптирует SKILL.md и связанные ресурсы, написанные для другого ИИ-агента, под DeepSeek Harness с сохранением назначения, ограничений и проверяемого поведения. Применяй, когда пользователь просит порт

SKILL.md

GitHub

DeepSeek Harness Adapter

Ты переносишь скилы между агентными средами. На входе может быть текст SKILL.md, каталог скила или набор инструкций и ресурсов. На выходе создай рабочую версию для DeepSeek Harness и краткий отчёт о совместимости.

Основной принцип

Сохраняй пользовательское назначение и наблюдаемое поведение исходного скила. Меняй только оболочку, формат метаданных, обращения к инструментам и предположения о среде, которые не поддерживаются DeepSeek Harness. Не выдумывай API Harness: если его точный контракт не предоставлен, используй нейтральные термины и явно пометь место, требующее настройки.

Рабочий процесс

  1. Прочитай исходный SKILL.md полностью и перечисли его входы, выходы, триггеры, обязательные инструменты, побочные эффекты и ссылки на ресурсы.
  2. Определи целевой контракт DeepSeek Harness из файлов проекта, пользовательского описания или доступной документации. Приоритет: явные требования пользователя, затем локальные файлы проекта, затем общие безопасные предположения.
  3. Раздели инструкции на переносимые и зависящие от платформы. Переноси логику задачи, критерии качества, ограничения безопасности и правила эскалации; переписывай только несовместимый слой интеграции.
  4. Преобразуй метаданные в формат, который ожидает целевой Harness. Сохрани уникальное имя, сделай описание discriminating и не включай в него длинный процесс.
  5. Адаптируй вызовы инструментов: замени несуществующие имена на абстрактные роли (read_file, write_file, run_check) только если это соответствует контракту Harness; иначе оставь явный адаптационный слой или пометку CONFIGURE_FOR_HARNESS.
  6. Проверь ссылки на references/, scripts/ и assets/. Не создавай пустые ресурсы и не удаляй существующие без необходимости.
  7. Добавь короткий раздел «Ограничения совместимости» с тем, что перенесено, что заменено и что требует настройки.
  8. Проведи структурную проверку YAML frontmatter, имени каталога, ссылок и отсутствия незаполненных TODO. Если доступен валидатор проекта, запусти его.

Правила адаптации

  • Не смешивай инструкции исходного скила с инструкциями самого Harness: платформенные детали держи в отдельном разделе или reference-файле.
  • Не переносись буквально упоминания OpenAI/Codex, если они описывают только инструменты, UI или политики исходной среды. Смысловые требования сохрани.
  • Не меняй область разрешённых действий, секреты, правила подтверждения и деструктивные операции. Если Harness не умеет подтверждения, остановись перед внешней мутацией и попроси явное решение.
  • Секреты никогда не встраивай в результат; используй переменные окружения или механизм секретов целевой среды.
  • Если исходный скил рассчитан на несколько режимов, сохрани маршрутизацию и чётко укажи, какие reference-файлы читать для каждого режима.
  • Код в ресурсах оставляй рабочим: сохраняй типизацию, обработку ошибок и комментарии, но исправляй только платформенные несовместимости.

Формат результата

Верни или сохрани:

  1. Адаптированный каталог с обязательным SKILL.md.
  2. agents/openai.yaml только если целевая установка действительно использует этот UI-слой; иначе не добавляй его автоматически.
  3. Список совместимости: сохранено, изменено, требует настройки.
  4. Команду или последовательность действий для установки и проверки в DeepSeek Harness.

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

Для подробной матрицы преобразований прочитай references/compatibility-matrix.md.