{"id":37380275,"url":"https://github.com/doccker/cc-use-exp","last_synced_at":"2026-05-29T05:00:53.220Z","repository":{"id":332128408,"uuid":"1127638187","full_name":"doccker/cc-use-exp","owner":"doccker","description":"让 Claude Code、Gemini CLI、Codex、Cursor 开箱即用的分层配置模板，总结十多年的日常开发经验，持续完善中……","archived":false,"fork":false,"pushed_at":"2026-05-17T04:44:57.000Z","size":2938,"stargazers_count":717,"open_issues_count":3,"forks_count":74,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-05-17T06:45:22.060Z","etag":null,"topics":["claude-code","codex","cursor","gemini-cli","github-copilot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/doccker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2026-01-04T09:52:00.000Z","updated_at":"2026-05-17T06:43:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/doccker/cc-use-exp","commit_stats":null,"previous_names":["doccker/cc-use-exp"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/doccker/cc-use-exp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doccker%2Fcc-use-exp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doccker%2Fcc-use-exp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doccker%2Fcc-use-exp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doccker%2Fcc-use-exp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/doccker","download_url":"https://codeload.github.com/doccker/cc-use-exp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doccker%2Fcc-use-exp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33637485,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex","cursor","gemini-cli","github-copilot"],"created_at":"2026-01-16T05:06:30.703Z","updated_at":"2026-05-29T05:00:53.204Z","avatar_url":"https://github.com/doccker.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# AI 编码助手配置体系\n\n\u003c!-- 封面图 --\u003e\n\u003cimg src=\"pic/cover.svg\" alt=\"AI 编码助手配置体系\" width=\"100%\" style=\"max-width: 800px\" /\u003e\n\n\u003e 保留你熟悉的 CLI/IDE，让 Claude Code、Gemini CLI、Codex、Cursor、GitHub Copilot 开箱即用\n\u003e\n\u003e 按费力度从低到高，用最少操作获得最大帮助\n\n[![version](https://img.shields.io/badge/version-1.0.37-blue.svg)](https://github.com/doccker/cc-use-exp)\n[![license](https://img.shields.io/badge/license-PolyForm%20NC-green.svg)](./LICENSE)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-Config-orange.svg)](https://docs.anthropic.com/claude-code)\n[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-Config-purple.svg)](https://github.com/google-gemini/gemini-cli)\n[![Codex](https://img.shields.io/badge/Codex-Config-black.svg)](https://developers.openai.com/codex/)\n[![Cursor](https://img.shields.io/badge/Cursor-Config-blue.svg)](https://www.cursor.com/)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/doccker/cc-use-exp/pulls)\n[![GitHub stars](https://img.shields.io/github/stars/doccker/cc-use-exp)](https://github.com/doccker/cc-use-exp/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/doccker/cc-use-exp)](https://github.com/doccker/cc-use-exp/network)\n[![GitHub watchers](https://img.shields.io/github/watchers/doccker/cc-use-exp)](https://github.com/doccker/cc-use-exp/watchers)\n\n\u003c/div\u003e\n\n---\n\n\u003e 不是提示词集合，而是一套可维护的 AI 协作配置系统。\n\n## 适合谁\n\n- 同时使用 Claude Code、Gemini CLI、Codex、Cursor、GitHub Copilot 中的一种或多种 CLI/IDE\n- 不想在每个 session 里重复交代技术栈、项目结构和编码规范\n- 希望把团队协作方式沉淀成可维护的 rules、skills 和 workflow\n- 想降低 AI 常见翻车和危险操作风险\n\n## 核心收益\n\n- 一次维护，五套工具分别同步到各自用户级入口\n- 分层加载（rules 常驻 + skills 按需 + workflow 显式调用），减少常驻上下文负担\n- 内置防御性规则，降低修改测试适配错误、危险命令、过度重构等常见问题\n- 保留你熟悉的 CLI，不强迫切换到新的交互方式\n\n本项目的重点不是继续堆更长的提示词，而是把长期会反复出现的协作约定拆成可维护的结构：全局原则、审批规则、语言技能和任务 workflow 各司其职。\n\n## 常见协作失效模式\n\n一些高频问题并不是业务逻辑复杂，而是前后端接口契约已经漂移，却被临时兼容掩盖了。例如：\n\n- 列表接口返回数组，前端却按分页对象读取\n- 筛选项接口返回空数组，但列表里的真实数据明明存在对应状态\n- 列表修好了，详情接口或状态选项接口仍然沿用另一套返回格式\n\n这类问题的根因通常不是“前端容错不够”，而是后端没有遵守项目统一成功响应格式，或列表、详情、选项接口各自返回了不同结构。为减少这类问题在不同项目里反复出现，建议把治理拆成三层：\n\n- 全局原则：联调异常先核对接口契约，不默认以前端兼容掩盖后端失配\n- 专项 skill：通过 `cc-api-contract-safety` 检查成功响应包装、分页结构、筛选项来源和临时兼容退出条件\n- workflow 持久化：在任务模板中记录接口契约确认和兼容清理条件，避免“先兼容，后遗忘”\n\n---\n\n## 快速部署\n\n### 方式 A: 一键安装（推荐）\n\n#### Claude Code\n\n**方式 1：Plugin Marketplace**（推荐，一键安装）\n\n在 Claude Code 会话中执行：\n```bash\n/plugin marketplace add doccker/cc-use-exp\n/plugin install cc-use-exp@cc-use-exp\n```\n\n\u003e 💡 **完全自动化**：无需手动下载，Claude Code 会自动从 GitHub 克隆并安装\n\n更新配置：\n```bash\n/plugin update cc-use-exp@cc-use-exp\n```\n\n**方式 2：完整同步**（需要先安装方式 1）\n\n安装方式 1 后，可使用自定义命令进行更完整的同步：\n```bash\n/skill-install\n```\n\n\u003e 💡 **区别**：方式 1 仅安装 skills + commands，方式 2 额外同步 rules + templates，并支持跨工具使用（Gemini/Codex/Cursor）\n\n更新配置：\n```bash\n/skill-update\n```\n\n**两种方式对比**：\n\n| 特性 | 方式 1：Plugin Marketplace | 方式 2：完整同步 |\n|------|---------------------------|-----------------|\n| 前置条件 | 无 | 需要先安装方式 1 |\n| 安装命令 | `/plugin marketplace add` + `/plugin install` | `/skill-install` |\n| 同步内容 | skills + commands | rules + skills + commands + templates |\n| 跨工具支持 | ❌ 仅 Claude Code | ✅ 支持 Gemini/Codex/Cursor |\n| 更新方式 | `/plugin update` | `/skill-update` |\n| 适用场景 | 仅需 Claude Code 扩展 | 需要完整配置体系 |\n\n#### Codex CLI\n\n**方式 1：会话内安装**（推荐）\n\n在 Codex 会话中执行：\n```bash\n$skill-installer install https://github.com/doccker/cc-use-exp/.codex/skills/cc-skill-installer \n```\n\n更新配置：重新执行上述命令\n\n**方式 2：Shell 脚本**（无需进入 Codex 会话）\n\n在终端执行：\n```bash\nbash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-codex.sh)\n```\n\n\u003e **说明**：\n\u003e - 方式 1 需要在 Codex 会话中执行，适合已经在使用 Codex 的用户\n\u003e - 方式 2 可以在任何终端执行，无需进入 Codex 会话\n\n#### Gemini CLI\n\n在终端执行：\n```bash\nbash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-gemini.sh)\n```\n\n更新配置：重新运行安装脚本\n\n#### Cursor\n\n在终端执行：\n```bash\nbash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-cursor.sh)\n```\n\n更新配置：重新运行安装脚本\n\n#### GitHub Copilot\n\n在终端执行：\n```bash\nbash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-copilot.sh)\n```\n\n更新配置：重新运行安装脚本\n\n---\n\n### 方式 B: 手动同步（开发者）\n\n**macOS/Linux**：\n```bash\ngit clone https://github.com/doccker/cc-use-exp.git\ncd cc-use-exp\n./tools/sync-config.sh\n```\n\n**Windows**：\n```cmd\ngit clone https://github.com/doccker/cc-use-exp.git\ncd cc-use-exp\ntools\\sync-config.bat\n```\n\n脚本会自动同步五套配置：\n\n- `.claude/` → `~/.claude/`\n- `.gemini/` → `~/.gemini/`\n- `.codex/global/AGENTS.md` → `~/.codex/AGENTS.md`（受管区块合并）\n- `.codex/global/rules/` → `~/.codex/rules/`\n- `.codex/instructions/*.md` → `~/.codex/instructions/`\n- `.codex/skills/` → `~/.agents/skills/`\n- `.codex/profiles/*.toml` → `~/.codex/{profile}.config.toml`\n- `.cursor/rules/*.mdc` → `~/.cursor/rules/`（兼容性同步，项目内 `.cursor/rules/` 仍是主路径）\n- `.cursor/skills/*` → `~/.cursor/skills/`\n- `.cursor/commands/*.md` → `~/.cursor/skills/{name}/SKILL.md`（命令式技能兼容层）\n- `.cursor/templates/*` → `~/.cursor/templates/`\n- `.github/copilot-instructions.md` → `~/.github/copilot-instructions.md`\n- `.github/instructions/*.instructions.md` → `~/.github/instructions/`\n- 本地 `AGENTS.md`（若仓库存在）→ `~/.github/AGENTS.md`\n\n其中 Codex 采用**增量部署**：\n\n- 不会整体覆盖 `~/.codex/`\n- 不会动 `auth.json`、`history.jsonl`、日志、sqlite、cache 等运行态文件\n- 只维护当前项目负责的 `AGENTS` 受管区块、受管 profile 文件、`rules`、`instructions` 和 `skills`\n\n各工具的部署特性：\n\n- **Claude Code**：同步到 `~/.claude/`，并保留历史对话记录和个人配置\n- **Gemini CLI**：同步到 `~/.gemini/`，并保留认证信息（如 `oauth_creds.json`）和运行时数据\n- **Codex**：对 `~/.codex/AGENTS.md` 使用受管区块合并；增量管理 `~/.codex/rules/`、`~/.codex/instructions/`、`~/.codex/{profile}.config.toml` 与 `~/.agents/skills/` 下当前项目同步出去的受管内容；不改用户已有默认模型、provider 或 `base_url`\n- **Cursor**：项目内 `.cursor/rules/` 仍是主路径；脚本会把 skills、templates 和命令式技能兼容层同步到用户级目录，并将 `.cursor/rules/*.mdc` 兼容性同步到 `~/.cursor/rules/`；保留 `~/.cursor` 下的 settings、extensions、cache 等运行态文件\n\n---\n\n### 维护：跨平台 skill 单向同步\n\n新增/更新 skill 时，先在 `.claude/skills/` 编写权威版本，再用 `tools/sync-skill.sh` 单向同步到 Gemini / Cursor / Codex / Copilot：\n\n```bash\n./tools/sync-skill.sh                       # 同步全部 Claude skill 到 4 平台\n./tools/sync-skill.sh redis-safety          # 只同步指定 skill\n./tools/sync-skill.sh --target codex        # 只同步到指定平台\n./tools/sync-skill.sh --dry-run             # 仅打印计划，不实际操作\n./tools/sync-skill.sh --force               # 覆盖已存在的 skill（默认跳过）\n```\n\n同步规则：\n\n| 平台 | 目标路径 | 适配 |\n|------|---------|------|\n| Gemini | `.gemini/skills/{name}/` | 直接 cp |\n| Cursor | `.cursor/skills/{name}/` | 直接 cp |\n| Codex | `.codex/skills/cc-{name}/` | 加 `cc-` 前缀，自动替换内部跨 skill 引用，生成 `agents/openai.yaml` |\n| Copilot | `.github/instructions/{name}.instructions.md` | 半自动生成框架（applyTo: `**`），带 `AUTO-GENERATED` 注释提示人工精简 |\n\n**安全保障**：\n- 单向同步（Claude → 其他），不反向\n- 不删除各平台独有的 skill（如 Cursor 的 `ui-ux-pro-max`）\n- 默认不覆盖已存在 skill（用 `--force` 强制覆盖）\n\n---\n\n## 支持的工具\n\n| 工具 | 配置目录 | 部署位置 | 安装方式 | 状态 |\n|------|---------|---------|---------|------|\n| Claude Code | `.claude/` | `~/.claude/` | 会话内或 Plugin | ✅ 完整支持 |\n| Codex | `.codex/` | `~/.codex/` + `~/.agents/skills/` | 会话内或 Shell | ✅ 完整支持（增量部署） |\n| Gemini CLI | `.gemini/` | `~/.gemini/` | Shell 脚本 | ✅ 完整支持 |\n| Cursor | `.cursor/` | 项目内 + 用户级 | Shell 脚本 | ✅ 完整支持 |\n| GitHub Copilot | `.github/` + 可选本地 `AGENTS.md` | `~/.github/` + 仓库内 | Shell 脚本 | ✅ 新增支持 |\n\n**安装方式详情**：\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Code\u003c/strong\u003e\u003c/summary\u003e\n\n- **方式 1**：Plugin Marketplace `/plugin install`（推荐）\n  - 一键安装，无需手动下载\n  - 同步 skills + commands\n- **方式 2**：完整同步 `/skill-install`\n  - 需要先安装方式 1\n  - 额外同步 rules + templates\n  - 支持跨工具使用（Gemini/Codex/Cursor）\n  \u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCodex\u003c/strong\u003e\u003c/summary\u003e\n\n- **方式 1**：会话内安装 `$skill-installer install`\n  - 在 Codex 会话中执行\n- **方式 2**：Shell 脚本\n  - 可在任何终端执行\n  - 无需进入 Codex 会话\n  \u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eGemini CLI / Cursor / GitHub Copilot\u003c/strong\u003e\u003c/summary\u003e\n\n- **Shell 脚本安装**\n  - Gemini：`bash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-gemini.sh)`\n  - Cursor：`bash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-cursor.sh)`\n  - GitHub Copilot：`bash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-copilot.sh)`\n  \u003c/details\u003e\n\n\n---\n\n## 项目定位\n\n### 使用架构\n\n```\n本项目                      用户目录                               其他项目\n├── .claude/  ──覆盖──\u003e    ~/.claude/  \u003c──读取──                 .claude/ (空)\n├── .gemini/  ──覆盖──\u003e    ~/.gemini/  \u003c──读取──                 .gemini/ (空)\n├── .codex/   ──增量部署──\u003e ~/.codex/ + ~/.agents/skills/ \u003c──读取── .codex/ (空)\n├── .cursor/  ──项目内 rules + 用户级兼容同步──\u003e ~/.cursor/skills/ + ~/.cursor/templates/ \u003c──读取── .cursor/ (空)\n└── .github/ + 可选本地 AGENTS.md ──覆盖/兜底──\u003e ~/.github/ \u003c──读取── .github/ + 本地 AGENTS.md\n```\n\n- **本项目**：配置开发/维护环境，不参与实际业务开发\n- **用户目录**：实际生效的配置\n- **其他项目**：配置目录为空，自动使用用户目录配置\n\n### 四套配置的关系\n\n| 目录 | 服务对象 | 说明 |\n|------|---------|------|\n| `.claude/` | Claude Code | Anthropic 的 CLI 工具 |\n| `.gemini/` | Gemini CLI | Google 的 CLI 工具 |\n| `.codex/` | Codex | OpenAI 的 CLI 工具，项目内维护权威源，部署时分发到 `~/.codex/` 和 `~/.agents/skills/` |\n| `.github/` + 可选本地 `AGENTS.md` | GitHub Copilot | GitHub Copilot / coding agent 的仓库级配置；若项目本地存在 `AGENTS.md`，可作为额外兜底配置 |\n| `.cursor/` | Cursor | AI IDE，项目内 `.cursor/rules/` 为主；用户级复用 `~/.cursor/skills/`、`~/.cursor/templates/`，并兼容性同步 `~/.cursor/rules/` |\n\n**四者相互独立**：\n- Claude Code 只读取 `~/.claude/`，不读取 `~/.gemini/`\n- Gemini CLI 只读取 `~/.gemini/`，不读取 `~/.claude/`\n- Codex 的全局入口是 `~/.codex/AGENTS.md`、`~/.codex/rules/`、`~/.codex/instructions/` 和 `~/.agents/skills/`\n- Cursor 以当前项目 `.cursor/rules/` 为主；跨项目复用的技能和命令式技能主要通过 `~/.cursor/skills/` 提供\n- 配置内容可能相似（如禁止行为、技术栈偏好），但这不是重复，而是各自需要的独立配置\n\n### 配置能力差异\n\n| 特性 | Claude Code | Gemini CLI | Codex | Cursor |\n|------|-------------|------------|-------|--------|\n| 主配置文件 | `.claude/CLAUDE.md` | `.gemini/GEMINI.md` | `.codex/global/AGENTS.md` → `~/.codex/AGENTS.md` | 无（规则即配置） |\n| 规则目录 | `.claude/rules/` ✅ | `.gemini/rules/` ✅（通过 @import） | `.codex/global/rules/` → `~/.codex/rules/` | `.cursor/rules/` ✅（.mdc 格式） |\n| 技能目录 | `.claude/skills/` ✅ | `.gemini/skills/` ✅（v0.24.0+） | `.codex/skills/` → `~/.agents/skills/` | `.cursor/skills/` ✅ |\n| 命令目录 | `.claude/commands/` (.md) | `.gemini/commands/` (.toml) | 无独立命令目录，使用显式 workflow skills | `.cursor/commands/` (.md) |\n| 命令格式 | Markdown | TOML | `SKILL.md` + `agents/openai.yaml` | Markdown（部署为 SKILL.md） |\n\n**规则同步方式**：\n- Claude Code：规则拆分到 `rules/` 目录，按文件组织；技能放 `skills/` 按需加载\n- Gemini CLI：核心规则在 `GEMINI.md`；详细规范通过 `skills/` 按需激活（v0.24.0+）\n- Codex：全局仅保留极薄 `AGENTS.md` 和审批 `rules`；绝大多数通用规范放进 `skills`，通过渐进式披露按需加载\n- Cursor：规则用 `.mdc` 格式支持 `alwaysApply` / `globs` / 智能匹配；技能通过 `description` 语义匹配按需加载；用户级 `~/.cursor/rules/` 同步仅作为兼容性补充\n\n\u003e 如需在多个工具间同步规则（如禁止行尾注释），需分别在 `.claude/rules/bash-style.md`、`.gemini/GEMINI.md`、`.cursor/rules/bash-style.mdc` 中维护。\n\n---\n\n# Part 1: Claude Code 配置\n\n\u003e 📖 **[完整指南](./docs/guides/claude-code.md)** - Rules、Skills、Commands 详解、最佳实践、常见问题\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"pic/cli-claude-code.svg\" alt=\"Claude Code 加载机制 + cc-use-exp 介入链路\" width=\"100%\" style=\"max-width: 1000px\" /\u003e\n\u003c/div\u003e\n\n\u003e 上图展示从 `claude` 命令输入到 Sonnet 模型输出的完整链路：① 启动加载 `settings.json` + `CLAUDE.md` + `~/.claude/rules/*.md`（cc-use-exp 防御性规则始终注入），② Skills 渐进式披露（描述常驻、命中后加载完整 SKILL.md），③ `/slash` 命令显式触发 workflow，PostToolUse Hook 守卫落盘。\n\n---\n\n## 快速开始\n\n### 零费力（自动生效）- Rules\n\n这些规则始终自动加载，在后台默默保护你：\n\n- **防御性规则**：防止测试篡改、过度工程化、中途放弃\n- **文件行数限制**：超限时自动警告，提供简化选项\n- **运维安全**：危险命令确认、回滚方案、风险提示\n- **文档同步**：配置变更时提醒更新文档\n- **Bash 规范**：禁止行尾注释等核心规范\n\n### 低费力（自动触发）- Skills\n\n操作相关文件时自动加载对应的开发规范：\n\n- **设计技能**：`code-quality-principles`\n- **语言技能**：`go-dev`、`java-dev`、`frontend-dev`、`python-dev`、`rust-dev`\n- **安全技能**：`ops-safety`、`redis-safety`、`api-design-safety`、`api-contract-safety`、`storage-url-safety`、`query-performance-safety`、`async-task-pattern`、`time-zone-safety`\n- **重构技能**：`refactor-safety`、`field-mapping-safety`\n- **工具技能**：`bash-style`、`size-check`\n\n### 中费力（显式调用）- Commands\n\n输入 `/命令名` 执行工作流：\n\n**高频命令**：`/fix`、`/review`、`/review quick`、`/commit-msg`\n\n**中频命令**：`/optimize`、`/new-feature`、`/design`、`/requirement`\n\n**低频命令**：`/skill-install`、`/skill-update`、`/skill-uninstall`、`/project-init`、`/patch`、`/status`\n\n---\n\n## 补丁工具\n\n`/cache-patch` 验证效果：\n\n![cache-check](./pic/cache-check.png)\n\n注：`/patch` 只是让 CC 绕过 Chrome 订阅检查。如需要自定义渠道的插件，可以扫码联系作者免费获取插件地址，仅供学习使用。\n\n![Chrome 插件独立配置界面（可指定自定义模型）](./pic/cc-chrome-plugin-1.png)\n\nClaude Code 联动 Chrome 扩展效果图：\n\n![Claude Code 联动 Chrome 扩展效果图](./pic/cc-chrome-plugin-2.png)\n\n---\n\n## 推荐插件\n\n本项目通过 `.claude/plugins.json` 声明了推荐的插件：\n\n- `context7` - 精准第三方库文档查询\n- `frontend-design` - 生成高质量前端界面代码\n- `gopls-lsp` / `jdtls-lsp` / `pyright-lsp` / `typescript-lsp` - 语言 LSP 支持\n- `superpowers` - 结构化开发框架\n- `code-review` - 多审查者代码审查\n\n**安装方式**：运行 `./tools/sync-config.sh`，脚本会自动检测缺失的插件并引导你一键安装。\n\n---\n\n# Part 2: Gemini CLI 配置（前端设计）\n\n\u003e 📖 **[完整指南](./docs/guides/gemini-cli.md)** - 前端场景速查、UI 风格约束、Vue 组件规范、MCP 工具使用\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"pic/cli-gemini-cli.svg\" alt=\"Gemini CLI 加载机制 + cc-use-exp 介入链路\" width=\"100%\" style=\"max-width: 1000px\" /\u003e\n\u003c/div\u003e\n\n\u003e 上图展示从 `gemini` 命令输入到 Gemini 3 模型输出的完整链路：① `GEMINI.md` 分层拼接（Global → Project → 子目录 JIT），通过 `@import` 注入 cc-use-exp 的 5 个 rules 文件；② Agent Skills（v0.24+）调用 `activate_skill` 工具弹确认后加载完整 SKILL.md；③ TOML Commands（如 `/layout`）和 Extensions（context7、chrome-devtools-mcp）显式介入。\n\n---\n\n## 快速开始\n\n### 零费力（自动生效）- GEMINI.md\n\nGEMINI.md 自动加载，提供以下保护：\n\n- **UI 风格约束**：禁止霓虹渐变、玻璃拟态、赛博风\n- **代码质量**：完整实现，禁止 MVP/占位/TODO\n- **中文交流**：统一使用中文回复和注释\n- **MCP 工具指南**：规范工具调用，避免滥用\n\n### 低费力（自动触发）- Skills\n\n操作相关文件时自动加载对应的开发规范：\n\n- **前端技能**：`frontend-safety`（数据绑定保护、布局一致性）\n- **设计技能**：`code-quality-principles`\n- **语言技能**：`go-dev`、`java-dev`、`python-dev`、`rust-dev`\n- **安全技能**：`ops-safety`、`api-design-safety`、`api-contract-safety`、`storage-url-safety`、`query-performance-safety`、`async-task-pattern`、`time-zone-safety`\n- **工具技能**：`bash-style`\n\n### 中费力（显式调用）- Commands\n\n输入 `/命令名` 执行工作流：\n\n**前端专用**：`/layout`、`/layout-check`、`/vue-split`、`/patch-http`\n\n**通用命令**：`/fix`、`/debug`、`/code-review`、`/quick-review`、`/commit-msg`、`/new-feature`\n\n---\n\n## 推荐扩展\n\n本项目通过 `.gemini/extensions.json` 声明了推荐的扩展：\n\n- `context7` - 精准第三方库文档查询\n- `chrome-devtools-mcp` - 前端页面真机调试、Lighthouse 审计\n\n**安装方式**：运行 `./tools/sync-config.sh`，脚本会自动检测缺失的扩展并引导你一键安装。\n\n---\n\n# Part 3: Codex 配置\n\n\u003e 📖 **[完整指南](./docs/guides/codex.md)** - 渐进式 Skills 配置、Profile 切换、审批规则、最佳实践\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"pic/cli-codex-cli.svg\" alt=\"Codex CLI 加载机制 + cc-use-exp 介入链路\" width=\"100%\" style=\"max-width: 1000px\" /\u003e\n\u003c/div\u003e\n\n\u003e 上图展示从 `codex --profile cc-balanced` 启动到 GPT-5.5 输出的完整链路：① `AGENTS.md` 链按 root → cwd 顺序合并，cc-use-exp 通过受管区块写入 `~/.codex/AGENTS.md`，并同步独立 profile 文件到 `~/.codex/{profile}.config.toml`，不动用户 auth/history；② Skills 渐进式披露（初始列表 ≤ 2% 上下文，命中后加载完整 SKILL.md）；③ Workflow Skills 通过 `$` 前缀显式触发，任务持久化到 `.codex/tasks/`。\n\n---\n\n## 快速开始\n\n### 一键安装\n\n**方式 1：会话内安装**\n\n在 Codex 会话中执行：\n```bash\n$skill-installer install https://github.com/doccker/cc-use-exp/.codex/skills/cc-skill-installer\n```\n\n**方式 2：Shell 脚本**\n\n在终端执行：\n```bash\nbash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-codex.sh)\n```\n\n### 零费力（自动生效）- Global AGENTS + Rules\n\n同步配置后自动生效：\n\n- **Global AGENTS**：极薄全局原则（先读代码、最小改动、验证、分层）\n- **Rules**：审批与危险命令控制\n- **Profiles**：`cc-fast-api`、`cc-balanced`、`cc-deep`、`cc-custom-instructions`\n\n### 低费力（自动触发）- Skills\n\n操作相关文件时自动加载对应的开发规范：\n\n- **设计技能**：`code-quality-principles`\n- **语言技能**：`go-dev`、`java-dev`、`frontend-dev`、`python-dev`、`rust-dev`\n- **安全技能**：`ops-safety`、`redis-safety`、`api-design-safety`、`api-contract-safety`、`storage-url-safety`、`query-performance-safety`、`async-task-pattern`、`time-zone-safety`\n- **重构技能**：`refactor-safety`、`field-mapping-safety`\n- **工具技能**：`bash-style`、`size-check`\n\n### 中费力（显式调用）- Workflow Skills\n\n输入 `$workflow-name` 执行工作流：\n\n**高频工作流**：`$cc-fix`、`$cc-review`、`$cc-commit-msg`\n\n**中频工作流**：`$optimize`、`$cc-new-feature`、`$design`、`$requirement`、`$cc-task-state`\n\n**低频工作流**：`$skill-update`、`$project-init`、`$project-scan`、`$status`\n\n兼容入口：`$cc-project-init` 等价于 `$project-init`，用于照顾按 cc-use-exp 前缀调用的习惯。\n\n项目级任务状态默认持久化到当前项目的 `.codex/tasks/`：\n\n- `$project-init` 用于生成项目级 `AGENTS.md`，并补齐项目级 `.codex` 最小骨架\n- `$project-scan` 用于扫描当前项目，生成或刷新项目级 `AGENTS.md` / `README.md`\n- `$cc-new-feature` 用于完整功能开发与任务推进\n- `$cc-task-state` 用于沉淀“还没开始 / 被打断 / 待恢复”的任务状态，避免进展只留在对话里\n\n使用 `codex --profile cc-custom-instructions`\n![Chrome 插件独立配置界面（可指定自定义模型）](./pic/codex-unlock.png)\n\n### 大陆网络下 `gpt` 频繁 `reconnecting`\n\n如果你在大陆网络环境下使用 Codex，并且在 `gpt` 会话里频繁看到 `reconnecting`，可以先尝试为 Codex 增加代理环境变量。\n\n仓库已提供可直接参考的模板文件：[`.codex/.env`](./.codex/.env)\n\n```env\nHTTP_PROXY=\"http://127.0.0.1:7897\"\nHTTPS_PROXY=\"http://127.0.0.1:7897\"\nNO_PROXY=\"localhost,127.0.0.1\"\n```\n\n使用方式：\n\n- 按你的本地代理实际端口修改 `127.0.0.1:7897`\n- 复制到 `~/.codex/.env`，让其他项目也能复用这份全局配置\n- 如果你只想对单个项目生效，也可以放到该项目的 `.codex/.env`\n\n\u003e **说明**：\n\u003e - 这份 `.env` 是模板，不会被 `tools/sync-config.sh` 自动同步到 `~/.codex/.env`\n\u003e - 这样做是为了避免覆盖用户已有的机器本地代理配置\n\u003e - 该方案来自实际使用验证，适合先作为网络层排查手段\n\n\n---\n\n# Part 4: Cursor 配置\n\n\u003e 📖 **[完整指南](./docs/guides/cursor.md)** - Rules 配置、Skills 语义匹配、Commands 使用、最佳实践\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"pic/cli-cursor.svg\" alt=\"Cursor 加载机制 + cc-use-exp 介入链路\" width=\"100%\" style=\"max-width: 1000px\" /\u003e\n\u003c/div\u003e\n\n\u003e 上图展示从 Cursor Chat（⌘L）输入到 Cursor Agent 输出的完整链路：① 优先级 Team → Project → User，cc-use-exp 在 `.cursor/rules/` 提供 6 个 `.mdc` 文件；② `.mdc` Frontmatter 决定加载方式：`alwaysApply` 始终生效（defensive）、`globs` 文件匹配（ops-safety）、`description` 由 Agent 语义匹配；③ Skills 通过 description 自动激活，Commands 通过 `/` 显式触发，仅作用于 Agent / Inline Edit。\n\n---\n\n## 快速开始\n\n### 一键安装\n\n在项目根目录执行：\n\n- **macOS/Linux**: `./tools/sync-config.sh`\n- **Windows**: `tools\\sync-config.bat`\n\n### 零费力（自动生效）- Rules\n\n项目内 `.cursor/rules/` 中的规则会自动生效：\n\n- **Always Apply**：`defensive.mdc`（防止测试篡改、过度工程化）\n- **Glob 匹配**：`ops-safety.mdc`、`bash-style.mdc`、`doc-sync.mdc`、`file-size-limit.mdc`\n\n### 低费力（自动触发）- Skills\n\nCursor Agent 根据 `description` 语义匹配，自动加载对应技能：\n\n- **设计技能**：`code-quality-principles`\n- **语言技能**：`go-dev`、`java-dev`、`frontend-dev`、`python-dev`、`rust-dev`\n- **安全技能**：`ops-safety`、`redis-safety`、`api-design-safety`、`api-contract-safety`、`storage-url-safety`、`query-performance-safety`、`async-task-pattern`、`time-zone-safety`\n- **重构技能**：`refactor-safety`、`field-mapping-safety`\n- **工具技能**：`bash-style`、`size-check`、`ruanzhu`、`ui-ux-pro-max`\n\n### 中费力（显式调用）- Commands\n\n在 Cursor 对话中输入 `/命令名`：\n\n**高频命令**：`/fix`、`/review`、`/commit-msg`\n\n**中频命令**：`/new-feature`、`/design`、`/requirement`、`/optimize`、`/style-extract`\n\n**低频命令**：`/skill-update`、`/project-init`、`/status`\n\n---\n\n# Part 5: GitHub Copilot 配置\n\n\u003e 📖 **完整指南**：本仓库 `.github/copilot-instructions.md` + `.github/instructions/*.instructions.md` + 仓库根 `AGENTS.md`\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"pic/cli-copilot.svg\" alt=\"GitHub Copilot 加载机制 + cc-use-exp 介入链路\" width=\"100%\" style=\"max-width: 1000px\" /\u003e\n\u003c/div\u003e\n\n\u003e 上图展示从 VS Code Chat / Copilot CLI / Cloud Agent 输入到 Copilot 模型输出的完整链路：① 仓库级 `.github/copilot-instructions.md` 保存即生效（Personal \u003e Repository \u003e Organization 优先级）；② Path-specific `.github/instructions/*.instructions.md` 按 `applyTo` 字段匹配文件路径自动注入；③ 仓库根 `AGENTS.md` 由 Coding Agent 优先读取，作为兜底配置（可与 copilot-instructions.md 共存）。\n\n---\n\n## 快速开始\n\n### 一键安装\n\n在终端执行：\n```bash\nbash \u003c(curl -sL https://raw.githubusercontent.com/doccker/cc-use-exp/main/tools/install-copilot.sh)\n```\n\n更新配置：重新运行安装脚本\n\n### 零费力（自动生效）- copilot-instructions.md\n\n`.github/copilot-instructions.md` 保存到仓库后立即生效，提供以下保护：\n\n- **工作方式**：先读代码、最小改动、复用现有模式、不主动扩需求\n- **质量要求**：错误行为/类型问题/缺失校验视为真实问题，不通过改测试掩盖错误实现\n- **协作输出**：默认简体中文，作者署名统一为 `wwj`\n- **分层引用**：语言/框架规范优先复用 `.codex/skills/`、`.claude/skills/`、`.cursor/skills/`\n\n### 低费力（路径匹配）- Path-specific instructions\n\n`.github/instructions/*.instructions.md` 按 `applyTo` 字段匹配文件路径自动注入：\n\n- `general.instructions.md`：通用规范\n- `frontend.instructions.md`：前端文件触发（Vue / TS / TSX）\n- `java.instructions.md`：Java 文件触发（Spring Boot 规范）\n\n\u003e 💡 **支持范围**：Copilot Chat（VS Code / Visual Studio）+ Copilot Cloud Agent\n\n### 中费力（兜底）- AGENTS.md\n\n仓库根目录维护的 `AGENTS.md` 由 Copilot Coding Agent 优先读取，与 `copilot-instructions.md` 共存。Copilot CLI 还支持个人级 `~/.copilot/copilot-instructions.md`。\n\n---\n\n## 许可声明\n\n本项目采用 **PolyForm Noncommercial 1.0.0** 许可证，仅授权非商业用途。\n\n| 用途 | 说明 |\n|------|------|\n| ✅ 个人学习、研究、实验 | 可自由使用 |\n| ✅ 学校、公益组织使用 | 可自由使用 |\n| ❌ 企业内部生产使用 | 需商业授权 |\n| ❌ 面向客户交付、SaaS 托管 | 需商业授权 |\n\n商业授权咨询：`作者` | 详见 [LICENSE](./LICENSE)\n\n### 联系作者\n\n\u003cimg src=\"pic/wx-hao.png\" alt=\"微信 wechat\" width=\"400\" /\u003e\n---\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=doccker/cc-use-exp\u0026type=Date)](https://star-history.com/#doccker/cc-use-exp\u0026Date)\n\n## Contributors\n\n\u003ca href=\"https://github.com/doccker/cc-use-exp/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=doccker/cc-use-exp\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoccker%2Fcc-use-exp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoccker%2Fcc-use-exp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoccker%2Fcc-use-exp/lists"}