docs(zh-CN): sync Chinese docs with latest upstream changes (#304)

* docs(zh-CN): sync Chinese docs with latest upstream changes * update --------- Co-authored-by: neo <neo.dowithless@gmail.com>
2026-03-30 13:43:26 +08:00 · 2026-03-03 14:28:27 +08:00
parent adc0f67008
commit ada4cd75a3
114 changed files with 11161 additions and 4790 deletions
--- a/docs/zh-CN/README.md
+++ b/docs/zh-CN/README.md
@@ -1,4 +1,4 @@
-**语言:** English | [繁體中文](../zh-TW/README.md) | [简体中文](README.md)
+**语言：** 英语 | [繁體中文](../zh-TW/README.md) | [简体中文](../../README.md)

 # Everything Claude Code

@@ -13,7 +13,7 @@
 ![Java](https://img.shields.io/badge/-Java-ED8B00?logo=openjdk\&logoColor=white)
 ![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown\&logoColor=white)

-> **42K+ 星标** | **5K+ 分支** | **24 位贡献者** | **支持 6 种语言**
+> **5万+ stars** | **6千+ forks** | **30位贡献者** | **支持6种语言** | **Anthropic黑客马拉松获胜者**

 ***

@@ -21,7 +21,7 @@

 **🌐 语言 / 语言 / 語言**

-[**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../../docs/zh-TW/README.md)
+[**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md)

 </div>

@@ -69,6 +69,23 @@

 ## 最新动态

+### v1.7.0 — 跨平台扩展与演示文稿生成器（2026年2月）
+
+* **Codex 应用 + CLI 支持** — 基于 `AGENTS.md` 的直接 Codex 支持、安装器目标定位以及 Codex 文档
+* **`frontend-slides` 技能** — 零依赖的 HTML 演示文稿生成器，附带 PPTX 转换指导和严格的视口适配规则
+* **5个新的通用业务/内容技能** — `article-writing`、`content-engine`、`market-research`、`investor-materials`、`investor-outreach`
+* **更广泛的工具覆盖** — 加强了对 Cursor、Codex 和 OpenCode 的支持，使得同一代码仓库可以在所有主要平台上干净地部署
+* **992项内部测试** — 在插件、钩子、技能和打包方面扩展了验证和回归测试覆盖
+
+### v1.6.0 — Codex CLI、AgentShield 与市场（2026年2月）
+
+* **Codex CLI 支持** — 新的 `/codex-setup` 命令生成 `codex.md` 以实现 OpenAI Codex CLI 兼容性
+* **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`
+* **AgentShield 集成** — `/security-scan` 技能直接从 Claude Code 运行 AgentShield；1282 项测试，102 条规则
+* **GitHub 市场** — ECC Tools GitHub 应用已在 [github.com/marketplace/ecc-tools](https://github.com/marketplace/ecc-tools) 上线，提供免费/专业/企业版
+* **合并了 30+ 个社区 PR** — 来自 6 种语言的 30 位贡献者的贡献
+* **978项内部测试** — 在代理、技能、命令、钩子和规则方面扩展了验证套件
+
 ### v1.4.1 — 错误修复 (2026年2月)

 * **修复了直觉导入内容丢失问题** — `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))
@@ -120,27 +137,32 @@
 ```bash
 # Clone the repo first
 git clone https://github.com/affaan-m/everything-claude-code.git
+cd everything-claude-code

-# Install common rules (required)
-cp -r everything-claude-code/rules/common/* ~/.claude/rules/
-
-# Install language-specific rules (pick your stack)
-cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/
-cp -r everything-claude-code/rules/python/* ~/.claude/rules/
-cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
+# Recommended: use the installer (handles common + language rules safely)
+./install.sh typescript    # or python or golang
+# You can pass multiple languages:
+# ./install.sh typescript python golang
+# or target cursor:
+# ./install.sh --target cursor typescript
 ```

+手动安装说明请参阅 `rules/` 文件夹中的 README。
+
 ### 步骤 3：开始使用

 ```bash
-# Try a command
-/plan "Add user authentication"
+# Try a command (plugin install uses namespaced form)
+/everything-claude-code:plan "Add user authentication"
+
+# Manual install (Option 2) uses the shorter form:
+# /plan "Add user authentication"

 # Check available commands
 /plugin list everything-claude-code@everything-claude-code
 ```

-✨ **就是这样！** 您现在可以访问 15+ 个智能体，30+ 个技能，以及 30+ 个命令。
+✨ **就是这样！** 你现在可以访问 13 个代理、56 个技能和 32 个命令。

 ***

