360 Secure SkillHub
360 安全技能中心

Config Sync — 16 AI Tools, 1 Source

读取 .claude/rules/*.md（缺失时回退到 CLAUDE.md）作为唯一规范源，去除 Claude 专属 frontmatter 后，按各工具格式生成 CLAUDE.md、AGENTS.md、GEMINI.md、.cursor/rules、copilot-instructions、.trae/rules 等配置文件，支持 --tools 选择目标、--dry-run 预览和 --i…

nadalpiantini
nadalpiantini
热度 40.81
最近更新 2026-05-11 17:44:17
分类：开发依赖：代码执行 / 读写文件应用场景：工作流 / 文件转换 / 模板 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add config-sync
Metadata
name
config-sync
description
Sync AI coding assistant config files from a single source. Generates CLAUDE.md, AGENTS.md, GEMINI.md, .cursor/rules/, .github/copilot-instructions.md, .windsurf/rules/, .clinerules/, CONVENTIONS.md, .kiro/steering/, .amazonq/rules/, .goosehints, .trae/rules/ from your canonical rules. ACTIVAR cuando el usuario dice 'sync configs', 'generate ai rules', 'configurar para otros tools', 'unificar instrucciones', 'config sync'.

Config Sync — 16 AI Tools, 1 Source

Reads .claude/rules/ (or CLAUDE.md) as canonical source and generates native config files for every major AI coding assistant.

Problem

Each AI coding tool uses a different config file:

  • Claude Code → CLAUDE.md + .claude/rules/*.md
  • Codex CLI → AGENTS.md
  • Gemini CLI → GEMINI.md
  • Cursor → .cursor/rules/*.mdc
  • GitHub Copilot → .github/copilot-instructions.md
  • Windsurf → .windsurf/rules/*.md
  • Cline/Roo → .clinerules/*.md
  • Aider → CONVENTIONS.md
  • Kiro → .kiro/steering/*.md
  • Amazon Q → .amazonq/rules/*.md
  • Goose → .goosehints
  • Trae AI → .trae/rules/*.md
  • Zed → .rules
  • Amp/OpenCode/Warp → AGENTS.md (shared)

Maintaining 16 files for the same instructions is absurd. Config-sync fixes it.

How It Works

  1. Source of truth: .claude/rules/*.md (most expressive format — supports glob patterns, frontmatter conditions, always/attached/triggered modes)
  2. Fallback source: CLAUDE.md at repo root if .claude/rules/ doesn't exist
  3. Transform: Concatenates all rule files, strips Claude-specific frontmatter, generates each format
  4. Output: Only generates configs for tools you select (or all by default)

Usage

Generate all configs

python3 ~/.openclaw/skills/config-sync/scripts/config-sync.py /path/to/repo

Generate specific tools only

python3 ~/.openclaw/skills/config-sync/scripts/config-sync.py /path/to/repo --tools codex,gemini,cursor

Preview without writing

python3 ~/.openclaw/skills/config-sync/scripts/config-sync.py /path/to/repo --dry-run

Init from existing CLAUDE.md

python3 ~/.openclaw/skills/config-sync/scripts/config-sync.py /path/to/repo --init

This creates .claude/rules/ from your existing CLAUDE.md as the canonical source.

Supported Tools

Tool Output File Notes
Claude Code .claude/rules/*.md (source, not generated) Already the canonical format
Codex CLI AGENTS.md Flat markdown, no frontmatter
Gemini CLI GEMINI.md Flat markdown
Cursor .cursor/rules/config-sync.mdc MDC format with description + globs
GitHub Copilot .github/copilot-instructions.md Flat markdown
Windsurf .windsurf/rules/config-sync.md Flat markdown
Cline/Roo .clinerules/config-sync.md Flat markdown
Aider CONVENTIONS.md Flat markdown, concise style
Kiro .kiro/steering/config-sync.md Flat markdown
Amazon Q .amazonq/rules/config-sync.md Flat markdown
Goose .goosehints Line-per-rule, no markdown
Trae AI .trae/rules/config-sync.md Flat markdown
Zed .rules Flat markdown

Transformation Rules

Stripped from source

  • YAML frontmatter (--- blocks) — tool-specific, not portable
  • alwaysApply: true/false — Claude Code specific
  • Glob patterns in frontmatter — converted to natural language headers

Added to each output

  • Header comment: <!-- Generated by config-sync. Edit source at .claude/rules/ -->
  • Tool-specific header if needed (e.g., MDC frontmatter for Cursor)

Format adaptations

  • Goose (.goosehints): Each rule becomes one line, no markdown
  • Cursor (.mdc): Gets MDC frontmatter with description and globs: **
  • Aider (CONVENTIONS.md): Condensed to bullet points, no long explanations
  • AGENTS.md: Standard markdown, used by Codex/Amp/OpenCode/Warp (4 tools, 1 file)

Workflow

  1. Edit .claude/rules/*.md (your canonical source)
  2. Run config-sync to generate all other formats
  3. Commit all generated files together
  4. Repeat when rules change

Auto-detect installed tools

The script checks for:

  • .cursor/ directory → Cursor installed
  • .github/copilot-instructions.md exists → Copilot in use
  • .windsurf/ → Windsurf installed
  • .clinerules/ → Cline installed
  • .kiro/ → Kiro installed
  • .amazonq/ → Amazon Q installed
  • .trae/ → Trae installed
  • AGENTS.md exists → Codex/Amp/OpenCode in use
  • GEMINI.md exists → Gemini CLI in use

If --tools is not specified, generates all formats (belt-and-suspenders approach).

Philosophy

One source of truth. Many outputs. Like a compiler: write once in the richest language, emit to every target.