AI 编码助手配置体系
保留你熟悉的 CLI/IDE,让 Claude Code、Gemini CLI、Codex、Cursor、GitHub Copilot 开箱即用
按费力度从低到高,用最少操作获得最大帮助

Important
📢 本仓库已停止更新 / This Repository Is No Longer Maintained
中文:因开源版权屡遭侵权,本仓库停止更新,现有内容保持可用。全部新能力已迁移至新项目 dev-agent-kit/recipes 持续维护,新内容只在新项目更新。
新项目相比本仓库已额外提供(并持续完善):
- pi 编辑器完整支持(第 7 个平台):增强配置、危险命令拦截、配额状态栏
- AI 工具统一 CLI 状态栏:模型 + 配额实时显示,多工具共享数据契约
- 新增 skills 七平台同步:诊断纪律、落盘验证、前端布局陷阱等
- native binary 探测与补丁自动派发:工具链升级不再手动返工
加入方式:付费小群(一次性 ¥699,终身更新 + 专属技术群;设置门槛是为了保障付费成员的维护质量)。微信 shi10xiu 或扫描文末二维码,备注“进小群”。
English: Due to repeated license violations, this repository is no longer maintained (existing content remains available). All new development has moved to dev-agent-kit/recipes — new features ship there only, including full pi editor support (7th platform), a unified CLI status bar (model + quota), new skills synced across 7 platforms, and automated native-binary patch dispatch.
Access: paid membership (one-time ¥699 ≈ $99, lifetime updates + private tech group). International users: email doccker@pm.me.
不是提示词集合,而是一套可维护的 AI 协作配置系统。
适合谁
- 同时使用 Claude Code、Antigravity CLI、Gemini CLI、Codex、Cursor、GitHub Copilot 中的一种或多种 CLI/IDE
- 不想在每个 session 里重复交代技术栈、项目结构和编码规范
- 希望把团队协作方式沉淀成可维护的 rules、skills 和 workflow
- 想降低 AI 常见翻车和危险操作风险
核心收益
- 一次维护,六套工具分别同步到各自用户级入口
- 分层加载(rules 常驻 + skills 按需 + workflow 显式调用),减少常驻上下文负担
- 内置防御性规则,降低修改测试适配错误、危险命令、过度重构等常见问题
- 保留你熟悉的 CLI,不强迫切换到新的交互方式
本项目的重点不是继续堆更长的提示词,而是把长期会反复出现的协作约定拆成可维护的结构:全局原则、审批规则、语言技能和任务 workflow 各司其职。
常见协作失效模式
一些高频问题并不是业务逻辑复杂,而是前后端接口契约已经漂移,却被临时兼容掩盖了。例如:
- 列表接口返回数组,前端却按分页对象读取
- 筛选项接口返回空数组,但列表里的真实数据明明存在对应状态
- 列表修好了,详情接口或状态选项接口仍然沿用另一套返回格式
这类问题的根因通常不是“前端容错不够”,而是后端没有遵守项目统一成功响应格式,或列表、详情、选项接口各自返回了不同结构。为减少这类问题在不同项目里反复出现,建议把治理拆成三层:
- 全局原则:联调异常先核对接口契约,不默认以前端兼容掩盖后端失配
- 专项 skill:通过
cc-api-contract-safety 检查成功响应包装、分页结构、筛选项来源和临时兼容退出条件
- workflow 持久化:在任务模板中记录接口契约确认和兼容清理条件,避免“先兼容,后遗忘”
快速部署
方式 A: 一键安装(推荐)
Claude Code
方式 1:Plugin Marketplace(推荐,一键安装)
在 Claude Code 会话中执行:
/plugin marketplace add doccker/cc-use-exp
/plugin install cc-use-exp@cc-use-exp
💡 完全自动化:无需手动下载,Claude Code 会自动从 GitHub 克隆并安装
更新配置:
/plugin update cc-use-exp@cc-use-exp
方式 2:完整同步(需要先安装方式 1)
安装方式 1 后,可使用自定义命令进行更完整的同步:
/skill-install
💡 区别:方式 1 仅安装 skills + commands,方式 2 额外同步 rules + templates,并支持跨工具使用(Gemini/Codex/Cursor)
更新配置:
/skill-update
两种方式对比:
| 特性 | 方式 1:Plugin Marketplace | 方式 2:完整同步 |
|---|
| 前置条件 | 无 | 需要先安装方式 1 |
| 安装命令 | /plugin marketplace add + /plugin install | /skill-install |
| 同步内容 | skills + commands | rules + skills + commands + templates |
| 跨工具支持 | ❌ 仅 Claude Code | ✅ 支持 Gemini/Codex/Cursor |
| 更新方式 | /plugin update | /skill-update |
| 适用场景 | 仅需 Claude Code 扩展 | 需要完整配置体系 |
Codex CLI
方式 1:会话内安装(推荐)
在 Codex 会话中执行:
$skill-installer install https://github.com/doccker/cc-use-exp/.codex/skills/cc-skill-installer
更新配置:重新执行上述命令
方式 2:Shell 脚本(无需进入 Codex 会话)
在终端执行:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-codex.sh)
说明:
- 方式 1 需要在 Codex 会话中执行,适合已经在使用 Codex 的用户
- 方式 2 可以在任何终端执行,无需进入 Codex 会话
Antigravity CLI / Gemini CLI
在终端执行:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-gemini.sh)
更新配置:重新运行安装脚本
说明:install-gemini.sh / sync-config.sh 会自动检测并同时为新版 Antigravity CLI(~/.gemini/config)和旧版 Gemini CLI(~/.gemini)配置规则和 Skills。
Cursor
在终端执行:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-cursor.sh)
更新配置:重新运行安装脚本
GitHub Copilot
在终端执行:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-copilot.sh)
更新配置:重新运行安装脚本
方式 B: 手动同步(开发者)
macOS/Linux:
git clone https://github.com/doccker/cc-use-exp.git
cd cc-use-exp
./tools/sync-config.sh
Windows:
git clone https://github.com/doccker/cc-use-exp.git
cd cc-use-exp
tools\sync-config.bat
脚本会自动同步六套工具配置:
.claude/ → ~/.claude/
.antigravity/ → ~/.gemini/config/ (Antigravity CLI 全局配置)
.gemini/ → ~/.gemini/ (旧版 Gemini CLI)
.codex/global/AGENTS.md → ~/.codex/AGENTS.md(受管区块合并)
.codex/global/rules/ → ~/.codex/rules/
.codex/instructions/*.md → ~/.codex/instructions/
.codex/skills/ → ~/.agents/skills/
.codex/profiles/*.toml → ~/.codex/{profile}.config.toml
.cursor/rules/*.mdc → ~/.cursor/rules/(兼容性同步,项目内 .cursor/rules/ 仍是主路径)
.cursor/skills/* → ~/.cursor/skills/
.cursor/commands/*.md → ~/.cursor/skills/{name}/SKILL.md(命令式技能兼容层)
.cursor/templates/* → ~/.cursor/templates/
.github/copilot-instructions.md → ~/.github/copilot-instructions.md
.github/instructions/*.instructions.md → ~/.github/instructions/
- 本地
AGENTS.md(若仓库存在)→ ~/.github/AGENTS.md
其中 Codex 采用增量部署:
- 不会整体覆盖
~/.codex/
- 不会动
auth.json、history.jsonl、日志、sqlite、cache 等运行态文件
- 只维护当前项目负责的
AGENTS 受管区块、受管 profile 文件、rules、instructions 和 skills
各工具的部署特性:
- Claude Code:同步到
~/.claude/,并保留历史对话记录和个人配置
- Antigravity CLI:将项目级的
.antigravity/ 模板同步到全局的 ~/.gemini/config/,以供所有项目复用。注意:项目本身的配置源已隔离到独立目录避免冲突。
- Gemini CLI:同步到
~/.gemini/,并保留认证信息(如 oauth_creds.json)和运行时数据
- Codex:对
~/.codex/AGENTS.md 使用受管区块合并;增量管理 ~/.codex/rules/、~/.codex/instructions/、~/.codex/{profile}.config.toml 与 ~/.agents/skills/ 下当前项目同步出去的受管内容;不改用户已有默认模型、provider 或 base_url
- Cursor:项目内
.cursor/rules/ 仍是主路径;脚本会把 skills、templates 和命令式技能兼容层同步到用户级目录,并将 .cursor/rules/*.mdc 兼容性同步到 ~/.cursor/rules/;保留 ~/.cursor 下的 settings、extensions、cache 等运行态文件
维护:跨平台 skill 单向同步
新增/更新 skill 时,先在 .claude/skills/ 编写权威版本,再用 tools/sync-skill.sh 单向同步到 Antigravity / Gemini / Cursor / Codex / Copilot:
./tools/sync-skill.sh # 同步全部 Claude skill 到 6 个目标平台
./tools/sync-skill.sh redis-safety # 只同步指定 skill
./tools/sync-skill.sh --target codex # 只同步到指定平台
./tools/sync-skill.sh --dry-run # 仅打印计划,不实际操作
./tools/sync-skill.sh --force # 覆盖已存在的 skill(默认跳过)
同步规则:
| 平台 | 目标路径 | 适配 |
|---|
| Antigravity | .antigravity/skills/{name}/ | 直接 cp 且清理冗余 frontmatter |
| Gemini | .gemini/skills/{name}/ | 直接 cp |
| Cursor | .cursor/skills/{name}/ | 直接 cp |
| Codex | .codex/skills/cc-{name}/ | 加 cc- 前缀,自动替换内部跨 skill 引用,生成 agents/openai.yaml |
| Copilot | .github/instructions/{name}.instructions.md | 半自动生成框架(applyTo: **),带 AUTO-GENERATED 注释提示人工精简 |
安全保障:
- 单向同步(Claude → 其他),不反向
- 不删除各平台独有的 skill(如 Cursor 的
ui-ux-pro-max)
- 默认不覆盖已存在 skill(用
--force 强制覆盖)
支持的工具
| 工具 | 配置目录 | 部署位置 | 安装方式 | 状态 |
|---|
| Claude Code | .claude/ | ~/.claude/ | 会话内或 Plugin | ✅ 完整支持 |
| Antigravity | .antigravity/ | ~/.gemini/config/ | Shell 脚本 | ✅ 完整支持 |
| Codex | .codex/ | ~/.codex/ + ~/.agents/skills/ | 会话内或 Shell | ✅ 完整支持(增量部署) |
| Gemini CLI | .gemini/ | ~/.gemini/ | Shell 脚本 | ✅ 完整支持 |
| Cursor | .cursor/ | 项目内 + 用户级 | Shell 脚本 | ✅ 完整支持 |
| GitHub Copilot | .github/ + 可选本地 AGENTS.md | ~/.github/ + 仓库内 | Shell 脚本 | ✅ 新增支持 |
安装方式详情:
Claude Code
- 方式 1:Plugin Marketplace
/plugin install(推荐)
- 一键安装,无需手动下载
- 同步 skills + commands
- 方式 2:完整同步
/skill-install
- 需要先安装方式 1
- 额外同步 rules + templates
- 支持跨工具使用(Gemini/Codex/Cursor)
Codex
- 方式 1:会话内安装
$skill-installer install
- 方式 2:Shell 脚本
Gemini CLI / Cursor / GitHub Copilot
- Shell 脚本安装
- Gemini:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-gemini.sh)
- Cursor:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-cursor.sh)
- GitHub Copilot:
bash <(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-copilot.sh)
项目定位
使用架构
本项目 用户目录 其他项目
├── .claude/ ──覆盖──> ~/.claude/ <──读取── .claude/ (空)
├── .antigravity/ ──覆盖──> ~/.gemini/config/ <──读取── (无,直接读取全局)
├── .gemini/ ──覆盖──> ~/.gemini/ <──读取── .gemini/ (空)
├── .codex/ ──增量部署──> ~/.codex/ + ~/.agents/skills/ <──读取── .codex/ (空)
├── .cursor/ ──项目内 rules + 用户级兼容同步──> ~/.cursor/skills/ + ~/.cursor/templates/ <──读取── .cursor/ (空)
└── .github/ + 可选本地 AGENTS.md ──覆盖/兜底──> ~/.github/ <──读取── .github/ + 本地 AGENTS.md
- 本项目:配置开发/维护环境,不参与实际业务开发
- 用户目录:实际生效的配置
- 其他项目:配置目录为空,自动使用用户目录配置
四套配置的关系
| 目录 | 服务对象 | 说明 |
|---|
.claude/ | Claude Code | Anthropic 的 CLI 工具 |
.antigravity/ | Antigravity CLI | Google 最新多 Agent 协同终端配置源 |
.gemini/ | Gemini CLI | Google 的旧版 CLI 工具 |
.codex/ | Codex | OpenAI 的 CLI 工具,项目内维护权威源,部署时分发到 ~/.codex/ 和 ~/.agents/skills/ |
.github/ + 可选本地 AGENTS.md | GitHub Copilot | GitHub Copilot / coding agent 的仓库级配置;若项目本地存在 AGENTS.md,可作为额外兜底配置 |
.cursor/ | Cursor | AI IDE,项目内 .cursor/rules/ 为主;用户级复用 ~/.cursor/skills/、~/.cursor/templates/,并兼容性同步 ~/.cursor/rules/ |
四者相互独立:
- Claude Code 只读取
~/.claude/,不读取 ~/.gemini/
- Gemini CLI 只读取
~/.gemini/,不读取 ~/.claude/
- Codex 的全局入口是
~/.codex/AGENTS.md、~/.codex/rules/、~/.codex/instructions/ 和 ~/.agents/skills/
- Cursor 以当前项目
.cursor/rules/ 为主;跨项目复用的技能和命令式技能主要通过 ~/.cursor/skills/ 提供
- 配置内容可能相似(如禁止行为、技术栈偏好),但这不是重复,而是各自需要的独立配置
配置能力差异
| 特性 | Claude Code | Antigravity | Gemini CLI | Codex | Cursor |
|---|
| 主配置文件 | .claude/CLAUDE.md | .antigravity/AGENTS.md | .gemini/GEMINI.md | .codex/global/AGENTS.md → ~/.codex/AGENTS.md | 无(规则即配置) |
| 规则目录 | .claude/rules/ ✅ | 无(通过 @import 合并) | .gemini/rules/ ✅(通过 @import) | .codex/global/rules/ → ~/.codex/rules/ | .cursor/rules/ ✅(.mdc 格式) |
| 技能目录 | .claude/skills/ ✅ | .antigravity/skills/ ✅ | .gemini/skills/ ✅(v0.24.0+) | .codex/skills/ → ~/.agents/skills/ | .cursor/skills/ ✅ |
| 命令目录 | .claude/commands/ (.md) | 无独立命令 | .gemini/commands/ (.toml) | 无独立命令目录,使用显式 workflow skills | .cursor/commands/ (.md) |