Skip to content

kydechuk01/deepseek-practices

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DeepSeek Practices — адаптация Claude Code Practices под opencode

Автор: Александр Климок, 2026 (адаптация на основе Claude Code Practices v1.7) Язык: русский

Настройте opencode один раз — и он будет помнить ваш контекст, проверять факты, работать по вашим правилам. И не терять рабочую нить: каждая новая сессия продолжает с того места, где предыдущая остановилась.

Адаптированные практики и рецепты для проектов под управлением DeepSeek (opencode).

Что нового (v1.3)

  • 13 адаптированных рецептов — включая сеансовую эстафету, мультиагентную работу, TDD, контракт до реализации, агенты-персоны пользователей, MCP-серверы, RTK-оптимизацию.
  • Плагин handoff-injector — двухслойная доставка эстафеты через session.created + session.compacting (~95% надёжности). Первый эмпирически подтверждённый handoff на opencode.
  • 5 агентов — code-reviewer, editor, researcher + self-test (самодиагностика пакета) + runbook-tracker (трекер задач).
  • Правило 7 «Надёжность доставки» — как заставить модель прочитать критичный файл, когда текста в AGENTS.md недостаточно. Трёхслойная доставка: instructions + плагин + AGENTS.md.
  • Полный чеклист START.md — 12 пунктов настройки от фундамента до масштабирования.

Отличия от Claude Code Practices

Claude Code opencode (DeepSeek)
CLAUDE.md — контекст проекта AGENTS.md — контекст проекта
~/.claude/ — глобальная конфигурация ~/.config/opencode/ — глобальная конфигурация
Агенты в ~/.claude/agents/*.md Агенты в .opencode/agents/*.md или opencode.json
Навыки в ~/.claude/commands/*.md Навыки в .opencode/skills/<name>/SKILL.md
SessionStart hook плагин session.created + session.compacting (~95%)
.claude/settings.json opencode.json / opencode.jsonc
Плагины marketplace (Superpowers) Плагины через npm/файлы .opencode/plugin/
/compact — ручная очистка контекста Автоматическая compaction (compaction.auto)
AI Factory — внешний инструмент План/билд — встроенные агенты opencode
Модели: opus/sonnet/haiku Модели: deepseek/v3, deepseek/r1 и др.
.claude/memory/ — директория памяти instructions + reference files (нет отдельной memory-директории)

Что внутри

deepseek-practices/
├── START.md              ← Точка входа — скажите opencode прочитать этот файл
├── recipes/              ← 13 рецептов: пошаговые инструкции для opencode
├── practices/            ← 9 практик: принципы и теория
├── docs/                 ← Шаблоны: эстафета, ловушки
├── reference/            ← Справочные материалы
├── VERSION.md            ← Версия и история изменений
└── README.md             ← Этот файл

recipes/ — главное. opencode читает рецепты и создаёт настройки под ваш контекст: AGENTS.md, агенты, навыки, плагины.

practices/ — теория и принципы. Полезно для понимания, но не обязательно для настройки.

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

Требования: opencode должен быть установлен. npm install -g opencode-ai

Шаг 1. Скачайте и распакуйте

Распакуйте архив куда удобно. Пакет — это справочник, а не программа.

Шаг 2. Откройте opencode в вашей рабочей папке

cd "D:\Работа\Мой проект"
opencode

Шаг 3. Скажите opencode одну фразу

Прочитай файл [путь к START.md] и проведи меня по настройке.

Ключевые принципы

  1. AGENTS.md — главный актив. Минута на качество экономит часы.
  2. Правила > надежды. Пропишите поведение AI явно.
  3. Агенты > промпты. Настроенный агент лучше длинного промпта.
  4. Память > повторение. Контекст в AGENTS.md + reference files, а не пересказ.
  5. Ответственность > угодливость. AI не должен молча делать глупость.
  6. Эстафета > перезапуск. Сессия передаёт состояние следующей.

Что даёт

Без практик С практиками
AI не знает контекст — объясняете заново каждый раз AGENTS.md хранит контекст, AI работает сразу
AI иногда додумывает то, чего нет Правила поведения требуют проверять факты
Один промпт — один запрос Агенты-специалисты решают типовые задачи
Контекст теряется между сессиями Трёхслойная доставка сохраняет состояние (~95%)
После паузы — заново «где остановились» Сеансовая эстафета: новая сессия читает ядро и продолжает
Каждая задача — с нуля Plan/Build + навыки: структурированный workflow

Настройка фундамента — 30 минут. Полный чеклист — 1–2 часа.

Чеклист настройки

Уровень Шаг Что даёт
Фундамент AGENTS.md AI знает контекст вашей работы
Фундамент Правила поведения AI проверяет факты, не выдумывает
Фундамент Голосовой ввод Скорость ввода значительно выше
Фундамент Разрешения Безопасность и скорость
Продуктивность Агенты Специалисты под ваши задачи
Продуктивность Навыки Автоматические процедуры
Продуктивность Сеансовая эстафета Полный снимок состояния перед паузой
Продуктивность Отслеживание прогресса Маркер «где я остановился»
Продуктивность Мультиагентная работа Несколько специалистов на одну задачу
Продуктивность Контракт / TDD Определи результат до начала работы
Продуктивность Агенты-персоны AI говорит от лица пользователя
Продуктивность Инвентаризация Порядок в проекте
Масштабирование MCP-серверы Документация, браузер, БД
Масштабирование RTK Экономия 50–99% токенов

Экономия токенов — RTK

RTK работает с opencode. См. recipes/optimize-tokens.md

Несколько проектов

Пакет скачивается один раз. Для каждого проекта запускайте START.md отдельно — откройте opencode в папке нужного проекта и передайте путь к START.md.

Обновление

  1. Скачайте новый ZIP с этой страницы
  2. Распакуйте в новую папку
  3. Запустите START.md в каждом проекте — opencode определит, что уже настроено, и предложит только новое

Удаление

Удалить пакет: просто удалите папку. Настройки продолжат работать.

Удалить настройки: скажите opencode: «Удали из AGENTS.md секции с метками [deepseek-practices]. Также удали агентов и навыки, созданные этим пакетом. Мои настройки не трогай».

Благодарности

Проект основан на Claude Code Practices v1.7 — публичном пакете практик для Claude Code. Адаптация под opencode/DeepSeek выполнена при участии Claude Opus 4.7 (аудит, ресерч hooks, ранбук) и DeepSeek V4 Pro (реализация).

Обратная связь

Нашли ошибку или хотите предложить улучшение? Откройте Issue в этом репозитории.

About

Адаптация Claude Code Practices для opencode/DeepSeek. 13 рецептов, 9 практик, 5 агентов, плагин handoff-injector (~95% доставки). Интерактивный чеклист. Russian.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors