К основному содержанию
команда CX Codex

migration — команда для Claude Code: перевод конфигов на AGENTS.md

Команда migration переносит CLAUDE.md, .cursorrules и другие файлы настроек ИИ в один AGENTS.md и ставит на него симлинки под каждый ассистент.

MIT ★ 763 обновлён 2026-03-31

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/migration.md
Открыть на GitHub

Что делает migration

Команда смотрит, какие файлы настроек ИИ уже лежат в проекте: CLAUDE.md, .clinerules, .cursorrules, .windsurfrules, .replit.md, .github/copilot-instructions.md, GEMINI.md, AGENT.md. Дальше сравнивает их размер и содержимое. Один файл — просто переименует в AGENTS.md. Несколько одинаковых — оставит приоритетный и навесит на него ссылки.

Симлинки создаются под каждый инструмент, включая старый AGENT.md. Для GitHub Copilot нужен каталог .github и ссылка ../AGENTS.md внутри, для Firebase Studio — .idx/airules.md. В конце покажет вывод ls -la, состояние git и напомнит просмотреть .bak перед удалением. Если нужна ещё и структура каталогов, следующим шагом зовут /agents-md:init.

Когда содержимое файлов различается, команда печатает размеры и текст и просит выбрать: автослияние, бэкапы с расширением .bak, выборочный перенос или ручной разбор. Разрешённых инструментов немного — mv, ln, ls, test, grep, echo и Read, поэтому файлы она двигает и линкует, а не редактирует. Бэкапы после миграции просматривают глазами: иначе легко потерять кусок инструкций.

Какие задачи решает

  • свести настройки пяти ассистентов в один AGENTS.md
  • убрать дубли CLAUDE.md и .cursorrules из репозитория
  • разложить симлинки под Cursor, Cline и GitHub Copilot
  • сохранить бэкапы конфликтующих конфигов перед слиянием
  • проверить, какие файлы настроек ИИ уже есть в проекте

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

  • Переведи конфиги проекта на AGENTS.md и поставь симлинки для Cursor и Copilot.
  • Покажи, какие файлы настроек ИИ лежат в репозитории, и чем они различаются.
  • Сделай бэкапы .cursorrules и .github/copilot-instructions.md, потом собери общий AGENTS.md.

Как установить migration

Вручную: положить файлы

.claude/commands/migration.md

Вызов — /migration. Для всех проектов — ~/.claude/commands/

Вопросы о migration

Как установить migration в Claude Code?

Файл команды кладут в .claude/commands/migration.md внутри проекта. После этого она вызывается как /migration.

Что делает migration?

Собирает разрозненные файлы настроек ИИ в один AGENTS.md и подставляет на него симлинки с именами, которых ждут конкретные инструменты.

Что будет, если конфиги различаются?

Команда покажет размеры и содержимое каждого файла и предложит на выбор автослияние, бэкапы .bak, выборочный перенос или пошаговый ручной разбор.

Исходный текст

migration.md · MIT
---
description: Migrate AI assistant configuration to AGENTS.md standard with universal compatibility
category: claude-setup
allowed-tools: Bash(mv:*), Bash(ln:*), Bash(ls:*), Bash(test:*), Bash(grep:*), Bash(echo:*), Read
---

# Convert to Universal AGENTS.md Format

This command helps you adopt the AGENTS.md standard by converting your existing CLAUDE.md file and creating symlinks for compatibility with various AI assistants.

## Current Project State
!`ls -la CLAUDE.md AGENTS.md AGENT.md GEMINI.md .cursorrules .clinerules .windsurfrules .replit.md .github/copilot-instructions.md 2>/dev/null | grep -E "(CLAUDE|AGENT|AGENTS|GEMINI|cursor|cline|windsurf|replit|copilot)" || echo "Checking for AI configuration files..."`

## Task

Convert this project to use the AGENTS.md standard following these steps:

### 1. Pre-flight Checks
Check for existing AI configuration files:
- CLAUDE.md (Claude Code)
- .clinerules (Cline)
- .cursorrules (Cursor)
- .windsurfrules (Windsurf)
- .replit.md (Replit)
- .github/copilot-instructions.md (GitHub Copilot)
- GEMINI.md (Gemini CLI)
- AGENTS.md (if already exists)
- AGENT.md (legacy, to be symlinked)

### 2. Analyze Existing Files
Check all AI config files and their content to determine migration strategy:

**Priority order for analysis:**
1. CLAUDE.md (Claude Code)
2. .clinerules (Cline)
3. .cursorrules (Cursor)
4. .windsurfrules (Windsurf)
5. .github/copilot-instructions.md (GitHub Copilot)
6. .replit.md (Replit)
7. GEMINI.md (Gemini CLI)

**Content Analysis:**
- Compare file sizes and content
- Identify identical files (can be safely symlinked)
- Detect different content (needs merging or user decision)

### 3. Perform Smart Migration

**Scenario A: Single file found**
```bash
# Simple case - move to AGENTS.md
mv CLAUDE.md AGENTS.md  # or whichever file exists
```

**Scenario B: Multiple identical files**
```bash
# Keep the priority file, symlink others
mv CLAUDE.md AGENTS.md
ln -sf AGENTS.md .cursorrules  # if .cursorrules was identical
```

**Scenario C: Multiple files with different content**
1. **Automatic merging** (when possible):
   - Different sections can be combined
   - No conflicting information
   - Clear structure boundaries

2. **User guidance** (when conflicts exist):
   - Show content differences
   - Provide merge recommendations
   - Offer options:
     - Keep primary file, backup others
     - Manual merge with assistance
     - Selective migration

### 4. Handle Conflicts Intelligently

**When conflicts detected:**
1. **Display differences:**
   ```
   ⚠️  Multiple AI config files with different content found:
   
   📄 CLAUDE.md (1,234 bytes)
   - Build commands: npm run build
   - Testing: vitest
   
   📄 .cursorrules (856 bytes)  
   - Code style: Prettier + ESLint
   - TypeScript: strict mode
   
   📄 .github/copilot-instructions.md (567 bytes)
   - Security guidelines
   - No secrets in code
   ```

2. **Provide merge options:**
   ```
   Choose migration approach:
   1. 🔄 Auto-merge (recommended) - Combine all unique content
   2. 📋 Keep CLAUDE.md, backup others (.cursorrules.bak, copilot-instructions.md.bak)
   3. 🎯 Selective - Choose which sections to include
   4. 🛠️  Manual - Guide me through merging step-by-step
   ```

3. **Execute chosen strategy:**
   - **Auto-merge**: Combine sections intelligently
   - **Backup**: Keep primary, rename others with .bak extension
   - **Selective**: Interactive selection of content blocks
   - **Manual**: Step-by-step merge assistance

### 5. Create AGENTS.md and Symlinks
After handling content merging, create the final structure:
```bash
# Claude Code
ln -s AGENTS.md CLAUDE.md

# Cline
ln -s AGENTS.md .clinerules

# Cursor
ln -s AGENTS.md .cursorrules

# Windsurf
ln -s AGENTS.md .windsurfrules

# Replit
ln -s AGENTS.md .replit.md

# Gemini CLI, OpenAI Codex, OpenCode
ln -s AGENTS.md GEMINI.md

# Legacy AGENT.md symlink for backward compatibility
ln -s AGENTS.md AGENT.md

# GitHub Copilot (special case - needs directory)
mkdir -p .github
ln -s ../AGENTS.md .github/copilot-instructions.md

# Firebase Studio (special case - needs .idx directory)
mkdir -p .idx
ln -s ../AGENTS.md .idx/airules.md
```

### 6. Verify Results
- Use `ls -la` to show all created symlinks
- Display which AI assistants are now configured
- Show any backup files created (.bak extensions)
- Confirm that AGENTS.md includes the symlink documentation note
- Verify content completeness (all important sections included)

### 7. Git Guidance
If in a git repository:
- Show git status (including new AGENTS.md and any .bak files)
- Suggest adding AGENTS.md and symlinks to git
- Recommend reviewing .bak files before deleting them
- Remind to update .gitignore if needed (some teams ignore certain config files)

### 8. Post-Migration Cleanup
After successful migration and git commit:
1. **Review backup files** (.bak extensions) to ensure nothing important was missed
2. **Delete backup files** once satisfied with AGENTS.md content
3. **Test with different AI assistants** to ensure all symlinks work correctly
4. **Run `/agents-md:init`** if you want to add directory structure and latest best practices

