{"id":50751792,"url":"https://github.com/xu-xiang/everything-claude-code-zh","last_synced_at":"2026-06-28T04:00:50.455Z","repository":{"id":335658141,"uuid":"1143408173","full_name":"xu-xiang/everything-claude-code-zh","owner":"xu-xiang","description":"everything-claude-code 中文翻译项目：完整的 Claude Code 配置集合（agents, skills, hooks, commands, rules, MCPs）。源自 Anthropic 黑客松获胜者的实战配置，助力中文工程师高效理解与使用 Claude Code。","archived":false,"fork":false,"pushed_at":"2026-01-31T11:25:27.000Z","size":13158,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-31T23:38:29.006Z","etag":null,"topics":["ai-agents","anthropic","claude","claude-code","developer-tools","everything-claude-code","llm","mcp","productivity"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xu-xiang.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":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-27T14:46:32.000Z","updated_at":"2026-01-31T20:30:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xu-xiang/everything-claude-code-zh","commit_stats":null,"previous_names":["xu-xiang/everything-claude-code-zh"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/xu-xiang/everything-claude-code-zh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-xiang%2Feverything-claude-code-zh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-xiang%2Feverything-claude-code-zh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-xiang%2Feverything-claude-code-zh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-xiang%2Feverything-claude-code-zh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xu-xiang","download_url":"https://codeload.github.com/xu-xiang/everything-claude-code-zh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xu-xiang%2Feverything-claude-code-zh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34876271,"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-06-28T02:00:05.809Z","response_time":54,"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":["ai-agents","anthropic","claude","claude-code","developer-tools","everything-claude-code","llm","mcp","productivity"],"created_at":"2026-06-11T02:00:24.513Z","updated_at":"2026-06-28T04:00:50.444Z","avatar_url":"https://github.com/xu-xiang.png","language":"JavaScript","funding_links":["https://github.com/sponsors/affaan-m"],"categories":["Claude Code Skills","Uncategorized"],"sub_categories":["开发辅助","Uncategorized"],"readme":"**语言:** [English](README.md) | **简体中文** | [繁體中文](docs/zh-TW/README.md)\n\n# Everything Claude Code\n\n[![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)\n[![Forks](https://img.shields.io/github/forks/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/network/members)\n[![Contributors](https://img.shields.io/github/contributors/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/graphs/contributors)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash\u0026logoColor=white)\n![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript\u0026logoColor=white)\n![Python](https://img.shields.io/badge/-Python-3776AB?logo=python\u0026logoColor=white)\n![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go\u0026logoColor=white)\n![Java](https://img.shields.io/badge/-Java-ED8B00?logo=openjdk\u0026logoColor=white)\n![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown\u0026logoColor=white)\n\n\u003e **50K+ stars** | **6K+ forks** | **30 contributors** | **6 种语言支持** | **Anthropic 黑客松获胜者**\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🌐 Language / 语言 / 語言**\n\n[**English**](README.md) | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja-JP/README.md)\n\n\u003c/div\u003e\n\n---\n\n**为 AI 智能体（Agent）框架打造的性能优化系统。源自 Anthropic 黑客松获胜作品。**\n\n这不仅仅是配置文件。它是一个完整的系统：包含技能（Skills）、本能（Instincts）、内存优化、持续学习、安全扫描以及研究优先的开发模式。这些生产级的智能体（Agents）、钩子（Hooks）、命令（Commands）、规则（Rules）以及 MCP 配置，是在构建真实产品的 10 个多月高强度日常使用中演化而来的。\n\n适用于 **Claude Code**, **Codex**, **Cowork** 以及其他 AI 智能体框架。\n\n---\n\n## 指南 (The Guides)\n\n本仓库仅包含原始代码。指南部分解释了所有细节。\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\u003ca href=\"https://x.com/affaanmustafa/status/2012378465664745795\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef\" alt=\"Everything Claude Code 简明指南\" /\u003e\n\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003ca href=\"https://x.com/affaanmustafa/status/2014040193557471352\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0\" alt=\"Everything Claude Code 详细指南\" /\u003e\n\u003c/a\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003cb\u003e简明指南 (Shorthand Guide)\u003c/b\u003e\u003cbr/\u003e设置、基础知识、哲学。\u003cb\u003e请先阅读此篇。\u003c/b\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cb\u003e详细指南 (Longform Guide)\u003c/b\u003e\u003cbr/\u003e令牌（Token）优化、内存持久化、评测（Evals）、并行化。\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n| 主题 | 你将学到什么 |\n|-------|-------------------|\n| 令牌（Token）优化 | 模型选择、系统提示词瘦身、后台进程 |\n| 内存持久化 | 跨会话自动保存/加载上下文的钩子 (Hooks) |\n| 持续学习 | 自动将会话模式提取为可重用的技能 (Skills) |\n| 验证循环 | 检查点 vs 持续评测、评分器类型、pass@k 指标 |\n| 并行化 | Git worktrees、级联方法、何时扩展实例 |\n| 子智能体编排 | 上下文问题、迭代检索模式 |\n\n---\n\n## 更新内容 (What's New)\n\n### v1.7.0 — 跨平台扩展与演示文稿生成器 (2026年2月)\n\n- **Codex 应用 + CLI 支持** — 直接支持基于 `AGENTS.md` 的 Codex，安装器目标定位及 Codex 文档\n- **`frontend-slides` 技能 (Skill)** — 无依赖的 HTML 演示文稿生成器，包含 PPTX 转换指南和严格的视口自适应规则\n- **5 个新型通用业务/内容技能** — `article-writing`（文章写作）、`content-engine`（内容引擎）、`market-research`（市场研究）、`investor-materials`（融资材料）、`investor-outreach`（投资者对接）\n- **更广的工具覆盖** — 强化了 Cursor、Codex 和 OpenCode 的支持，使同一仓库能在所有主流框架中无缝运行\n- **992 项内部测试** — 扩展了插件、钩子 (Hooks)、技能 (Skills) 及打包的验证与回归覆盖率\n\n### v1.6.0 — Codex CLI, AgentShield \u0026 市场 (2026年2月)\n\n- **Codex CLI 支持** — 新增 `/codex-setup` 命令，生成用于 OpenAI Codex CLI 兼容的 `codex.md`\n- **7 个新技能** — `search-first`、`swift-actor-persistence`、`swift-protocol-di-testing`、`regex-vs-llm-structured-text`、`content-hash-cache-pattern`、`cost-aware-llm-pipeline`、`skill-stocktake`\n- **AgentShield 集成** — `/security-scan` 技能可直接从 Claude Code 运行 AgentShield；包含 1282 项测试，102 条规则\n- **GitHub 市场 (Marketplace)** — ECC Tools GitHub 应用已在 [github.com/marketplace/ecc-tools](https://github.com/marketplace/ecc-tools) 上线，提供免费/专业/企业版\n- **合并 30+ 社区 PR** — 来自 6 种语言的 30 位贡献者的贡献\n- **978 项内部测试** — 扩展了涵盖智能体、技能、命令、钩子和规则的验证套件\n\n### v1.4.1 — Bug 修复 (2026年2月)\n\n- **修复本能 (Instinct) 导入内容丢失问题** — `parse_instinct_file()` 在执行 `/instinct-import` 时会静默丢弃 Frontmatter 之后的所有内容（Action、Evidence、Examples 部分）。由社区贡献者 @ericcai0814 修复 ([#148](https://github.com/affaan-m/everything-claude-code/issues/148), [#161](https://github.com/affaan-m/everything-claude-code/pull/161))\n\n### v1.4.0 — 多语言规则、安装向导与 PM2 (2026年2月)\n\n- **交互式安装向导** — 新增 `configure-ecc` 技能，提供带合并/覆盖检测的引导式设置\n- **PM2 与多智能体编排** — 6 个新命令（`/pm2`, `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend`, `/multi-workflow`）用于管理复杂的多服务工作流\n- **多语言规则架构** — 规则从扁平文件重构为 `common/` + `typescript/` + `python/` + `golang/` 目录。仅安装你需要的语言\n- **中文 (zh-CN) 翻译** — 完成了所有智能体、命令、技能和规则（80+ 文件）的完整翻译\n- **GitHub Sponsors 支持** — 可以通过 GitHub Sponsors 资助本项目\n- **增强的 CONTRIBUTING.md** — 为每种贡献类型提供了详细的 PR 模板\n\n### v1.3.0 — OpenCode 插件支持 (2026年2月)\n\n- **全面集成 OpenCode** — 12 个智能体、24 个命令、16 个技能，通过 OpenCode 的插件系统（20+ 事件类型）支持钩子\n- **3 个原生自定义工具** — run-tests（运行测试）、check-coverage（检查覆盖率）、security-audit（安全审计）\n- **LLM 文档** — 提供 `llms.txt` 以获取全面的 OpenCode 文档\n\n### v1.2.0 — 统一命令与技能 (2026年2月)\n\n- **Python/Django 支持** — Django 模式、安全、TDD 和验证技能\n- **Java Spring Boot 技能** — Spring Boot 的模式、安全、TDD 和验证\n- **会话管理** — `/sessions` 命令用于查看会话历史\n- **持续学习 v2** — 基于本能的带置信评分、导入/导出、进化的学习系统\n\n在 [Releases](https://github.com/affaan-m/everything-claude-code/releases) 中查看完整变更日志。\n\n---\n\n## 🚀 快速开始 (Quick Start)\n\n在 2 分钟内启动并运行：\n\n### 步骤 1：安装插件 (Plugin)\n\n```bash\n# 添加市场\n/plugin marketplace add affaan-m/everything-claude-code\n\n# 安装插件\n/plugin install everything-claude-code@everything-claude-code\n```\n\n### 步骤 2：安装规则 (Rules)（必选）\n\n\u003e ⚠️ **重要提示：** Claude Code 插件无法自动分发 `rules`（规则）。请手动安装：\n\n```bash\n# 首先克隆仓库\ngit clone https://github.com/affaan-m/everything-claude-code.git\ncd everything-claude-code\n\n# 推荐：使用安装脚本（安全处理通用规则和语言规则）\n./install.sh typescript    # 或 python 或 golang\n# 你可以传递多种语言：\n# ./install.sh typescript python golang\n# 或者针对 cursor 安装：\n# ./install.sh --target cursor typescript\n```\n\n有关手动安装的说明，请参阅 `rules/` 文件夹中的 README。\n\n### 步骤 3：开始使用\n\n```bash\n# 尝试一个命令（插件安装使用命名空间形式）\n/everything-claude-code:plan \"添加用户身份验证\"\n\n# 手动安装（选项 2）使用简短形式：\n# /plan \"添加用户身份验证\"\n\n# 查看可用命令\n/plugin list everything-claude-code@everything-claude-code\n```\n\n✨ **完成！** 你现在可以访问 13 个智能体（Agents）、56 个技能（Skills）和 32 个命令（Commands）。\n\n---\n\n## 🌐 跨平台支持 (Cross-Platform Support)\n\n该插件现已全面支持 **Windows, macOS 和 Linux**。所有钩子和脚本已使用 Node.js 重写，以实现最大兼容性。\n\n### 包管理器检测 (Package Manager Detection)\n\n插件会自动检测你首选的包管理器（npm, pnpm, yarn 或 bun），优先级如下：\n\n1. **环境变量**: `CLAUDE_PACKAGE_MANAGER`\n2. **项目配置**: `.claude/package-manager.json`\n3. **package.json**: `packageManager` 字段\n4. **锁文件**: 从 package-lock.json, yarn.lock, pnpm-lock.yaml 或 bun.lockb 检测\n5. **全局配置**: `~/.claude/package-manager.json`\n6. **备选方案**: 首个可用的包管理器\n\n设置你首选的包管理器：\n\n```bash\n# 通过环境变量\nexport CLAUDE_PACKAGE_MANAGER=pnpm\n\n# 通过全局配置\nnode scripts/setup-package-manager.js --global pnpm\n\n# 通过项目配置\nnode scripts/setup-package-manager.js --project bun\n\n# 检测当前设置\nnode scripts/setup-package-manager.js --detect\n```\n\n或者在 Claude Code 中使用 `/setup-pm` 命令。\n\n---\n\n## 📦 包含内容 (What's Inside)\n\n本仓库是一个 **Claude Code 插件** —— 你可以直接安装，也可以手动复制组件。\n\n```\neverything-claude-code/\n|-- .claude-plugin/   # 插件与市场清单文件\n|   |-- plugin.json         # 插件元数据与组件路径\n|   |-- marketplace.json    # 用于 /plugin marketplace add 的市场目录\n|\n|-- agents/           # 专门用于任务委派的子智能体 (Subagents)\n|   |-- planner.md           # 功能实现规划\n|   |-- architect.md         # 系统设计决策\n|   |-- tdd-guide.md         # 测试驱动开发 (TDD)\n|   |-- code-reviewer.md     # 质量与安全审查\n|   |-- security-reviewer.md # 漏洞分析\n|   |-- build-error-resolver.md # 构建错误修复\n|   |-- e2e-runner.md        # Playwright E2E 测试\n|   |-- refactor-cleaner.md  # 废弃代码清理\n|   |-- doc-updater.md       # 文档同步更新\n|   |-- go-reviewer.md       # Go 代码审查\n|   |-- go-build-resolver.md # Go 构建错误修复\n|   |-- python-reviewer.md   # Python 代码审查 (新增)\n|   |-- database-reviewer.md # 数据库/Supabase 审查 (新增)\n|\n|-- skills/           # 工作流定义与领域知识\n|   |-- coding-standards/           # 语言最佳实践\n|   |-- clickhouse-io/              # ClickHouse 分析、查询、数据工程\n|   |-- backend-patterns/           # API、数据库、缓存模式\n|   |-- frontend-patterns/          # React, Next.js 模式\n|   |-- frontend-slides/            # HTML 幻灯片与 PPTX 转网页演示工作流 (新增)\n|   |-- article-writing/            # 使用指定语气进行长文写作，无 AI 腔 (新增)\n|   |-- content-engine/             # 多平台社交内容与重用工作流 (新增)\n|   |-- market-research/            # 带源码引用的市场、竞对和投资者研究 (新增)\n|   |-- investor-materials/         # 商业计划书、一页纸介绍、备忘录和财务模型 (新增)\n|   |-- investor-outreach/          # 个性化融资对接与后续跟进 (新增)\n|   |-- continuous-learning/        # 从会话中自动提取模式 (详细指南)\n|   |-- continuous-learning-v2/     # 基于本能的带置信评分的学习系统\n|   |-- iterative-retrieval/        # 为子智能体提供的渐进式上下文精炼\n|   |-- strategic-compact/          # 手动压缩建议 (详细指南)\n|   |-- tdd-workflow/               # TDD 方法论\n|   |-- security-review/            # 安全自查表\n|   |-- eval-harness/               # 验证循环评测 (详细指南)\n|   |-- verification-loop/          # 持续验证 (详细指南)\n|   |-- golang-patterns/            # Go 惯用法与最佳实践\n|   |-- golang-testing/             # Go 测试模式、TDD、基准测试\n|   |-- cpp-coding-standards/         # 源自 C++ Core Guidelines 的 C++ 编码标准 (新增)\n|   |-- cpp-testing/                # 使用 GoogleTest, CMake/CTest 的 C++ 测试 (新增)\n|   |-- django-patterns/            # Django 模式、模型、视图 (新增)\n|   |-- django-security/            # Django 安全最佳实践 (新增)\n|   |-- django-tdd/                 # Django TDD 工作流 (新增)\n|   |-- django-verification/        # Django 验证循环 (新增)\n|   |-- python-patterns/            # Python 惯用法与最佳实践 (新增)\n|   |-- python-testing/             # 使用 pytest 的 Python 测试 (新增)\n|   |-- springboot-patterns/        # Java Spring Boot 模式 (新增)\n|   |-- springboot-security/        # Spring Boot 安全 (新增)\n|   |-- springboot-tdd/             # Spring Boot TDD (新增)\n|   |-- springboot-verification/    # Spring Boot 验证 (新增)\n|   |-- configure-ecc/              # 交互式安装向导 (新增)\n|   |-- security-scan/              # AgentShield 安全审计集成 (新增)\n|   |-- java-coding-standards/     # Java 编码标准 (新增)\n|   |-- jpa-patterns/              # JPA/Hibernate 模式 (新增)\n|   |-- postgres-patterns/         # PostgreSQL 优化模式 (新增)\n|   |-- nutrient-document-processing/ # 使用 Nutrient API 处理文档 (新增)\n|   |-- project-guidelines-example/   # 项目特定技能模板\n|   |-- database-migrations/         # 迁移模式 (Prisma, Drizzle, Django, Go) (新增)\n|   |-- api-design/                  # REST API 设计、分页、错误响应 (新增)\n|   |-- deployment-patterns/         # CI/CD, Docker, 健康检查, 回滚 (新增)\n|   |-- docker-patterns/            # Docker Compose, 网络, 卷, 容器安全 (新增)\n|   |-- e2e-testing/                 # Playwright E2E 模式与页面对象模型 (POM) (新增)\n|   |-- content-hash-cache-pattern/  # 用于文件处理的 SHA-256 内容哈希缓存 (新增)\n|   |-- cost-aware-llm-pipeline/     # LLM 成本优化、模型路由、预算追踪 (新增)\n|   |-- regex-vs-llm-structured-text/ # 决策框架：正则 vs LLM 解析文本 (新增)\n|   |-- swift-actor-persistence/     # 使用 Actor 的线程安全 Swift 数据持久化 (新增)\n|   |-- swift-protocol-di-testing/   # 基于协议的 DI 用于可测试的 Swift 代码 (新增)\n|   |-- search-first/               # 编码前研究工作流 (新增)\n|   |-- skill-stocktake/            # 审核技能与命令的质量 (新增)\n|   |-- liquid-glass-design/         # iOS 26 Liquid Glass 设计系统 (新增)\n|   |-- foundation-models-on-device/ # 使用 FoundationModels 的 Apple 端侧 LLM (新增)\n|   |-- swift-concurrency-6-2/       # Swift 6.2 易用并发 (新增)\n|   |-- autonomous-loops/           # 自主循环模式：顺序流水线、PR 循环、DAG 编排 (新增)\n|   |-- plankton-code-quality/      # 使用 Plankton 钩子在编写时强制执行代码质量 (新增)\n|\n|-- commands/         # 用于快速执行的斜杠命令 (Slash commands)\n|   |-- tdd.md              # /tdd - 测试驱动开发\n|   |-- plan.md             # /plan - 实现规划\n|   |-- e2e.md              # /e2e - E2E 测试生成\n|   |-- code-review.md      # /code-review - 质量审查\n|   |-- build-fix.md        # /build-fix - 修复构建错误\n|   |-- refactor-clean.md   # /refactor-clean - 废弃代码移除\n|   |-- learn.md            # /learn - 会话中提取模式 (详细指南)\n|   |-- learn-eval.md       # /learn-eval - 提取、评测并保存模式 (新增)\n|   |-- checkpoint.md       # /checkpoint - 保存验证状态 (详细指南)\n|   |-- verify.md           # /verify - 运行验证循环 (详细指南)\n|   |-- setup-pm.md         # /setup-pm - 配置包管理器\n|   |-- go-review.md        # /go-review - Go 代码审查 (新增)\n|   |-- go-test.md          # /go-test - Go TDD 工作流 (新增)\n|   |-- go-build.md         # /go-build - 修复 Go 构建错误 (新增)\n|   |-- skill-create.md     # /skill-create - 从 git 历史生成技能 (新增)\n|   |-- instinct-status.md  # /instinct-status - 查看已学本能 (新增)\n|   |-- instinct-import.md  # /instinct-import - 导入本能 (新增)\n|   |-- instinct-export.md  # /instinct-export - 导出本能 (新增)\n|   |-- evolve.md           # /evolve - 将相关本能聚类为技能\n|   |-- pm2.md              # /pm2 - PM2 服务生命周期管理 (新增)\n|   |-- multi-plan.md       # /multi-plan - 多智能体任务分解 (新增)\n|   |-- multi-execute.md    # /multi-execute - 编排的多智能体工作流 (新增)\n|   |-- multi-backend.md    # /multi-backend - 后端多服务编排 (新增)\n|   |-- multi-frontend.md   # /multi-frontend - 前端多服务编排 (新增)\n|   |-- multi-workflow.md   # /multi-workflow - 通用多服务工作流 (新增)\n|   |-- orchestrate.md      # /orchestrate - 多智能体协调\n|   |-- sessions.md         # /sessions - 会话历史管理\n|   |-- eval.md             # /eval - 根据准则评测\n|   |-- test-coverage.md    # /test-coverage - 测试覆盖率分析\n|   |-- update-docs.md      # /update-docs - 更新文档\n|   |-- update-codemaps.md  # /update-codemaps - 更新代码映射 (codemaps)\n|   |-- python-review.md    # /python-review - Python 代码审查 (新增)\n|\n|-- rules/            # 必须遵守的准则 (复制到 ~/.claude/rules/)\n|   |-- README.md            # 结构概览与安装指南\n|   |-- common/              # 语言无关原则\n|   |   |-- coding-style.md    # 不变性、文件组织\n|   |   |-- git-workflow.md    # 提交格式、PR 流程\n|   |   |-- testing.md         # TDD, 80% 覆盖率要求\n|   |   |-- performance.md     # 模型选择、上下文管理\n|   |   |-- patterns.md        # 设计模式、骨架项目\n|   |   |-- hooks.md           # 钩子架构、TodoWrite\n|   |   |-- agents.md          # 何时委派给子智能体\n|   |   |-- security.md        # 强制性安全检查\n|   |-- typescript/          # TypeScript/JavaScript 特定\n|   |-- python/              # Python 特定\n|   |-- golang/              # Go 特定\n|\n|-- hooks/            # 基于触发器的自动化\n|   |-- README.md                 # 钩子文档、配方与自定义指南\n|   |-- hooks.json                # 所有钩子配置 (PreToolUse, PostToolUse, Stop 等)\n|   |-- memory-persistence/       # 会话生命周期钩子 (详细指南)\n|   |-- strategic-compact/        # 压缩建议 (详细指南)\n|\n|-- scripts/          # 跨平台 Node.js 脚本 (新增)\n|   |-- lib/                     # 共享实用工具\n|   |   |-- utils.js             # 跨平台文件/路径/系统实用程序\n|   |   |-- package-manager.js   # 包管理器检测与选择\n|   |-- hooks/                   # 钩子实现\n|   |   |-- session-start.js     # 会话开始时加载上下文\n|   |   |-- session-end.js       # 会话结束时保存状态\n|   |   |-- pre-compact.js       # 压缩前状态保存\n|   |   |-- suggest-compact.js   # 策略性压缩建议\n|   |   |-- evaluate-session.js  # 从会话中提取模式\n|   |-- setup-package-manager.js # 交互式 PM 设置\n|\n|-- tests/            # 测试套件 (新增)\n|   |-- lib/                     # 库测试\n|   |-- hooks/                   # 钩子测试\n|   |-- run-all.js               # 运行所有测试\n|\n|-- contexts/         # 动态系统提示词注入上下文 (详细指南)\n|   |-- dev.md              # 开发模式上下文\n|   |-- review.md           # 代码审查模式上下文\n|   |-- research.md         # 研究/探索模式上下文\n|\n|-- examples/         # 示例配置与会话\n|   |-- CLAUDE.md             # 示例项目级配置\n|   |-- user-CLAUDE.md        # 示例用户级配置\n|   |-- saas-nextjs-CLAUDE.md   # 真实 SaaS (Next.js + Supabase + Stripe)\n|   |-- go-microservice-CLAUDE.md # 真实 Go 微服务 (gRPC + PostgreSQL)\n|   |-- django-api-CLAUDE.md      # 真实 Django REST API (DRF + Celery)\n|   |-- rust-api-CLAUDE.md        # 真实 Rust API (Axum + SQLx + PostgreSQL) (新增)\n|\n|-- mcp-configs/      # MCP 服务器配置\n|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway 等\n|\n|-- marketplace.json  # 自托管市场配置 (用于 /plugin marketplace add)\n```\n\n---\n\n## 🛠️ 生态工具 (Ecosystem Tools)\n\n### 技能生成器 (Skill Creator)\n\n有两种方法可以从你的仓库生成 Claude Code 技能 (Skills)：\n\n#### 选项 A：本地分析（内置）\n\n使用 `/skill-create` 命令进行本地分析，无需外部服务：\n\n```bash\n/skill-create                    # 分析当前仓库\n/skill-create --instincts        # 同时生成用于持续学习的本能 (instincts)\n```\n\n这将本地分析你的 git 历史并生成 SKILL.md 文件。\n\n#### 选项 B：GitHub 应用（高级）\n\n适用于高级功能（10k+ 提交、自动 PR、团队共享）：\n\n[安装 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)\n\n```bash\n# 在任何 issue 下留言：\n/skill-creator analyze\n\n# 或者在推送到默认分支时自动触发\n```\n\n两个选项都会创建：\n- **SKILL.md 文件** - 可供 Claude Code 直接使用的技能\n- **本能集合 (Instinct collections)** - 适用于 continuous-learning-v2\n- **模式提取 (Pattern extraction)** - 从你的提交历史中学习\n\n### AgentShield — 安全审计器 (Security Auditor)\n\n\u003e 在 Claude Code 黑客松（Cerebral Valley x Anthropic, 2026年2月）中构建。包含 1282 项测试，98% 覆盖率，102 条静态分析规则。\n\n扫描你的 Claude Code 配置是否存在漏洞、错误配置和注入风险。\n\n```bash\n# 快速扫描（无需安装）\nnpx ecc-agentshield scan\n\n# 自动修复安全问题\nnpx ecc-agentshield scan --fix\n\n# 使用三个 Opus 4.6 智能体进行深度分析\nnpx ecc-agentshield scan --opus --stream\n\n# 从头开始生成安全配置\nnpx ecc-agentshield init\n```\n\n**扫描范围：** CLAUDE.md, settings.json, MCP 配置, 钩子 (Hooks), 智能体定义以及 5 个类别的技能 —— 密钥检测（14 种模式）、权限审计、钩子注入分析、MCP 服务器风险分析以及智能体配置审查。\n\n**`--opus` 标志** 在红队/蓝队/审计员流水线中运行三个 Claude Opus 4.6 智能体。攻击者寻找攻击链，防御者评估防护措施，审计员将两者整合为优先排序的风险评估。这是对抗性推理，而非简单的模式匹配。\n\n**输出格式：** 终端（彩色分级 A-F）、JSON（CI 流水线）、Markdown、HTML。发现严重问题时退出代码为 2，用于构建门禁。\n\n在 Claude Code 中使用 `/security-scan` 运行，或通过 [GitHub Action](https://github.com/affaan-m/agentshield) 添加到 CI。\n\n[GitHub](https://github.com/affaan-m/agentshield) | [npm](https://www.npmjs.com/package/ecc-agentshield)\n\n### 🔬 Plankton — 编写时代码质量强制执行\n\nPlankton（鸣谢：@alxfazio）是推荐的代码编写时质量强制执行伙伴。它通过 PostToolUse 钩子在每次文件编辑时运行格式化程序和 20+ 个 linter，然后产生 Claude 子进程（根据违规复杂程度路由至 Haiku/Sonnet/Opus）来修复主智能体遗漏的问题。三阶段架构：静默自动格式化（解决 40-50% 的问题）、收集剩余违规为结构化 JSON、将修复委派给子进程。包含配置保护钩子，防止智能体为了通过检查而修改 linter 配置。支持 Python, TypeScript, Shell, YAML, JSON, TOML, Markdown 和 Dockerfile。配合 AgentShield 使用，可实现安全 + 质量覆盖。完整集成指南请见 `skills/plankton-code-quality/`。\n\n### 🧠 持续学习 v2 (Continuous Learning v2)\n\n基于本能的学习系统会自动学习你的模式：\n\n```bash\n/instinct-status        # 显示已学习的本能及其置信度\n/instinct-import \u003cfile\u003e # 导入他人的本能\n/instinct-export        # 导出你的本能进行分享\n/evolve                 # 将相关本能聚类为技能 (Skills)\n```\n\n完整文档请见 `skills/continuous-learning-v2/`。\n\n---\n\n## 📋 要求 (Requirements)\n\n### Claude Code CLI 版本\n\n**最低版本：v2.1.0 或更高**\n\n由于插件系统处理钩子 (Hooks) 方式的变更，该插件需要 Claude Code CLI v2.1.0+。\n\n检查你的版本：\n```bash\nclaude --version\n```\n\n### 重要提示：钩子自动加载行为\n\n\u003e ⚠️ **致贡献者：** 请勿在 `.claude-plugin/plugin.json` 中添加 `\"hooks\"` 字段。这已通过回归测试强制执行。\n\nClaude Code v2.1+ 会按约定从任何已安装的插件中**自动加载** `hooks/hooks.json`。在 `plugin.json` 中显式声明会导致重复检测错误：\n\n```\nDuplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file\n```\n\n**历史背景：** 这在该仓库中曾导致反复的修复/回滚循环（[#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)）。由于 Claude Code 版本间的行为变更导致了混淆。我们现在已加入回归测试以防此类问题再次出现。\n\n---\n\n## 📥 安装 (Installation)\n\n### 选项 1：作为插件安装（推荐）\n\n使用本仓库最简单的方法 —— 作为 Claude Code 插件安装：\n\n```bash\n# 将本仓库添加为市场\n/plugin marketplace add affaan-m/everything-claude-code\n\n# 安装插件\n/plugin install everything-claude-code@everything-claude-code\n```\n\n或者直接添加到你的 `~/.claude/settings.json`：\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"everything-claude-code\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"affaan-m/everything-claude-code\"\n      }\n    }\n  },\n  \"enabledPlugins\": {\n    \"everything-claude-code@everything-claude-code\": true\n  }\n}\n```\n\n这将使你立即获得对所有命令、智能体、技能和钩子的访问权限。\n\n\u003e **注意：** Claude Code 插件系统目前不支持通过插件分发 `rules`（规则）（[上游限制](https://code.claude.com/docs/en/plugins-reference)）。你需要手动安装规则：\n\u003e\n\u003e ```bash\n\u003e # 首先克隆仓库\n\u003e git clone https://github.com/affaan-m/everything-claude-code.git\n\u003e\n\u003e # 选项 A：用户级规则（适用于所有项目）\n\u003e mkdir -p ~/.claude/rules\n\u003e cp -r everything-claude-code/rules/common/* ~/.claude/rules/\n\u003e cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/   # 选择你的技术栈\n\u003e cp -r everything-claude-code/rules/python/* ~/.claude/rules/\n\u003e cp -r everything-claude-code/rules/golang/* ~/.claude/rules/\n\u003e\n\u003e # 选项 B：项目级规则（仅适用于当前项目）\n\u003e mkdir -p .claude/rules\n\u003e cp -r everything-claude-code/rules/common/* .claude/rules/\n\u003e cp -r everything-claude-code/rules/typescript/* .claude/rules/     # 选择你的技术栈\n\u003e ```\n\n---\n\n### 🔧 选项 2：手动安装\n\n如果你更喜欢手动控制安装内容：\n\n```bash\n# 克隆仓库\ngit clone https://github.com/affaan-m/everything-claude-code.git\n\n# 将智能体复制到你的 Claude 配置目录\ncp everything-claude-code/agents/*.md ~/.claude/agents/\n\n# 复制规则（通用规则 + 特定语言规则）\ncp -r everything-claude-code/rules/common/* ~/.claude/rules/\ncp -r everything-claude-code/rules/typescript/* ~/.claude/rules/   # 选择你的技术栈\ncp -r everything-claude-code/rules/python/* ~/.claude/rules/\ncp -r everything-claude-code/rules/golang/* ~/.claude/rules/\n\n# 复制命令\ncp everything-claude-code/commands/*.md ~/.claude/commands/\n\n# 复制技能（核心 vs 细分领域）\n# 推荐（新用户）：仅安装核心/通用技能\ncp -r everything-claude-code/.agents/skills/* ~/.claude/skills/\ncp -r everything-claude-code/skills/search-first ~/.claude/skills/\n\n# 可选：仅在需要时添加细分/框架特定技能\n# for s in django-patterns django-tdd springboot-patterns; do\n#   cp -r everything-claude-code/skills/$s ~/.claude/skills/\n# done\n```\n\n#### 将钩子添加到 settings.json\n\n将 `hooks/hooks.json` 中的钩子复制到你的 `~/.claude/settings.json` 中。\n\n#### 配置 MCPs\n\n将 `mcp-configs/mcp-servers.json` 中所需的 MCP 服务器复制到你的 `~/.claude.json` 中。\n\n**重要提示：** 请将 `YOUR_*_HERE` 占位符替换为你真实的 API 密钥。\n\n---\n\n## 🎯 核心概念 (Key Concepts)\n\n### 智能体 (Agents)\n\n子智能体 (Subagents) 处理范围内受限的委派任务。示例：\n\n```markdown\n---\nname: code-reviewer\ndescription: 审查代码的质量、安全性和可维护性\ntools: [\"Read\", \"Grep\", \"Glob\", \"Bash\"]\nmodel: opus\n---\n\n你是一名资深代码审查员...\n```\n\n### 技能 (Skills)\n\n技能是由命令或智能体调用的工作流定义：\n\n```markdown\n# TDD 工作流\n\n1. 先定义接口\n2. 编写失败的测试 (RED)\n3. 实现最简代码 (GREEN)\n4. 重构 (IMPROVE)\n5. 验证 80%+ 的覆盖率\n```\n\n### 钩子 (Hooks)\n\n钩子在工具事件上触发。示例 —— 警告 console.log：\n\n```json\n{\n  \"matcher\": \"tool == \\\"Edit\\\" \u0026\u0026 tool_input.file_path matches \\\"\\\\\\\\.(ts|tsx|js|jsx)$\\\"\",\n  \"hooks\": [{\n    \"type\": \"command\",\n    \"command\": \"#!/bin/bash\\ngrep -n 'console\\\\.log' \\\"$file_path\\\" \u0026\u0026 echo '[Hook] Remove console.log' \u003e\u00262\"\n  }]\n}\n```\n\n### 规则 (Rules)\n\n规则是必须遵守的准则，组织在 `common/`（语言无关）+ 特定语言目录中：\n\n```\nrules/\n  common/          # 通用原则（始终安装）\n  typescript/      # TS/JS 特定模式与工具\n  python/          # Python 特定模式与工具\n  golang/          # Go 特定模式与工具\n```\n\n安装和结构细节请参见 [`rules/README.md`](rules/README.md)。\n\n---\n\n## 🗺️ 我该使用哪个智能体 (Agent)？\n\n不确定从哪里开始？请参考此快速指南：\n\n| 我想... | 使用此命令 | 使用的智能体 (Agent) |\n|--------------|-----------------|------------|\n| 规划新功能 | `/everything-claude-code:plan \"添加认证\"` | planner |\n| 设计系统架构 | `/everything-claude-code:plan` + architect 智能体 | architect |\n| 先写测试再写代码 | `/tdd` | tdd-guide |\n| 审查我刚写的代码 | `/code-review` | code-reviewer |\n| 修复构建失败 | `/build-fix` | build-error-resolver |\n| 运行端到端 (E2E) 测试 | `/e2e` | e2e-runner |\n| 查找安全漏洞 | `/security-scan` | security-reviewer |\n| 移除废弃代码 | `/refactor-clean` | refactor-cleaner |\n| 更新文档 | `/update-docs` | doc-updater |\n| 审查 Go 代码 | `/go-review` | go-reviewer |\n| 审查 Python 代码 | `/python-review` | python-reviewer |\n| 审计数据库查询 | *(自动委派)* | database-reviewer |\n\n### 常见工作流 (Common Workflows)\n\n**开始新功能：**\n```\n/everything-claude-code:plan \"使用 OAuth 添加用户身份验证\"\n                                              → planner 创建实现蓝图\n/tdd                                          → tdd-guide 强制执行先写测试\n/code-review                                  → code-reviewer 检查你的工作\n```\n\n**修复 Bug：**\n```\n/tdd                                          → tdd-guide: 编写一个复现问题的失败测试\n                                              → 实现修复，验证测试通过\n/code-review                                  → code-reviewer: 捕捉回归问题\n```\n\n**准备生产发布：**\n```\n/security-scan                                → security-reviewer: OWASP Top 10 审计\n/e2e                                          → e2e-runner: 关键用户流程测试\n/test-coverage                                → 验证 80%+ 覆盖率\n```\n\n---\n\n## ❓ 常见问题 (FAQ)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e如何检查安装了哪些智能体/命令？\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n/plugin list everything-claude-code@everything-claude-code\n```\n\n这将显示插件中所有可用的智能体、命令和技能。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e我的钩子 (Hooks) 没生效 / 我看到了 \"Duplicate hooks file\" 错误\u003c/b\u003e\u003c/summary\u003e\n\n这是最常见的问题。**请勿在 `.claude-plugin/plugin.json` 中添加 `\"hooks\"` 字段。** Claude Code v2.1+ 会自动从已安装的插件中加载 `hooks/hooks.json`。显式声明会导致重复检测错误。参见 [#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e我的上下文窗口正在缩小 / Claude 耗尽了上下文\u003c/b\u003e\u003c/summary\u003e\n\n过多的 MCP 服务器会消耗你的上下文。每个 MCP 工具描述都会从你 200k 的窗口中消耗令牌，可能会将其减少到 ~70k。\n\n**解决方法：** 按项目禁用不使用的 MCP：\n```json\n// 在项目的 .claude/settings.json 中\n{\n  \"disabledMcpServers\": [\"supabase\", \"railway\", \"vercel\"]\n}\n```\n\n保持启用少于 10 个 MCP，且活动工具少于 80 个。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e我能只使用部分组件吗（例如只用智能体）？\u003c/b\u003e\u003c/summary\u003e\n\n可以。使用选项 2（手动安装）并仅复制你需要的部分：\n\n```bash\n# 仅智能体\ncp everything-claude-code/agents/*.md ~/.claude/agents/\n\n# 仅规则\ncp -r everything-claude-code/rules/common/* ~/.claude/rules/\n```\n\n每个组件都是完全独立的。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e这是否适用于 Cursor / OpenCode / Codex？\u003c/b\u003e\u003c/summary\u003e\n\n是的。ECC 是跨平台的：\n- **Cursor**: 预翻译的配置位于 `.cursor/`。参见 [Cursor IDE 支持](#cursor-ide-支持)。\n- **OpenCode**: 完整的插件支持位于 `.opencode/`。参见 [OpenCode 支持](#-opencode-支持)。\n- **Codex**: 具有适配器偏移保护和 SessionStart 降级的一流支持。参见 PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257)。\n- **Claude Code**: 原生支持 —— 这是主要目标。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e如何贡献新的技能或智能体？\u003c/b\u003e\u003c/summary\u003e\n\n参见 [CONTRIBUTING.md](CONTRIBUTING.md)。简短版本：\n1. Fork 本仓库\n2. 在 `skills/your-skill-name/SKILL.md`（带 YAML Frontmatter）中创建你的技能\n3. 或在 `agents/your-agent.md` 中创建智能体\n4. 提交 PR，并清晰描述其功能及使用场景\n\u003c/details\u003e\n\n---\n\n## 🧪 运行测试 (Running Tests)\n\n插件包含一个全面的测试套件：\n\n```bash\n# 运行所有测试\nnode tests/run-all.js\n\n# 运行单个测试文件\nnode tests/lib/utils.test.js\nnode tests/lib/package-manager.test.js\nnode tests/hooks/hooks.test.js\n```\n\n---\n\n## 🤝 贡献 (Contributing)\n\n**欢迎并鼓励各类贡献。**\n\n本仓库旨在成为社区资源。如果你有：\n- 有用的智能体 (Agents) 或技能 (Skills)\n- 巧妙的钩子 (Hooks)\n- 更好的 MCP 配置\n- 改进的规则 (Rules)\n\n请贡献出来！准则请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n### 贡献想法\n\n- 特定语言技能（Rust, C#, Swift, Kotlin）—— 已包含 Go, Python, Java\n- 特定框架配置（Rails, Laravel, FastAPI, NestJS）—— 已包含 Django, Spring Boot\n- DevOps 智能体（Kubernetes, Terraform, AWS, Docker）\n- 测试策略（不同框架、视觉回归）\n- 特定领域知识（机器学习、数据工程、移动端）\n\n---\n\n## Cursor IDE 支持 (Cursor IDE Support)\n\nECC 提供了**完整的 Cursor IDE 支持**，包含适配 Cursor 原生格式的钩子、规则、智能体、技能、命令和 MCP 配置。\n\n### 快速开始 (Cursor)\n\n```bash\n# 为你的语言安装\n./install.sh --target cursor typescript\n./install.sh --target cursor python golang swift\n```\n\n### 包含内容\n\n| 组件 | 数量 | 详情 |\n|-----------|-------|---------|\n| 钩子事件 | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt, 以及另外 10 个 |\n| 钩子脚本 | 16 | 极简 Node.js 脚本，通过共享适配器委派给 `scripts/hooks/` |\n| 规则 (Rules) | 29 | 9 条通用规则 (alwaysApply) + 20 条语言特定规则 (TypeScript, Python, Go, Swift) |\n| 智能体 (Agents) | 共享 | 通过根目录的 AGENTS.md（被 Cursor 原生读取） |\n| 技能 (Skills) | 共享 + 打包 | 通过根目录的 AGENTS.md 以及 `.cursor/skills/` 中翻译的补充内容 |\n| 命令 (Commands) | 共享 | 如果安装，位于 `.cursor/commands/` |\n| MCP 配置 | 共享 | 如果安装，位于 `.cursor/mcp.json` |\n\n### 钩子架构（DRY 适配器模式）\n\nCursor 拥有的**钩子事件比 Claude Code 更多**（20 个 vs 8 个）。`.cursor/hooks/adapter.js` 模块将 Cursor 的 stdin JSON 转换为 Claude Code 的格式，从而允许重用现有的 `scripts/hooks/*.js` 而无需重复。\n\n```\nCursor stdin JSON → adapter.js → 转换 → scripts/hooks/*.js\n                                         (与 Claude Code 共享)\n```\n\n关键钩子：\n- **beforeShellExecution** —— 阻止 tmux 之外的开发服务器运行 (exit 2)，审查 git push\n- **afterFileEdit** —— 自动格式化 + TypeScript 检查 + console.log 警告\n- **beforeSubmitPrompt** —— 在提示词中检测密钥（sk-, ghp_, AKIA 等模式）\n- **beforeTabFileRead** —— 阻止 Tab 读取 .env, .key, .pem 文件 (exit 2)\n- **beforeMCPExecution / afterMCPExecution** —— MCP 审计日志记录\n\n### 规则格式 (Rules Format)\n\nCursor 规则使用带有 `description`, `globs` 和 `alwaysApply` 的 YAML Frontmatter：\n\n```yaml\n---\ndescription: \"扩展通用规则的 TypeScript 编码风格\"\nglobs: [\"**/*.ts\", \"**/*.tsx\", \"**/*.js\", \"**/*.jsx\"]\nalwaysApply: false\n---\n```\n\n---\n\n## Codex CLI 支持 (Codex CLI Support)\n\nECC 提供了**一流的 Codex CLI 支持**，包含参考配置、Codex 特定的 AGENTS.md 补充以及 16 个移植的技能。\n\n### 快速开始 (Codex)\n\n```bash\n# 将参考配置复制到你的用户目录\ncp .codex/config.toml ~/.codex/config.toml\n\n# 在仓库中运行 Codex —— 将自动检测 AGENTS.md\ncodex\n```\n\n### 包含内容\n\n| 组件 | 数量 | 详情 |\n|-----------|-------|---------|\n| 配置 | 1 | `.codex/config.toml` —— 模型、权限、MCP 服务器、持久化指令 |\n| AGENTS.md | 2 | 根目录（通用）+ `.codex/AGENTS.md`（Codex 特定补充） |\n| 技能 (Skills) | 16 | `.agents/skills/` —— 每个技能包含 SKILL.md + agents/openai.yaml |\n| MCP 服务器 | 4 | GitHub, Context7, Memory, Sequential Thinking (基于命令) |\n| 配置文件 (Profiles) | 2 | `strict`（只读沙箱）和 `yolo`（全自动确认） |\n\n### 技能 (Skills)\n\n`.agents/skills/` 下的技能会被 Codex 自动加载：\n\n| 技能 | 描述 |\n|-------|-------------|\n| tdd-workflow | 80%+ 覆盖率的测试驱动开发 |\n| security-review | 全面的安全自查表 |\n| coding-standards | 通用编码标准 |\n| frontend-patterns | React/Next.js 模式 |\n| frontend-slides | HTML 幻灯片、PPTX 转换、视觉风格探索 |\n| article-writing | 基于笔记和语音参考的长文写作 |\n| content-engine | 平台原生的社交内容与重用 |\n| market-research | 带源码引用的市场与竞对研究 |\n| investor-materials | 商业计划书、备忘录、模型和一页纸介绍 |\n| investor-outreach | 个性化对接、后续跟进和介绍短文 |\n| backend-patterns | API 设计、数据库、缓存 |\n| e2e-testing | Playwright E2E 测试 |\n| eval-harness | 评测驱动开发 |\n| strategic-compact | 上下文管理 |\n| api-design | REST API 设计模式 |\n| verification-loop | 构建、测试、lint、类型检查、安全 |\n\n### 关键限制\n\nCodex CLI **目前尚不支持钩子** (OpenAI Codex Issue #2109, 430+ 赞)。安全强制执行是通过 config.toml 中的 `persistent_instructions` 以及沙箱权限系统基于指令实现的。\n\n---\n\n## 🔌 OpenCode 支持 (OpenCode Support)\n\nECC 提供了**完整的 OpenCode 支持**，包括插件和钩子 (Hooks)。\n\n### 快速开始\n\n```bash\n# 安装 OpenCode\nnpm install -g opencode\n\n# 在仓库根目录运行\nopencode\n```\n\n配置将自动从 `.opencode/opencode.json` 检测。\n\n### 功能对齐 (Feature Parity)\n\n| 功能 | Claude Code | OpenCode | 状态 |\n|---------|-------------|----------|--------|\n| 智能体 (Agents) | ✅ 13 个 | ✅ 12 个 | **Claude Code 领先** |\n| 命令 (Commands) | ✅ 33 个 | ✅ 24 个 | **Claude Code 领先** |\n| 技能 (Skills) | ✅ 50+ 个 | ✅ 37 个 | **Claude Code 领先** |\n| 钩子 (Hooks) | ✅ 8 种事件类型 | ✅ 11 个事件 | **OpenCode 更多！** |\n| 规则 (Rules) | ✅ 29 条规则 | ✅ 13 条指令 | **Claude Code 领先** |\n| MCP 服务器 | ✅ 14 个 | ✅ 完整支持 | **功能持平** |\n| 自定义工具 | ✅ 通过钩子实现 | ✅ 6 个原生工具 | **OpenCode 更好** |\n\n### 通过插件支持钩子\n\nOpenCode 的插件系统比 Claude Code 更复杂，拥有 20 多种事件类型：\n\n| Claude Code 钩子 | OpenCode 插件事件 |\n|-----------------|----------------------|\n| PreToolUse | `tool.execute.before` |\n| PostToolUse | `tool.execute.after` |\n| Stop | `session.idle` |\n| SessionStart | `session.created` |\n| SessionEnd | `session.deleted` |\n\n**额外的 OpenCode 事件**：`file.edited`, `file.watcher.updated`, `message.updated`, `lsp.client.diagnostics`, `tui.toast.show` 等。\n\n### 可用命令 (32 个)\n\n| 命令 | 描述 |\n|---------|-------------|\n| `/plan` | 创建实现计划 |\n| `/tdd` | 强制执行 TDD 工作流 |\n| `/code-review` | 审查代码变更 |\n| `/build-fix` | 修复构建错误 |\n| `/e2e` | 生成 E2E 测试 |\n| `/refactor-clean` | 移除废弃代码 |\n| `/orchestrate` | 多智能体工作流 |\n| `/learn` | 从会话中提取模式 |\n| `/checkpoint` | 保存验证状态 |\n| `/verify` | 运行验证循环 |\n| `/eval` | 根据准则评测 |\n| `/update-docs` | 更新文档 |\n| `/update-codemaps` | 更新代码映射 (codemaps) |\n| `/test-coverage` | 分析覆盖率 |\n| `/go-review` | Go 代码审查 |\n| `/go-test` | Go TDD 工作流 |\n| `/go-build` | 修复 Go 构建错误 |\n| `/python-review` | Python 代码审查 (PEP 8, 类型提示, 安全) |\n| `/multi-plan` | 多模型协同规划 |\n| `/multi-execute` | 多模型协同执行 |\n| `/multi-backend` | 侧重后端的多模型工作流 |\n| `/multi-frontend` | 侧重前端的多模型工作流 |\n| `/multi-workflow` | 全面的多模型开发工作流 |\n| `/pm2` | 自动生成 PM2 服务命令 |\n| `/sessions` | 管理会话历史 |\n| `/skill-create` | 从 git 生成技能 |\n| `/instinct-status` | 查看已学本能 (instincts) |\n| `/instinct-import` | 导入本能 |\n| `/instinct-export` | 导出本能 |\n| `/evolve` | 将本能聚类为技能 |\n| `/promote` | 将项目本能提升至全局范围 |\n| `/projects` | 列出已知项目及本能统计 |\n| `/learn-eval` | 在保存前提取并评测模式 |\n| `/setup-pm` | 配置包管理器 |\n\n### 插件安装\n\n**选项 1：直接使用**\n```bash\ncd everything-claude-code\nopencode\n```\n\n**选项 2：作为 npm 包安装**\n```bash\nnpm install ecc-universal\n```\n\n然后添加到你的 `opencode.json`：\n```json\n{\n  \"plugin\": [\"ecc-universal\"]\n}\n```\n\n### 文档\n\n- **迁移指南**: `.opencode/MIGRATION.md`\n- **OpenCode 插件 README**: `.opencode/README.md`\n- **整合规则**: `.opencode/instructions/INSTRUCTIONS.md`\n- **LLM 文档**: `llms.txt`（为 LLM 提供的完整 OpenCode 文档）\n\n---\n\n## 跨工具功能对齐 (Cross-Tool Feature Parity)\n\nECC 是**首个最大化利用各大主要 AI 编程工具的插件**。以下是各框架的对比：\n\n| 功能 | Claude Code | Cursor IDE | Codex CLI | OpenCode |\n|---------|------------|------------|-----------|----------|\n| **智能体 (Agents)** | 13 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |\n| **命令 (Commands)** | 33 | 共享 | 基于指令 | 24 |\n| **技能 (Skills)** | 50+ | 共享 | 10 (原生格式) | 37 |\n| **钩子事件** | 8 种类型 | 15 种类型 | 尚无 | 11 种类型 |\n| **钩子脚本** | 9 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 |\n| **规则 (Rules)** | 29 (通用+语言) | 29 (YAML Frontmatter) | 基于指令 | 13 条指令 |\n| **自定义工具** | 通过钩子实现 | 通过钩子实现 | N/A | 6 个原生工具 |\n| **MCP 服务器** | 14 | 共享 (mcp.json) | 4 (基于命令) | 完整支持 |\n| **配置格式** | settings.json | hooks.json + rules/ | config.toml | opencode.json |\n| **上下文文件** | CLAUDE.md + AGENTS.md | AGENTS.md | AGENTS.md | AGENTS.md |\n| **密钥检测** | 基于钩子 | beforeSubmitPrompt 钩子 | 基于沙箱 | 基于钩子 |\n| **自动格式化** | PostToolUse 钩子 | afterFileEdit 钩子 | N/A | file.edited 钩子 |\n| **版本** | 插件 | 插件 | 参考配置 | 1.6.0 |\n\n**关键架构决策：**\n- 根目录下的 **AGENTS.md** 是通用的跨工具文件（被所有 4 种工具读取）\n- **DRY 适配器模式** 让 Cursor 能够重用 Claude Code 的钩子脚本而无需重复\n- **技能格式**（带 YAML Frontmatter 的 SKILL.md）可跨 Claude Code, Codex 和 OpenCode 使用\n- Codex 缺乏钩子的弱点通过 `persistent_instructions` 和沙箱权限得到了弥补\n\n---\n\n## 📖 背景 (Background)\n\n我从实验性发布阶段就开始使用 Claude Code。在 2025 年 9 月与 [@DRodriguezFX](https://x.com/DRodriguezFX) 一起，完全使用 Claude Code 开发了 [zenith.chat](https://zenith.chat)，并赢得了 Anthropic x Forum Ventures 黑客松。\n\n这些配置在多个生产级应用中经过了实战测试。\n\n---\n\n## 令牌（Token）优化\n\n如果你不管理令牌消耗，使用 Claude Code 可能会很昂贵。以下设置可以在不牺牲质量的前提下显著降低成本。\n\n### 推荐设置\n\n添加到 `~/.claude/settings.json`：\n\n```json\n{\n  \"model\": \"sonnet\",\n  \"env\": {\n    \"MAX_THINKING_TOKENS\": \"10000\",\n    \"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE\": \"50\"\n  }\n}\n```\n\n| 设置 | 默认值 | 推荐值 | 影响 |\n|---------|---------|-------------|--------|\n| `model` | opus | **sonnet** | 约 60% 成本降低；可处理 80%+ 的编程任务 |\n| `MAX_THINKING_TOKENS` | 31,999 | **10,000** | 每次请求的隐藏思考成本降低约 70% |\n| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 95 | **50** | 更早进行压缩 —— 在长会话中保持更好质量 |\n\n仅在需要深度架构推理时切换到 Opus：\n```\n/model opus\n```\n\n### 日常工作流命令\n\n| 命令 | 何时使用 |\n|---------|-------------|\n| `/model sonnet` | 大多数任务的默认选择 |\n| `/model opus` | 复杂架构、调试、深度推理 |\n| `/clear` | 在无关任务之间（免费、即时重置） |\n| `/compact` | 在逻辑任务断点（研究完成、里程碑达成） |\n| `/cost` | 监控会话期间的令牌支出 |\n\n### 策略性压缩 (Strategic Compaction)\n\n本插件包含的 `strategic-compact` 技能建议在逻辑断点处执行 `/compact`，而不是依赖 95% 上下文时的自动压缩。完整决策指南请参见 `skills/strategic-compact/SKILL.md`。\n\n**何时进行压缩：**\n- 研究/探索后，实现代码前\n- 完成一个里程碑后，开始下一个前\n- 调试完成后，继续功能开发前\n- 方案失败后，尝试新方案前\n\n**何时不要压缩：**\n- 实现过程中（你会丢失变量名、文件路径、部分状态）\n\n### 上下文窗口管理\n\n**至关重要：** 不要一次性启用所有 MCP。每个 MCP 工具描述都会从你 200k 的窗口中消耗令牌，可能会将其减少到 ~70k。\n\n- 每个项目保持启用少于 10 个 MCP\n- 保持活动工具少于 80 个\n- 在项目配置中使用 `disabledMcpServers` 来禁用不使用的服务\n\n### 智能体团队 (Agent Teams) 成本警告\n\n智能体团队会产生多个上下文窗口。每个团队成员独立消耗令牌。仅在并行化能带来明显价值的任务中使用（多模块工作、并行审查）。对于简单的顺序任务，子智能体 (Subagents) 更节省令牌。\n\n---\n\n## ⚠️ 重要注意事项\n\n### 令牌（Token）优化\n\n达到每日限额了？请参阅 **[令牌优化指南](docs/token-optimization.md)** 以获取推荐设置和工作流建议。\n\n快速见效方案：\n\n```json\n// ~/.claude/settings.json\n{\n  \"model\": \"sonnet\",\n  \"env\": {\n    \"MAX_THINKING_TOKENS\": \"10000\",\n    \"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE\": \"50\",\n    \"CLAUDE_CODE_SUBAGENT_MODEL\": \"haiku\"\n  }\n}\n```\n\n在无关任务间使用 `/clear`，在逻辑断点使用 `/compact`，并使用 `/cost` 监控支出。\n\n### 自定义\n\n这些配置适用于我的工作流。你应该：\n1. 从产生共鸣的部分开始\n2. 根据你的技术栈进行修改\n3. 移除不使用的部分\n4. 添加你自己的模式\n\n---\n\n## 💜 赞助者 (Sponsors)\n\n本项目免费且开源。赞助者的支持有助于维持其维护和成长。\n\n[**成为赞助者**](https://github.com/sponsors/affaan-m) | [赞助等级](SPONSORS.md)\n\n---\n\n## 🌟 星标历史 (Star History)\n\n[![星标历史图表](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code\u0026type=Date)](https://star-history.com/#affaan-m/everything-claude-code\u0026Date)\n\n---\n\n## 🔗 链接 (Links)\n\n- **简明指南（从这里开始）：** [Everything Claude Code 简明指南](https://x.com/affaanmustafa/status/2012378465664745795)\n- **详细指南（高级）：** [Everything Claude Code 详细指南](https://x.com/affaanmustafa/status/2014040193557471352)\n- **关注：** [@affaanmustafa](https://x.com/affaanmustafa)\n- **zenith.chat:** [zenith.chat](https://zenith.chat)\n- **技能目录：** awesome-agent-skills（社区维护的智能体技能目录）\n\n---\n\n## 📄 许可证 (License)\n\nMIT - 自由使用，根据需要修改，如果可以请回馈贡献。\n\n---\n\n**如果本项目对你有帮助，请点亮 Star。阅读两份指南。构建伟大的产品。**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxu-xiang%2Feverything-claude-code-zh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxu-xiang%2Feverything-claude-code-zh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxu-xiang%2Feverything-claude-code-zh/lists"}