@@ -185,11 +207,11 @@ node scripts/setup-package-manager.js --detect

 ```
 everything-claude-code/
-|-- .claude-plugin/   # 插件和插件市场清单
+|-- .claude-plugin/   # 插件和市场清单
 |   |-- plugin.json         # 插件元数据和组件路径
 |   |-- marketplace.json    # 用于 /plugin marketplace add 的市场目录
 |
-|-- agents/           # 用于任务委派的专用子代理
+|-- agents/           # 用于委派的专用子代理
 |   |-- planner.md           # 功能实现规划
 |   |-- architect.md         # 系统设计决策
 |   |-- tdd-guide.md         # 测试驱动开发
@@ -205,20 +227,28 @@ everything-claude-code/
 |   |-- database-reviewer.md # 数据库/Supabase 审查（新增）
 |
 |-- skills/           # 工作流定义与领域知识
-|   |-- coding-standards/           # 各语言最佳实践
+|   |-- coding-standards/           # 语言最佳实践
+|   |-- clickhouse-io/              # ClickHouse 分析、查询与数据工程
 |   |-- backend-patterns/           # API、数据库、缓存模式
 |   |-- frontend-patterns/          # React、Next.js 模式
-|   |-- continuous-learning/        # 从会话中自动提取模式（长文档指南）
+|   |-- frontend-slides/            # HTML 幻灯片与 PPTX 转 Web 演示流程（新增）
+|   |-- article-writing/            # 使用指定风格进行长文写作（避免通用 AI 语气）（新增）
+|   |-- content-engine/             # 多平台内容创作与再利用工作流（新增）
+|   |-- market-research/            # 带来源标注的市场、竞品与投资人研究（新增）
+|   |-- investor-materials/         # 融资路演材料、单页纸、备忘录与财务模型（新增）
+|   |-- investor-outreach/          # 个性化融资外联与跟进（新增）
+|   |-- continuous-learning/        # 从会话中自动提取模式（长文指南）
 |   |-- continuous-learning-v2/     # 基于直觉的学习与置信度评分
-|   |-- iterative-retrieval/        # 子代理的渐进式上下文精炼
-|   |-- strategic-compact/          # 手动压缩建议（长文档指南）
+|   |-- iterative-retrieval/        # 子代理渐进式上下文优化
+|   |-- strategic-compact/          # 手动压缩建议（长文指南）
 |   |-- tdd-workflow/               # TDD 方法论
 |   |-- security-review/            # 安全检查清单
-|   |-- eval-harness/               # 验证循环评估（长文档指南）
-|   |-- verification-loop/          # 持续验证（长文档指南）
-|   |-- golang-patterns/            # Go 语言惯用法与最佳实践
+|   |-- eval-harness/               # 验证循环评估（长文指南）
+|   |-- verification-loop/          # 持续验证（长文指南）
+|   |-- golang-patterns/            # Go 惯用法与最佳实践
 |   |-- golang-testing/             # Go 测试模式、TDD 与基准测试
-|   |-- cpp-testing/                # 使用 GoogleTest、CMake/CTest 的 C++ 测试（新增）
+|   |-- cpp-coding-standards/         # 来自 C++ Core Guidelines 的 C++ 编码规范（新增）
+|   |-- cpp-testing/                # 使用 GoogleTest 与 CMake/CTest 的 C++ 测试（新增）
 |   |-- django-patterns/            # Django 模式、模型与视图（新增）
 |   |-- django-security/            # Django 安全最佳实践（新增）
 |   |-- django-tdd/                 # Django TDD 工作流（新增）
@@ -228,25 +258,46 @@ everything-claude-code/
 |   |-- springboot-patterns/        # Java Spring Boot 模式（新增）
 |   |-- springboot-security/        # Spring Boot 安全（新增）
 |   |-- springboot-tdd/             # Spring Boot TDD（新增）
-|   |-- springboot-verification/    # Spring Boot 验证流程（新增）
+|   |-- springboot-verification/    # Spring Boot 验证（新增）
 |   |-- configure-ecc/              # 交互式安装向导（新增）
 |   |-- security-scan/              # AgentShield 安全审计集成（新增）
+|   |-- java-coding-standards/     # Java 编码规范（新增）
+|   |-- jpa-patterns/              # JPA/Hibernate 模式（新增）
+|   |-- postgres-patterns/         # PostgreSQL 优化模式（新增）
+|   |-- nutrient-document-processing/ # 使用 Nutrient API 的文档处理（新增）
+|   |-- project-guidelines-example/   # 项目专用技能模板
+|   |-- database-migrations/         # 迁移模式（Prisma、Drizzle、Django、Go）（新增）
+|   |-- api-design/                  # REST API 设计、分页与错误响应（新增）
+|   |-- deployment-patterns/         # CI/CD、Docker、健康检查与回滚（新增）
+|   |-- docker-patterns/            # Docker Compose、网络、卷与容器安全（新增）
+|   |-- e2e-testing/                 # Playwright 端到端模式与页面对象模型（新增）
+|   |-- content-hash-cache-pattern/  # 基于 SHA-256 内容哈希的文件处理缓存（新增）
+|   |-- cost-aware-llm-pipeline/     # LLM 成本优化、模型路由与预算跟踪（新增）
+|   |-- regex-vs-llm-structured-text/ # 决策框架：文本解析使用正则还是 LLM（新增）
+|   |-- swift-actor-persistence/     # 使用 Actor 实现线程安全的 Swift 数据持久化（新增）
+|   |-- swift-protocol-di-testing/   # 基于协议的依赖注入，实现可测试的 Swift 代码（新增）
+|   |-- search-first/               # 先研究后编码的工作流（新增）
+|   |-- skill-stocktake/            # 技能与命令质量审计（新增）
+|   |-- liquid-glass-design/         # iOS 26 Liquid Glass 设计系统（新增）
+|   |-- foundation-models-on-device/ # Apple 设备端 LLM 与 FoundationModels（新增）
+|   |-- swift-concurrency-6-2/       # Swift 6.2 易用并发（新增）
 |
-|-- commands/         # 快捷执行的 Slash 命令
+|-- commands/         # 快速执行的斜杠命令
 |   |-- tdd.md              # /tdd - 测试驱动开发
 |   |-- plan.md             # /plan - 实现规划
 |   |-- e2e.md              # /e2e - 端到端测试生成
 |   |-- code-review.md      # /code-review - 质量审查
 |   |-- build-fix.md        # /build-fix - 修复构建错误
-|   |-- refactor-clean.md   # /refactor-clean - 清理无用代码
-|   |-- learn.md            # /learn - 会话中提取模式（长文档指南）
-|   |-- checkpoint.md       # /checkpoint - 保存验证状态（长文档指南）
-|   |-- verify.md           # /verify - 运行验证循环（长文档指南）
+|   |-- refactor-clean.md   # /refactor-clean - 无用代码清理
+|   |-- learn.md            # /learn - 会话中提取模式（长文指南）
+|   |-- learn-eval.md       # /learn-eval - 提取、评估并保存模式（新增）
+|   |-- checkpoint.md       # /checkpoint - 保存验证状态（长文指南）
+|   |-- verify.md           # /verify - 执行验证循环（长文指南）
 |   |-- setup-pm.md         # /setup-pm - 配置包管理器
 |   |-- go-review.md        # /go-review - Go 代码审查（新增）
-|   |-- go-test.md          # /go-test - Go 的 TDD 工作流（新增）
+|   |-- go-test.md          # /go-test - Go TDD 工作流（新增）
 |   |-- go-build.md         # /go-build - 修复 Go 构建错误（新增）
-|   |-- skill-create.md     # /skill-create - 从 Git 历史生成技能（新增）
+|   |-- skill-create.md     # /skill-create - 从 git 历史生成技能（新增）
 |   |-- instinct-status.md  # /instinct-status - 查看已学习的直觉（新增）
 |   |-- instinct-import.md  # /instinct-import - 导入直觉（新增）
 |   |-- instinct-export.md  # /instinct-export - 导出直觉（新增）
@@ -257,26 +308,34 @@ everything-claude-code/
 |   |-- multi-backend.md    # /multi-backend - 后端多服务编排（新增）
 |   |-- multi-frontend.md   # /multi-frontend - 前端多服务编排（新增）
 |   |-- multi-workflow.md   # /multi-workflow - 通用多服务工作流（新增）
+|   |-- orchestrate.md      # /orchestrate - 多代理协调
+|   |-- sessions.md         # /sessions - 会话历史管理
+|   |-- eval.md             # /eval - 按标准评估
+|   |-- test-coverage.md    # /test-coverage - 测试覆盖率分析
+|   |-- update-docs.md      # /update-docs - 更新文档
+|   |-- update-codemaps.md  # /update-codemaps - 更新代码映射
+|   |-- python-review.md    # /python-review - Python 代码审查（新增）
 |
 |-- rules/            # 必须遵循的规则（复制到 ~/.claude/rules/）
-|   |-- README.md            # 结构概览与安装指南
-|   |-- common/              # 与语言无关的通用原则
+|   |-- README.md            # 结构说明与安装指南
+|   |-- common/              # 与语言无关的原则
 |   |   |-- coding-style.md    # 不可变性与文件组织
 |   |   |-- git-workflow.md    # 提交格式与 PR 流程
-|   |   |-- testing.md         # TDD，80% 覆盖率要求
+|   |   |-- testing.md         # TDD 与 80% 覆盖率要求
 |   |   |-- performance.md     # 模型选择与上下文管理
-|   |   |-- patterns.md        # 设计模式与项目骨架
+|   |   |-- patterns.md        # 设计模式与骨架项目
 |   |   |-- hooks.md           # Hook 架构与 TodoWrite
 |   |   |-- agents.md          # 何时委派给子代理
 |   |   |-- security.md        # 强制安全检查
-|   |-- typescript/          # TypeScript / JavaScript 专用
+|   |-- typescript/          # TypeScript/JavaScript 专用
 |   |-- python/              # Python 专用
 |   |-- golang/              # Go 专用
 |
 |-- hooks/            # 基于触发器的自动化
+|   |-- README.md                 # Hook 文档、示例与自定义指南
 |   |-- hooks.json                # 所有 Hook 配置（PreToolUse、PostToolUse、Stop 等）
-|   |-- memory-persistence/       # 会话生命周期 Hook（长文档指南）
-|   |-- strategic-compact/        # 压缩建议（长文档指南）
+|   |-- memory-persistence/       # 会话生命周期 Hook（长文指南）
+|   |-- strategic-compact/        # 压缩建议（长文指南）
 |
 |-- scripts/          # 跨平台 Node.js 脚本（新增）
 |   |-- lib/                     # 共享工具
@@ -286,7 +345,7 @@ everything-claude-code/
 |   |   |-- session-start.js     # 会话开始时加载上下文
 |   |   |-- session-end.js       # 会话结束时保存状态
 |   |   |-- pre-compact.js       # 压缩前状态保存
-|   |   |-- suggest-compact.js   # 战略性压缩建议
+|   |   |-- suggest-compact.js   # 战略压缩建议
 |   |   |-- evaluate-session.js  # 从会话中提取模式
 |   |-- setup-package-manager.js # 交互式包管理器设置
 |
@@ -295,19 +354,23 @@ everything-claude-code/
 |   |-- hooks/                   # Hook 测试
 |   |-- run-all.js               # 运行所有测试
 |
-|-- contexts/         # 动态系统提示注入上下文（长文档指南）
+|-- contexts/         # 动态系统提示注入上下文（长文指南）
 |   |-- dev.md              # 开发模式上下文
 |   |-- review.md           # 代码审查模式上下文
 |   |-- research.md         # 研究/探索模式上下文
 |
 |-- examples/         # 示例配置与会话
-|   |-- CLAUDE.md           # 项目级配置示例
-|   |-- user-CLAUDE.md      # 用户级配置示例
+|   |-- CLAUDE.md             # 项目级配置示例
+|   |-- user-CLAUDE.md        # 用户级配置示例
+|   |-- saas-nextjs-CLAUDE.md   # 实际 SaaS 示例（Next.js + Supabase + Stripe）
+|   |-- go-microservice-CLAUDE.md # 实际 Go 微服务示例（gRPC + PostgreSQL）
+|   |-- django-api-CLAUDE.md      # 实际 Django REST API 示例（DRF + Celery）
+|   |-- rust-api-CLAUDE.md        # 实际 Rust API 示例（Axum + SQLx + PostgreSQL）（新增）
 |
 |-- mcp-configs/      # MCP 服务器配置
 |   |-- mcp-servers.json    # GitHub、Supabase、Vercel、Railway 等
 |
-|-- marketplace.json  # 自托管插件市场配置（用于 /plugin marketplace add）
+|-- marketplace.json  # 自托管市场配置（用于 /plugin marketplace add）
 ```

 ***
