Cursor规则转换工具

ecc2cursor是一个无状态的命令行工具,用于将Everything Claude Code的配置自动转换为Cursor IDE兼容格式,包括编码规则、技能、代理和命令,适用于开发者快速配置Cursor IDE环境。

  • by cminn10
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 cminn10/ecc2cursor

使用说明

ecc2cursor

带来久经考验的战斗 光标规则, 技能, 代理, 命令,以及 MCP服务器 从 一切克劳德代码 在Cursor IDE设置中,只需一个命令。

零配置。完全无国籍。 没有隐藏文件,没有持久状态。运行它。

为什么是ecc2cursor?

一切克劳德代码 (ECC)是人工智能编码配置的精心策划的集合——数十种语言的规则、可重用的技能、专用代理和预配置的MCP服务器。它是为Claude Code构建的,但模式是通用的。

ecc2cursor 自动将这些配置转换并安装为Cursor的格式:

  • 光标规则 --TypeScript、Python、Go、Java、Django、Spring Boot等的编码标准
  • 光标技能 --可重用的提示驱动工作流(TDD、代码审查、安全审计、规划等)
  • 光标代理 --用于构建错误、重构、数据库审查、E2E测试的专业子代理
  • 光标命令 --常见工作流的一键操作
  • MCP服务器 --预配置的模型上下文协议集成

禁止手动复制。没有格式不匹配。就 npx ecc2cursor 然后挑选你需要的东西。

快速开始

# npm
npx ecc2cursor

# bun
bunx ecc2cursor

这将启动一个交互式向导,引导您完成以下操作:

  1. 选择目标目录(~/.cursor/ 或项目级别)
  2. 选择要同步的类别(代理、规则、命令、技能、上下文、钩子、MCP)
  3. 选择语言规则集
  4. 选择要安装的MCP服务器
  5. 确认和同步

非交互模式

# Sync everything with defaults to ~/.cursor/
npx ecc2cursor sync        # or: bunx ecc2cursor sync

# Sync to a specific directory
npx ecc2cursor sync --dir=./my-project/.cursor

# Preview what would be synced
npx ecc2cursor sync --dry-run

# Check what's installed
npx ecc2cursor status

# Remove all ecc-* files
npx ecc2cursor clean

# Sync without a prefix (use original file names)
npx ecc2cursor sync --no-prefix

提示: 全部 npx 命令与 bunx 也一样——只要交换前缀就行了。

运作原理

ecc2cursor是 完全无国籍 --除了同步文件本身,它不会在您的计算机上保存任何内容。

  1. 克隆:浅层克隆ECC仓库到临时目录(2-3秒)
  2. 翻译:将Claude代码配置转换为与游标兼容的格式
  3. 安装:将文件写入您的 .cursor/ 目录(带可选前缀)
  4. 清理:删除临时克隆

前缀和检测

默认情况下,文件以 ecc- 前缀(例如。, ecc-typescript, ecc-code-reviewer.md).前缀 是 manifest-ecc2cursor扫描前缀文件以检测已安装的文件。

你可以选择 无前缀 在向导或通过 --no-prefix 以保留原始文件名。请注意,如果没有前缀,自动检测和基于前缀的清理将不起作用——向导每次都会运行,而清理只会删除MCP服务器。

什么被同步

源 目标(带前缀 ecc) 描述
agents/*.md .cursor/agents/ecc-*.md 光标子代理
rules/<lang>/*.md .cursor/skills/ecc-<lang>/ 每种语言的编码标准
commands/*.md .cursor/skills/ecc-*/SKILL.md + .cursor/commands/ecc-*.md 全技能+精简命令包装
skills/*/SKILL.md .cursor/skills/ecc-*/SKILL.md 传递技能定义
contexts/*.md .cursor/skills/ecc-ctx-*/SKILL.md 特定模式的上下文提示
hooks/hooks.json .cursor/skills/ecc-coding-standards/rules/*.md 钩意图指南
mcp-configs/ .cursor/mcp.json MCP服务器安装(无前缀)

随着 --no-prefix,the ecc- 部分被省略(例如。, agents/code-reviewer.md, skills/typescript/).

内容转换

所有同步的内容都会自动适应:

  • 路径引用(~/.claude/ → ~/.cursor/)
  • 代理人参考(→技能参考 ecc- 前缀)
  • 命令引用(→ ecc- 前缀命令)
  • 工具名称(Bash → Shell, Edit → StrReplace)
  • 克劳德代码术语(→游标)

旗帜

标志 描述 默认值
--dir=PATH 目标 .cursor/ 目录 ~/.cursor
--prefix=NAME 所有已同步项目的文件前缀 ecc
--no-prefix 使用不带前缀的原始文件名 -
--dry-run 无需书写即可预览更改 -

需求

  • Node.js>=20 或 包子
  • Git (用于克隆源存储库)

相关项目

贡献

发现bug了吗?想添加一个新的翻译器吗?欢迎PR和问题。请参阅 ECC存储库 用于上游配置源。

许可证

麻省理工学院