cc-use-exp

---

不是提示词集合，而是一套可维护的 AI 协作配置系统。

适合谁

• 同时使用 Claude Code、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 会话

Gemini CLI

在终端执行：

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)

更新配置：重新运行安装脚本

---

方式 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

脚本会自动同步五套配置：