@@ -350,6 +413,8 @@ everything-claude-code/

 ### AgentShield — 安全审计器

+> 在 Claude Code 黑客马拉松（Cerebral Valley x Anthropic，2026年2月）上构建。1282 项测试，98% 覆盖率，102 条静态分析规则。
+
 扫描您的 Claude Code 配置，查找漏洞、错误配置和注入风险。

 ```bash
@@ -359,14 +424,18 @@ npx ecc-agentshield scan
 # Auto-fix safe issues
 npx ecc-agentshield scan --fix

-# Deep analysis with Opus 4.6
+# Deep analysis with three Opus 4.6 agents
 npx ecc-agentshield scan --opus --stream

 # Generate secure config from scratch
 npx ecc-agentshield init
 ```

-检查 CLAUDE.md、settings.json、MCP 服务器、钩子和智能体定义。生成带有可操作发现的安全等级 (A-F)。
+**它扫描什么：** CLAUDE.md、settings.json、MCP 配置、钩子、代理定义以及 5 个类别的技能 —— 密钥检测（14 种模式）、权限审计、钩子注入分析、MCP 服务器风险剖析和代理配置审查。
+
+**`--opus` 标志** 在红队/蓝队/审计员管道中运行三个 Claude Opus 4.6 代理。攻击者寻找利用链，防御者评估保护措施，审计员将两者综合成优先风险评估。对抗性推理，而不仅仅是模式匹配。
+
+**输出格式：** 终端（按颜色分级的 A-F）、JSON（CI 管道）、Markdown、HTML。在关键发现时退出代码 2，用于构建门控。

 在 Claude Code 中使用 `/security-scan` 来运行它，或者通过 [GitHub Action](https://github.com/affaan-m/agentshield) 添加到 CI。

@@ -449,23 +518,23 @@ Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded fil

 这将使您能够立即访问所有命令、代理、技能和钩子。

-> **注意：** Claude Code 插件系统不支持通过插件分发 `rules`（[上游限制](https://code.claude.com/docs/en/plugins-reference)）。您需要手动安装规则：
+> **注意：** Claude Code 插件系统不支持通过插件分发 `rules`（[上游限制](https://code.claude.com/docs/en/plugins-reference)）。你需要手动安装规则：
 >
 > ```bash
 > # 首先克隆仓库
 > git clone https://github.com/affaan-m/everything-claude-code.git
 >
-> # 选项 A：用户级规则（适用于所有项目）
+> # 选项 A：用户级规则（应用于所有项目）
 > mkdir -p ~/.claude/rules
 > cp -r everything-claude-code/rules/common/* ~/.claude/rules/
-> cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/   # 选择您的技术栈
+> cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/   # 选择你的技术栈
 > cp -r everything-claude-code/rules/python/* ~/.claude/rules/
 > cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
 >
-> # 选项 B：项目级规则（仅适用于当前项目）
+> # 选项 B：项目级规则（仅应用于当前项目）
 > mkdir -p .claude/rules
 > cp -r everything-claude-code/rules/common/* .claude/rules/
-> cp -r everything-claude-code/rules/typescript/* .claude/rules/     # 选择您的技术栈
+> cp -r everything-claude-code/rules/typescript/* .claude/rules/     # 选择你的技术栈
 > ```

 ***
@@ -564,7 +633,136 @@ rules/
  golang/          # Go specific patterns and tools
 ```

-有关安装和结构详情，请参阅 [`rules/README.md`](rules/README.md)。
+有关安装和结构详情，请参阅 [`rules/README.md`](../../rules/README.md)。
+
+***
+
+## 🗺️ 我应该使用哪个代理？
+
+不确定从哪里开始？使用这个快速参考：
+
+| 我想要... | 使用此命令 | 使用的代理 |
+|--------------|-----------------|------------|
+| 规划新功能 | `/everything-claude-code:plan "Add auth"` | planner |
+| 设计系统架构 | `/everything-claude-code:plan` + architect agent | architect |
+| 先写带测试的代码 | `/tdd` | tdd-guide |
+| 审查我刚写的代码 | `/code-review` | code-reviewer |
+| 修复失败的构建 | `/build-fix` | build-error-resolver |
+| 运行端到端测试 | `/e2e` | e2e-runner |
+| 查找安全漏洞 | `/security-scan` | security-reviewer |
+| 移除死代码 | `/refactor-clean` | refactor-cleaner |
+| 更新文档 | `/update-docs` | doc-updater |
+| 审查 Go 代码 | `/go-review` | go-reviewer |
+| 审查 Python 代码 | `/python-review` | python-reviewer |
+| 审计数据库查询 | *(自动委派)* | database-reviewer |
+
+### 常见工作流
+
+**开始新功能：**
+
+```
+/everything-claude-code:plan "Add user authentication with OAuth"
+                                              → planner creates implementation blueprint
+/tdd                                          → tdd-guide enforces write-tests-first
+/code-review                                  → code-reviewer checks your work
+```
+
+**修复错误：**
+
+```
+/tdd                                          → tdd-guide: write a failing test that reproduces it
+                                              → implement the fix, verify test passes
+/code-review                                  → code-reviewer: catch regressions
+```
+
+**准备生产环境：**
+
+```
+/security-scan                                → security-reviewer: OWASP Top 10 audit
+/e2e                                          → e2e-runner: critical user flow tests
+/test-coverage                                → verify 80%+ coverage
+```
+
+***
+
+## ❓ 常见问题
+
+<details>
+<summary><b>How do I check which agents/commands are installed?</b></summary>
+
+```bash
+/plugin list everything-claude-code@everything-claude-code
+```
+
+这会显示插件中所有可用的代理、命令和技能。
+
+</details>
+
+<details>
+<summary><b>My hooks aren't working / I see "Duplicate hooks file" errors</b></summary>
+
+这是最常见的问题。**不要在 `.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)。
+
+</details>
+
+<details>
+<summary><b>My context window is shrinking / Claude is running out of context</b></summary>
+
+太多的 MCP 服务器会消耗你的上下文。每个 MCP 工具描述都会消耗你 200k 窗口的令牌，可能将其减少到约 70k。
+
+**修复：** 按项目禁用未使用的 MCP：
+
+```json
+// In your project's .claude/settings.json
+{
+  "disabledMcpServers": ["supabase", "railway", "vercel"]
+}
+```
+
+保持启用的 MCP 少于 10 个，活动工具少于 80 个。
+
+</details>
+
+<details>
+<summary><b>Can I use only some components (e.g., just agents)?</b></summary>
+
+是的。使用选项 2（手动安装）并仅复制你需要的部分：
+
+```bash
+# Just agents
+cp everything-claude-code/agents/*.md ~/.claude/agents/
+
+# Just rules
+cp -r everything-claude-code/rules/common/* ~/.claude/rules/
+```
+
+每个组件都是完全独立的。
+
+</details>
+
+<details>
+<summary><b>Does this work with Cursor / OpenCode / Codex?</b></summary>
+
+是的。ECC 是跨平台的：
+
+* **Cursor**：`.cursor/` 中的预翻译配置。参见 [Cursor IDE 支持](#cursor-ide-支持)。
+* **OpenCode**：`.opencode/` 中的完整插件支持。参见 [OpenCode 支持](#-opencode-支持)。
+* **Codex**：提供适配器漂移保护和 SessionStart 回退的一流支持。参见 PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257)。
+* **Claude Code**：原生支持 — 这是主要目标。
+
+</details>
+
+<details>
+<summary><b>How do I contribute a new skill or agent?</b></summary>
+
+参见 [CONTRIBUTING.md](CONTRIBUTING.md)。简短版本：
+
+1. Fork 仓库
+2. 在 `skills/your-skill-name/SKILL.md` 中创建你的技能（带有 YAML 前言）
+3. 或在 `agents/your-agent.md` 中创建代理
+4. 提交 PR，清晰描述其功能和使用时机
+
+</details>

 ***

@@ -609,31 +807,109 @@ node tests/hooks/hooks.test.js

 ## Cursor IDE 支持

-ecc-universal 包含为 [Cursor IDE](https://cursor.com) 预翻译的配置。`.cursor/` 目录包含适用于 Cursor 格式的规则、智能体、技能、命令和 MCP 配置。
+ECC 提供**完整的 Cursor IDE 支持**，包括为 Cursor 原生格式适配的钩子、规则、代理、技能、命令和 MCP 配置。

 ### 快速开始 (Cursor)

 ```bash
-# Install the package
-npm install ecc-universal
-
 # Install for your language(s)
 ./install.sh --target cursor typescript
-./install.sh --target cursor python golang
+./install.sh --target cursor python golang swift
 ```

-### 已翻译内容
+### 包含内容

-| 组件 | Claude Code → Cursor | 对等性 |
-|-----------|---------------------|--------|
-| 规则 | 添加了 YAML frontmatter，路径扁平化 | 完全 |
-| 智能体 | 模型 ID 已扩展，工具 → 只读标志 | 完全 |
-| 技能 | 无需更改 (标准相同) | 相同 |
-| 命令 | 路径引用已更新，多-\* 已存根 | 部分 |
-| MCP 配置 | 环境变量插值语法已更新 | 完全 |
-| 钩子 | Cursor 中无等效项 | 参见替代方案 |
+| 组件 | 数量 | 详情 |
+|-----------|-------|---------|
+| 钩子事件 | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt, 以及另外 10 个 |
+| 钩子脚本 | 16 | 通过共享适配器委托给 `scripts/hooks/` 的轻量 Node.js 脚本 |
+| 规则 | 29 | 9 条通用规则 (alwaysApply) + 20 条语言特定规则 (TypeScript, Python, Go, Swift) |
+| 代理 | 共享 | 通过根目录下的 AGENTS.md（被 Cursor 原生读取） |
+| 技能 | 共享 + 捆绑 | 通过根目录下的 AGENTS.md 和用于翻译补充的 `.cursor/skills/` |
+| 命令 | 共享 | `.cursor/commands/`（如果已安装） |
+| MCP 配置 | 共享 | `.cursor/mcp.json`（如果已安装） |

-详情请参阅 [.cursor/README.md](.cursor/README.md)，完整迁移指南请参阅 [.cursor/MIGRATION.md](.cursor/MIGRATION.md)。
+### 钩子架构（DRY 适配器模式）
+
+Cursor 的**钩子事件比 Claude Code 多**（20 对 8）。`.cursor/hooks/adapter.js` 模块将 Cursor 的 stdin JSON 转换为 Claude Code 的格式，允许重用现有的 `scripts/hooks/*.js` 而无需重复。
+
+```
+Cursor stdin JSON → adapter.js → transforms → scripts/hooks/*.js
+                                              (shared with Claude Code)
+```
+
+关键钩子：
+
+* **beforeShellExecution** — 阻止在 tmux 外启动开发服务器（退出码 2），git push 审查
+* **afterFileEdit** — 自动格式化 + TypeScript 检查 + console.log 警告
+* **beforeSubmitPrompt** — 检测提示中的密钥（sk-、ghp\_、AKIA 模式）
+* **beforeTabFileRead** — 阻止 Tab 读取 .env、.key、.pem 文件（退出码 2）
+* **beforeMCPExecution / afterMCPExecution** — MCP 审计日志记录
+
+### 规则格式
+
+Cursor 规则使用带有 `description`、`globs` 和 `alwaysApply` 的 YAML 前言：
+
+```yaml
+---
+description: "TypeScript coding style extending common rules"
+globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
+alwaysApply: false
+---
+```
+
+***
+
+## Codex CLI 支持
+
+ECC 提供**一流的 Codex CLI 支持**，包含参考配置、Codex 特定的 AGENTS.md 补充和 16 个移植的技能。
+
+### 快速开始（Codex）
+
+```bash
+# Copy the reference config to your home directory
+cp .codex/config.toml ~/.codex/config.toml
+
+# Run Codex in the repo — AGENTS.md is auto-detected
+codex
+```
+
+### 包含内容
+
+| 组件 | 数量 | 详情 |
+|-----------|-------|---------|
+| 配置 | 1 | `.codex/config.toml` — 模型、权限、MCP 服务器、持久指令 |
+| AGENTS.md | 2 | 根目录（通用）+ `.codex/AGENTS.md`（Codex 特定补充） |
+| 技能 | 16 | `.agents/skills/` — 每个技能包含 SKILL.md + agents/openai.yaml |
+| MCP 服务器 | 4 | GitHub、Context7、Memory、Sequential Thinking（基于命令） |
+| 配置文件 | 2 | `strict`（只读沙箱）和 `yolo`（完全自动批准） |
+
+### 技能
+
+位于 `.agents/skills/` 的技能会被 Codex 自动加载：
+
+| 技能 | 描述 |
+|-------|-------------|
+| tdd-workflow | 测试驱动开发，覆盖率 80%+ |
+| security-review | 全面的安全检查清单 |
+| coding-standards | 通用编码标准 |
+| frontend-patterns | React/Next.js 模式 |
+| frontend-slides | HTML 演示文稿、PPTX 转换、视觉风格探索 |
+| article-writing | 根据笔记和语音参考进行长文写作 |
+| content-engine | 平台原生的社交内容和再利用 |
+| market-research | 带来源归属的市场和竞争对手研究 |
+| investor-materials | 幻灯片、备忘录、模型和一页纸文档 |
+| investor-outreach | 个性化外联、跟进和介绍摘要 |
+| backend-patterns | API 设计、数据库、缓存 |
+| e2e-testing | Playwright 端到端测试 |
+| eval-harness | 评估驱动的开发 |
+| strategic-compact | 上下文管理 |
+| api-design | REST API 设计模式 |
+| verification-loop | 构建、测试、代码检查、类型检查、安全 |
+
+### 关键限制
+
+Codex CLI **尚不支持钩子**（[GitHub Issue #2109](https://github.com/openai/codex/issues/2109)，430+ 点赞）。安全强制执行是通过 `persistent_instructions` 中的指令和沙箱权限系统实现的。

 ***

@@ -655,15 +931,15 @@ opencode

 ### 功能对等

-| 特性 | Claude Code | OpenCode | 状态 |
+| 功能 | Claude Code | OpenCode | 状态 |
 |---------|-------------|----------|--------|
-| 智能体 | ✅ 14 agents | ✅ 12 agents | **Claude Code 领先** |
-| 命令 | ✅ 30 commands | ✅ 24 commands | **Claude Code 领先** |
-| 技能 | ✅ 28 skills | ✅ 16 skills | **Claude Code 领先** |
-| 钩子 | ✅ 3 phases | ✅ 20+ events | **OpenCode 更多！** |
-| 规则 | ✅ 8 rules | ✅ 8 rules | **完全一致** |
-| MCP Servers | ✅ Full | ✅ Full | **完全一致** |
-| 自定义工具 | ✅ Via hooks | ✅ Native support | **OpenCode 更好** |
+| 代理 | ✅ 13 个代理 | ✅ 12 个代理 | **Claude Code 领先** |
+| 命令 | ✅ 33 个命令 | ✅ 24 个命令 | **Claude Code 领先** |
+| 技能 | ✅ 50+ 个技能 | ✅ 37 个技能 | **Claude Code 领先** |
+| 钩子 | ✅ 8 种事件类型 | ✅ 11 种事件 | **OpenCode 更多！** |
+| 规则 | ✅ 29 条规则 | ✅ 13 条指令 | **Claude Code 领先** |
+| MCP 服务器 | ✅ 14 个服务器 | ✅ 完整支持 | **完全对等** |
+| 自定义工具 | ✅ 通过钩子 | ✅ 6 个原生工具 | **OpenCode 更好** |

 ### 通过插件实现的钩子支持

@@ -679,14 +955,13 @@ OpenCode 的插件系统比 Claude Code 更复杂，有 20 多种事件类型：

 **额外的 OpenCode 事件**：`file.edited`、`file.watcher.updated`、`message.updated`、`lsp.client.diagnostics`、`tui.toast.show` 等等。

-### 可用命令 (24)
+### 可用命令（32个）

 | 命令 | 描述 |
 |---------|-------------|
 | `/plan` | 创建实施计划 |
 | `/tdd` | 强制执行 TDD 工作流 |
 | `/code-review` | 审查代码变更 |
-| `/security` | 运行安全审查 |
 | `/build-fix` | 修复构建错误 |
 | `/e2e` | 生成端到端测试 |
 | `/refactor-clean` | 移除死代码 |
@@ -701,11 +976,20 @@ OpenCode 的插件系统比 Claude Code 更复杂，有 20 多种事件类型：
 | `/go-review` | Go 代码审查 |
 | `/go-test` | Go TDD 工作流 |
 | `/go-build` | 修复 Go 构建错误 |
+| `/python-review` | Python 代码审查（PEP 8、类型提示、安全） |
+| `/multi-plan` | 多模型协作规划 |
+| `/multi-execute` | 多模型协作执行 |
+| `/multi-backend` | 后端聚焦的多模型工作流 |
+| `/multi-frontend` | 前端聚焦的多模型工作流 |
+| `/multi-workflow` | 完整的多模型开发工作流 |
+| `/pm2` | 自动生成 PM2 服务命令 |
+| `/sessions` | 管理会话历史 |
 | `/skill-create` | 从 git 生成技能 |
-| `/instinct-status` | 查看习得的本能 |
+| `/instinct-status` | 查看已学习的本能 |
 | `/instinct-import` | 导入本能 |
 | `/instinct-export` | 导出本能 |
 | `/evolve` | 将本能聚类为技能 |
+| `/learn-eval` | 在保存前提取和评估模式 |
 | `/setup-pm` | 配置包管理器 |

 ### 插件安装
@@ -740,6 +1024,35 @@ npm install ecc-universal

 ***

+## 跨工具功能对等
+
+ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以下是每个平台的比较：
+
+| 功能 | Claude Code | Cursor IDE | Codex CLI | OpenCode |
+|---------|------------|------------|-----------|----------|
+| **代理** | 13 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |
+| **命令** | 33 | 共享 | 基于指令 | 24 |
+| **技能** | 50+ | 共享 | 10 (原生格式) | 37 |
+| **钩子事件** | 8 种类型 | 15 种类型 | 尚无 | 11 种类型 |
+| **钩子脚本** | 9 个脚本 | 16 个脚本 (DRY 适配器) | 不适用 | 插件钩子 |
+| **规则** | 29 (通用 + 语言) | 29 (YAML 前言) | 基于指令 | 13 条指令 |
+| **自定义工具** | 通过钩子 | 通过钩子 | 不适用 | 6 个原生工具 |
+| **MCP 服务器** | 14 | 共享 (mcp.json) | 4 (基于命令) | 完整 |
+| **配置格式** | settings.json | hooks.json + rules/ | config.toml | opencode.json |
+| **上下文文件** | CLAUDE.md + AGENTS.md | AGENTS.md | AGENTS.md | AGENTS.md |
+| **密钥检测** | 基于钩子 | beforeSubmitPrompt 钩子 | 基于沙箱 | 基于钩子 |
+| **自动格式化** | PostToolUse 钩子 | afterFileEdit 钩子 | 不适用 | file.edited 钩子 |
+| **版本** | 插件 | 插件 | 参考配置 | 1.6.0 |
+
+**关键架构决策：**
+
+* 根目录下的 **AGENTS.md** 是通用的跨工具文件（被所有 4 个工具读取）
+* **DRY 适配器模式** 让 Cursor 可以重用 Claude Code 的钩子脚本而无需重复
+* **技能格式**（带有 YAML 前言的 SKILL.md）在 Claude Code、Codex 和 OpenCode 上都能工作
+* Codex 缺乏钩子的问题通过 `persistent_instructions` 和沙箱权限来弥补
+
+***
+
 ## 📖 背景

 我从实验性推出以来就一直在使用 Claude Code。在 2025 年 9 月，与 [@DRodriguezFX](https://x.com/DRodriguezFX) 一起使用 Claude Code 构建 [zenith.chat](https://zenith.chat)，赢得了 Anthropic x Forum Ventures 黑客马拉松。
@@ -748,19 +1061,96 @@ npm install ecc-universal

 ***

-## ⚠️ 重要说明
+## 令牌优化
+
+如果不管理令牌消耗，使用 Claude Code 可能会很昂贵。这些设置能在不牺牲质量的情况下显著降低成本。
+
+### 推荐设置
+
+添加到 `~/.claude/settings.json`：
+
+```json
+{
+  "model": "sonnet",
+  "env": {
+    "MAX_THINKING_TOKENS": "10000",
+    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
+  }
+}
+```
+
+| 设置 | 默认值 | 推荐值 | 影响 |
+|---------|---------|-------------|--------|
+| `model` | opus | **sonnet** | 约 60% 的成本降低；处理 80%+ 的编码任务 |
+| `MAX_THINKING_TOKENS` | 31,999 | **10,000** | 每个请求的隐藏思考成本降低约 70% |
+| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 95 | **50** | 更早压缩 —— 在长会话中质量更好 |
+
+仅在需要深度架构推理时切换到 Opus：
+
+```
+/model opus
+```
+
+### 日常工作流命令
+
+| 命令 | 何时使用 |
+|---------|-------------|
+| `/model sonnet` | 大多数任务的默认选择 |
+| `/model opus` | 复杂架构、调试、深度推理 |
+| `/clear` | 在不相关的任务之间（免费，即时重置） |
+| `/compact` | 在逻辑任务断点处（研究完成，里程碑达成） |
+| `/cost` | 在会话期间监控令牌花费 |
+
+### 策略性压缩
+
+`strategic-compact` 技能（包含在此插件中）建议在逻辑断点处进行 `/compact`，而不是依赖在 95% 上下文时的自动压缩。完整决策指南请参见 `skills/strategic-compact/SKILL.md`。
+
+**何时压缩：**
+
+* 研究/探索之后，实施之前
+* 完成一个里程碑之后，开始下一个之前
+* 调试之后，继续功能工作之前
+* 失败的方法之后，尝试新方法之前
+
+**何时不压缩：**
+
+* 实施过程中（你会丢失变量名、文件路径、部分状态）

 ### 上下文窗口管理

-**关键：** 不要一次性启用所有 MCP。启用过多工具后，你的 200k 上下文窗口可能会缩小到 70k。
+**关键：** 不要一次性启用所有 MCP。每个 MCP 工具描述都会消耗你 200k 窗口的令牌，可能将其减少到约 70k。

-经验法则：
+* 每个项目保持启用的 MCP 少于 10 个
+* 保持活动工具少于 80 个
+* 在项目配置中使用 `disabledMcpServers` 来禁用未使用的 MCP

-* 配置 20-30 个 MCP
-* 每个项目保持启用少于 10 个
-* 活动工具少于 80 个
+### 代理团队成本警告

-在项目配置中使用 `disabledMcpServers` 来禁用未使用的工具。
+代理团队会生成多个上下文窗口。每个团队成员独立消耗令牌。仅用于并行性能提供明显价值的任务（多模块工作、并行审查）。对于简单的顺序任务，子代理更节省令牌。
+
+***
+
+## ⚠️ 重要说明
+
+### 令牌优化
+
+达到每日限制？参见 **[令牌优化指南](../token-optimization.md)** 获取推荐设置和工作流提示。
+
+快速见效的方法：
+
+```json
+// ~/.claude/settings.json
+{
+  "model": "sonnet",
+  "env": {
+    "MAX_THINKING_TOKENS": "10000",
+    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
+    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
+  }
+}
+```
+
+在不相关的任务之间使用 `/clear`，在逻辑断点处使用 `/compact`，并使用 `/cost` 来监控花费。

 ### 定制化

@@ -773,6 +1163,14 @@ npm install ecc-universal

 ***

+## 💜 赞助商
+
+这个项目是免费和开源的。赞助商帮助保持其维护和发展。
+
+[**成为赞助商**](https://github.com/sponsors/affaan-m) | [赞助商等级](SPONSORS.md)
+
+***
+
 ## 🌟 Star 历史

 [![Star History Chart](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code\&type=Date)](https://star-history.com/#affaan-m/everything-claude-code\&Date)
@@ -781,11 +1179,11 @@ npm install ecc-universal

 ## 🔗 链接

-* **速查指南 (从此开始):** [Claude Code 万事速查指南](https://x.com/affaanmustafa/status/2012378465664745795)
-* **详细指南 (进阶):** [Claude Code 万事详细指南](https://x.com/affaanmustafa/status/2014040193557471352)
-* **关注:** [@affaanmustafa](https://x.com/affaanmustafa)
-* **zenith.chat:** [zenith.chat](https://zenith.chat)
-* **技能目录:** awesome-agent-skills（社区维护的智能体技能目录）
+* **速查指南（从这里开始）：** [Claude Code 速查指南](https://x.com/affaanmustafa/status/2012378465664745795)
+* **详细指南（进阶）：** [Claude Code 详细指南](https://x.com/affaanmustafa/status/2014040193557471352)
+* **关注：** [@affaanmustafa](https://x.com/affaanmustafa)
+* **zenith.chat：** [zenith.chat](https://zenith.chat)
+* **技能目录：** awesome-agent-skills（社区维护的智能体技能目录）

 ***