SkillFoxx
Telegram

codex-deepseek-subagent — скилл

Скилл настраивает DeepSeek встроенным субагентом настольного Codex на macOS и Windows и проверяет маршрут запросов

  • 394 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл меняет конфигурацию Codex и каталог моделей, перед записью создает резервные копии
  • Код и контекст, которые вы отдаете субагенту, уходят в API DeepSeek по вашему ключу
  • Ключ DeepSeek хранится в системном хранилище и подставляется в процесс настройки
Все причины и проверки

oil-oil/codex-deepseek-subagentАвтор:oil-oil

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/codex-deepseek-subagent

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл меняет конфигурацию Codex и каталог моделей, перед записью создает резервные копии
  • Код и контекст, которые вы отдаете субагенту, уходят в API DeepSeek по вашему ключу
  • Ключ DeepSeek хранится в системном хранилище и подставляется в процесс настройки

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

codex-deepseek-subagent настраивает и обслуживает DeepSeek как встроенного субагента настольного приложения Codex. Скилл нужен для первичной настройки, проверки состояния и живого теста, для ремонта после смены родительской модели, а также для отключения и удаления конфигурации. Обычные задачи по коду он не выполняет. Сначала Codex просит выбрать модель: DeepSeek V4 Flash быстрее и дешевле для повседневного кода, DeepSeek V4 Pro сильнее на сложных и агентных задачах. Если ключа нет, скилл открывает локальную страницу настройки и сохраняет ключ в системное хранилище: Keychain на macOS или Credential Manager на Windows. В чат ключ вводить не требуется. После установки роль лежит в `$CODEX_HOME/agents/DeepSeek.toml` (по умолчанию `~/.codex`). Проверка считается успешной по двум признакам: в базе сессии записаны провайдер, модель, уровень рассуждения и роль, а субагент вернул контрольное слово `NATIVE_DEEPSEEK_OK`. Дальше основной агент вызывает субагента по запросу вроде «проверь проект через DeepSeek».

Для кого. Пользователям настольного Codex с ключом DeepSeek, которые хотят отдавать часть задач субагенту на DeepSeek и не править конфигурацию вручную.

Подходит, если

  • Впервые подключаете DeepSeek к Codex и хотите, чтобы ключ ушел в системное хранилище, а не в чат
  • После смены родительской модели субагент перестал находиться, и конфигурацию надо починить
  • Нужно переключить субагента между V4 Flash и V4 Pro с повторной проверкой
  • DeepSeek больше не нужен, и конфигурацию надо отключить или удалить с откатом

Не подходит, если

  • Агент работает в Codex CLI без настольного приложения: скилл рассчитан только на настольный Codex
  • Система не macOS и не Windows, или нет Python 3.11: скрипт управления на них не запустится
  • Субагенту надо обрабатывать изображения и скриншоты: DeepSeek читает только текст, картинки сначала описывает родительский агент
  • Нужно просто выполнять задачи по коду: скилл только настраивает субагента, а сам задач не решает

Пример запроса к агенту

Помоги настроить DeepSeek как нативного субагента Codex

Ограничения

Нужны macOS или Windows, Python 3.11 и новее, настольное приложение ChatGPT/Codex и официальный ключ DeepSeek API. Скилл рассчитан на настольный Codex и не претендует на работу с другими агентами. DeepSeek обрабатывает только текст, а изображения и видео должен сначала описать родительский агент. После успешной настройки перезапустите приложение и откройте новую задачу. Разделы про совместимость и откат изменений ведут в `references/compatibility.md`. Последнее изменение в репозитории от сентября 2026 года.

Как отключить. Попросите агента отключить или удалить конфигурацию: скилл вызовет `disable` или `uninstall`. Файл роли `DeepSeek.toml` лежит в `$CODEX_HOME/agents/`.

Частые вопросы

Что нужно, чтобы подключить DeepSeek к Codex этим скиллом?

Настольное приложение Codex на macOS или Windows, Python 3.11 или новее и ключ DeepSeek API. Установка одна: `npx skills add oil-oil/codex-deepseek-subagent -g -y`, затем перезапуск приложения.

Где хранится ключ DeepSeek?

В системном хранилище: Keychain на macOS или Credential Manager на Windows. Файлы конфигурации, временные файлы и вывод тестов ключа не содержат.

Как понять, что настройка сработала?

Скилл должен вывести статус `ready`. Проверка требует, чтобы в базе сессии стояли провайдер `deepseek`, выбранная модель и роль `DeepSeek`, а субагент вернул `NATIVE_DEEPSEEK_OK`.

Что делать после смены основной модели в Codex?

Попросить агента выполнить `repair`. Для смены модели субагента подойдет `repair --model deepseek-v4-pro` или `repair --model deepseek-v4-flash`.

Как вызвать субагента в обычной работе?

Скажите: «Используй субагента DeepSeek, чтобы проверить проект». Вызов делает основной агент через `spawn_agent` с ролью `DeepSeek`. Если инструмент не знает роль, откройте новую задачу.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

MCP-сервер запускает DeepSeek или локальную модель субагентом в Claude Code и Codex с собственным циклом инструментов.

MCP-серверШирокий доступ59

Плагин Codex поручает подзадачи субагентам на других провайдерах моделей и не меняет провайдера основной сессии

ПлагинШирокий доступ219
Выбор редакции

Агент OpenAI для программирования, который работает локально в терминале, с версиями для IDE и десктопа

CLIШирокий доступ135,1 тыс.

Конфигурация OpenCode v2 на одной модели DeepSeek Flash: агенты, команды и 23 скилла, роли различаются уровнем рассуждения.

ВоркфлоуРасширенный доступ60

Скилл связывает два-четыре открытых окна Codex CLI: один распределяет работу, другие выполняют, сверяют и сдают результат.

СкиллРасширенный доступ105

Awesome Codex Subagents

awesome-codex-subagents

Более 130 специализированных субагентов для Codex по категориям. Есть роли безопасности, например этичное тестирование проникновения. Список без своего кода

ПлагинРасширенный доступ6,5 тыс.

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
codex-deepseek-subagent (эта карточка)нет394
DeepSeek Bridge для Claude CodeнетAPI-ключ2MCP-сервер, который передает работу с файлами локальному агенту DeepSeek Harness, а здесь DeepSeek подключается субагентом Codex
DeepSeek Harnessда280 265отдельный агент DeepSeek с плагинной архитектурой, а здесь настройка DeepSeek внутри Codex

Коротко о README

Описание на китайском определяет область применения скилла, показывает схему настройки и пошаговый быстрый старт. Дальше перечислены нюансы совместимости, команды управления для macOS и Windows, правила хранения ключа и отката, а также оговорка о том, что проект не связан с OpenAI и DeepSeek.

Бейдж для README

Исходный SKILL.md

---
name: codex-deepseek-subagent
description: "配置和维护 Codex 桌面应用中的 DeepSeek 原生子 Agent，支持模型选择、路由验证、修复、停用和卸载。仅在用户要求配置或管理该集成时使用；普通 API 问题与配置后的日常编码任务不触发。"
---

# Codex DeepSeek 子 Agent

本 Skill 只维护配置，不承接日常用户任务。确定性的文件、模型目录和凭据操作交给 `scripts/codex_deepseek.py`；不要手动改 TOML、JSON、Agent 文件或系统凭据库。

## API Key 配置入口

需要外部服务凭据时先读[API Key 配置与业务读取](references/api-key-setup.md)：复用已有安全入口；本机缺少 Key 时使用随附固定页面，保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。

## 关键契约

- 只使用桌面应用内置的 Codex 运行时；版本仅用于诊断，兼容性以真实派发验收为准。
- 从桌面配置读取父模型，并由管理程序应用 v1 明文派发设置；不要硬编码父模型或手改配置。技术原因见 [references/compatibility.md](references/compatibility.md)。
- 父模型变化后必须运行 `repair`，再重新验收。
- 支持 `deepseek-v4-flash` 与 `deepseek-v4-pro`。Flash 更快、更省；Pro 能力更强，适合复杂 Agent 任务。两者默认思考程度均为 `high`。
- DeepSeek 是纯文本 Agent，不处理图片、视频、截图或其他视觉输入。父 Agent 先识别视觉内容，再传入文字事实。
- 日常任务只能直接调用：

  ```text
  spawn_agent(agent_type="DeepSeek", fork_turns="none", ...)
  ```

  不要为日常任务运行本 Skill、管理脚本或 `codex exec`。
- 当前工具若不认识 `DeepSeek` 角色，只提示用户打开新任务或重启 Codex；不得改用默认角色、脚本或 `codex exec` 代做当前任务。

## 触发后的流程

1. 运行 `status --json`，根据结构化状态继续，不靠文件名猜测。
2. 首次配置时，如果用户没有指定模型，先让用户选择：`DeepSeek V4 Flash`（更快、更省）或 `DeepSeek V4 Pro`（能力更强，推荐复杂任务）。不要替用户静默选择。
3. 配置请求运行 `setup --model <模型> --json`；切换模型或修复配置时运行 `repair --model <模型> --json`。不传 `--model` 的 `repair` 会保留当前选择。
4. 缺少凭据时按配置说明展示固定页面，由用户保存后，经 run 入口运行 setup 并传 `--api-key-env`，接入运行时原生凭据；不在聊天中索要 API Key。`--api-key-stdin` 仅供可信凭据程序传递，不拼接密钥命令。
5. `setup`、`repair` 或 `test` 使用桌面内置运行时创建隔离验收会话。若返回 `new_task_required` 或 `restart_required`，提示用户重启桌面应用并打开新任务。
6. 验收必须检查子线程数据库 `threads` 表的实际元数据，并确认子 Agent 返回口令 `NATIVE_DEEPSEEK_OK`。实际 `model` 必须等于用户选择的模型，两者缺一不可。
7. 最终只汇报状态、实际 Provider、模型、思考程度、角色和备份位置；不要输出密钥或原始事件日志。

## 管理命令

入口。macOS 使用 `python3`，Windows 使用 `py -3`：

```text
python3 <skill-dir>/scripts/codex_deepseek.py <command> --json

Сообщить о проблеме