cc-use-exp

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 脚本	✅ 新增支持

安装方式详情：

• 方式 1：Plugin Marketplace /plugin install（推荐）
  • 一键安装，无需手动下载
  • 同步 skills + commands
• 方式 2：完整同步 /skill-install
  • 需要先安装方式 1
  • 额外同步 rules + templates
  • 支持跨工具使用（Gemini/Codex/Cursor）

• 方式 1：会话内安装 $skill-installer install
  • 在 Codex 会话中执行
• 方式 2：Shell 脚本
  • 可在任何终端执行
  • 无需进入 Codex 会话

• 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)