## Why AGENTS.md?

AGENTS.md is becoming the standard for AI assistant configuration because:
- Single source of truth for all AI tools
- No more duplicating content across multiple files
- Consistent experience across Claude Code, Cursor, Windsurf, and other tools
- Future-proof as new AI tools emerge

AGENTS.md emerged from collaborative efforts across the AI software development ecosystem, including OpenAI Codex, Amp, Jules from Google, Cursor, and Factory.

Learn more at https://agents.md

© carlrannaberg · MIT · carlrannaberg/claudekit

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
bringyour-migration-auditor 8bitconcepts Плагин bringyour-migration-auditor проверяет проект после переноса с Claude на Codex: охват AGENTS.md и CLAUDE.md, хуки, MCP-конфиг, скиллы и ссылки на секреты. Пригодится до первой правки кода агентом. CX Codex ★ 1 596звёзд репо claude-migrate-memory-to-doc daymade Скилл claude-migrate-memory-to-doc переносит приватную память Claude Code в tool-агностичные документы, чтобы Codex, Cursor и другие ИИ-редакторы читали одну базу с профилем и предпочтениями пользователя. CX Codex +1 388установок assess-react-native-migration callstackincubator Скилл assess-react-native-migration разбирает продуктовые репозитории и решает, стоит ли переносить мобильное приложение на React Native — до того, как начнётся код. CX Codex +1 2 700установок mapbox-google-maps-migration mapbox Скилл mapbox-google-maps-migration для Claude Code с руководством по переезду с Google Maps Platform на Mapbox GL JS. Помогает агенту переписать инициализацию карты, маркеры, события и попапы под декларативную модель Mapbox. CX Codex +1 1 500установок kotlin-tooling-immutable-collections-0-5-x-migration JetBrains Скилл kotlin-tooling-immutable-collections-0-5-x-migration для Claude Code переносит Kotlin- и Java-код с kotlinx.collections.immutable 0.3.x и 0.4.x на 0.5.x, переименовывая методы по подсказкам компилятора. CX Codex +1 1 300установок ionic-enterprise-sdk-migration capawesome-team Скилл ionic-enterprise-sdk-migration ведёт агента через перенос Capacitor-приложения с закрытых плагинов Ionic Enterprise SDK на альтернативы Capawesome: OAuth, Vault, Biometrics, Secure Preferences, SQLite. CX Codex +1 1 200установок

Из того же набора54

Весь набор →
create-command Команда create-command помогает собрать новую слэш-команду Claude Code: уточняет её назначение, готовит файл и показывает, как вызвать результат. CX Codex +1 ★ 763звёзд репо commit Команда commit собирает git-коммит в стиле проекта: проверяет диф, обновляет документацию, пишет сообщение по конвенциям из CLAUDE.md. CX Codex +1 ★ 763звёзд репо code-search Субагент code-search для Claude Code ищет в кодовой базе файлы, функции и шаблоны и возвращает краткий список путей. Локализует код перед правками без лишних рассуждений модели. CX Codex ★ 763звёзд репо validate-and-fix Команда validate-and-fix для Claude Code запускает проверки проекта и распределяет исправления между параллельными агентами. Она ищет команды сборки, тестов и линтинга в инструкциях проекта и package.json. CX Codex +1 ★ 763звёзд репо research-expert Субагент research-expert ищет данные в сети в параллельном режиме, подбирает глубину анализа под задачу и сохраняет подробный отчёт в файл, отдавая в чат только краткую сводку. CX Codex ★ 763звёзд репо create-subagent Команда create-subagent для Claude Code создаёт специализированного субагента, задавая область задач, инструменты и правила работы. Настраивает эксперта проекта или пользователя. CX Codex +1 ★ 763звёзд репо research Команда research разбивает вопрос на параллельные задачи субагентов, читает их отчёты из /tmp и сводит в один файл со ссылками на источники. CX Codex +1 ★ 763звёзд репо cleanup Команда cleanup находит временные тестовые скрипты, POC-файлы и отчёты после сессий разработки, предлагая список на удаление только после подтверждения. CX Codex +1 ★ 763звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой