everything-claude-code-zh/docs/zh-TW

Everything Claude Code

来自 Anthropic 黑客松冠军的完整 Claude Code 配置集。

经过 10 个月以上密集日常使用、打造真实产品所淬炼出的生产就绪智能体（Agents）、技能（Skills）、钩子（Hooks）、指令（Commands）、规则（Rules）和 MCP 配置。

---

指南

本仓库仅包含原始代码。指南会解释所有内容。

简明指南 配置、基础、理念。请先阅读此指南。	完整指南 Token 优化、记忆持久化、评估、并行处理。

主题	学习内容
Token 优化	模型选择、系统提示精简、后台进程
记忆持久化	自动跨会话（Session）保存/加载上下文的钩子（Hooks）
持续学习	从会话中自动提取模式并转化为可重用技能（Skills）
验证循环	检查点 vs 持续评估、评分器类型、pass@k 指标
并行处理	Git worktrees、串联方法、何时扩展实例
子智能体协调	上下文问题、渐进式检索模式

---

跨平台支持

此插件现已完整支持 Windows、macOS 和 Linux。所有钩子和脚本已使用 Node.js 重写以获得最佳兼容性。

包管理器检测

插件会自动检测您偏好的包管理器（npm、pnpm、yarn 或 bun），优先级如下：

1. 环境变量：CLAUDE_PACKAGE_MANAGER
2. 项目配置：.claude/package-manager.json
3. package.json：packageManager 字段
4. 锁文件：从 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 检测
5. 全局配置：~/.claude/package-manager.json
6. 备选方案：第一个可用的包管理器

设置您偏好的包管理器：

# 通过环境变量
export CLAUDE_PACKAGE_MANAGER=pnpm

# 通过全局配置
node scripts/setup-package-manager.js --global pnpm

# 通过项目配置
node scripts/setup-package-manager.js --project bun

# 检测当前配置
node scripts/setup-package-manager.js --detect

或在 Claude Code 中使用 /setup-pm 指令。

---

内容概览

本仓库是一个 Claude Code 插件 - 可直接安装或手动复制组件。

everything-claude-code/
|-- .claude-plugin/   # 插件和市场清单
|   |-- plugin.json         # 插件元数据和组件路径
|   |-- marketplace.json    # 用于 /plugin marketplace add 的市场目录
|
|-- agents/           # 用于委派任务的专门子智能体（Agents）
|   |-- planner.md           # 功能实现规划
|   |-- architect.md         # 系统设计决策
|   |-- tdd-guide.md         # 测试驱动开发
|   |-- code-reviewer.md     # 质量与安全审查
|   |-- security-reviewer.md # 漏洞分析
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # Playwright E2E 测试
|   |-- refactor-cleaner.md  # 无用代码清理
|   |-- doc-updater.md       # 文档同步
|   |-- go-reviewer.md       # Go 代码审查（新增）
|   |-- go-build-resolver.md # Go 构建错误解决（新增）
|
|-- skills/           # 工作流（Workflow）定义和领域知识
|   |-- coding-standards/           # 编程语言最佳实践
|   |-- backend-patterns/           # API、数据库、缓存模式
|   |-- frontend-patterns/          # React、Next.js 模式
|   |-- continuous-learning/        # 从会话中自动提取模式（完整指南）
|   |-- continuous-learning-v2/     # 基于本能的学习与信心评分
|   |-- iterative-retrieval/        # 子代理的渐进式上下文精炼
|   |-- strategic-compact/          # 手动压缩建议（完整指南）
|   |-- tdd-workflow/               # TDD 方法论
|   |-- security-review/            # 安全性检查清单
|   |-- eval-harness/               # 验证循环评估（完整指南）
|   |-- verification-loop/          # 持续验证（完整指南）
|   |-- golang-patterns/            # Go 惯用法和最佳实践（新增）
|   |-- golang-testing/             # Go 测试模式、TDD、基准测试（新增）
|
|-- commands/         # 快速执行的斜杠指令（Commands）
|   |-- tdd.md              # /tdd - 测试驱动开发
|   |-- plan.md             # /plan - 实现规划
|   |-- e2e.md              # /e2e - 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 - 执行验证循环（完整指南）
|   |-- setup-pm.md         # /setup-pm - 设置包管理器
|   |-- go-review.md        # /go-review - Go 代码审查（新增）
|   |-- go-test.md          # /go-test - Go TDD 工作流（新增）
|   |-- go-build.md         # /go-build - 修复 Go 构建错误（新增）
|
|-- rules/            # 必须遵守的准则（Rules）（复制到 ~/.claude/rules/）
|   |-- security.md         # 强制性安全检查
|   |-- coding-style.md     # 不变性、文件组织
|   |-- testing.md          # TDD、80% 覆盖率要求
|   |-- git-workflow.md     # 提交格式、PR 流程
|   |-- agents.md           # 何时委派给子智能体
|   |-- performance.md      # 模型选择、上下文管理
|
|-- hooks/            # 基于触发器的自动化钩子（Hooks）
|   |-- hooks.json                # 所有钩子配置（PreToolUse、PostToolUse、Stop 等）
|   |-- memory-persistence/       # 会话生命周期钩子（完整指南）
|   |-- strategic-compact/        # 压缩建议（完整指南）
|
|-- scripts/          # 跨平台 Node.js 脚本（新增）
|   |-- lib/                     # 共享工具
|   |   |-- utils.js             # 跨平台文件/路径/系统工具
|   |   |-- package-manager.js   # 包管理器检测与选择
|   |-- hooks/                   # 钩子实现
|   |   |-- session-start.js     # 会话开始时加载上下文
|   |   |-- session-end.js       # 会话结束时保存状态
|   |   |-- pre-compact.js       # 压缩前状态保存
|   |   |-- suggest-compact.js   # 策略性压缩建议
|   |   |-- evaluate-session.js  # 从会话中提取模式
|   |-- setup-package-manager.js # 交互式包管理器设置
|
|-- tests/            # 测试套件（新增）
|   |-- lib/                     # 库测试
|   |-- hooks/                   # 钩子测试
|   |-- run-all.js               # 执行所有测试
|
|-- contexts/         # 动态系统提示词（Prompt）注入上下文（完整指南）
|   |-- dev.md              # 开发模式上下文
|   |-- review.md           # 代码审查模式上下文
|   |-- research.md         # 研究/探索模式上下文
|
|-- examples/         # 示例配置和会话
|   |-- CLAUDE.md           # 项目级配置示例
|   |-- user-CLAUDE.md      # 用户级配置示例
|
|-- mcp-configs/      # MCP 服务器配置
|   |-- mcp-servers.json    # GitHub、Supabase、Vercel、Railway 等
|
|-- marketplace.json  # 自托管市场配置（用于 /plugin marketplace add）

---

生态系统工具

ecc.tools - 技能生成器

从您的仓库自动生成 Claude Code 技能（Skills）。

安装 GitHub App | ecc.tools

分析您的仓库并创建：

• SKILL.md 文件 - 可直接用于 Claude Code 的技能
• 本能集合 - 用于 continuous-learning-v2
• 模式提取 - 从您的提交历史学习

# 安装 GitHub App 后，技能会出现在：
~/.claude/skills/generated/

与 continuous-learning-v2 技能无缝整合以继承本能。

---

安装

选项 1：以插件（Plugin）安装（推荐）

使用本仓库最简单的方式 - 安装为 Claude Code 插件：

# 将此仓库添加为市场
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/plugin install everything-claude-code@everything-claude-code

或直接添加到您的 ~/.claude/settings.json：

{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

这会让您立即访问所有指令、智能体、技能和钩子。

---

选项 2：手动安装

如果您偏好手动控制安装内容：

# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git

# 将智能体复制到您的 Claude 配置
cp everything-claude-code/agents/*.md ~/.claude/agents/

# 复制规则
cp everything-claude-code/rules/*.md ~/.claude/rules/

# 复制指令
cp everything-claude-code/commands/*.md ~/.claude/commands/

# 复制技能
cp -r everything-claude-code/skills/* ~/.claude/skills/

将钩子添加到 settings.json

将 hooks/hooks.json 中的钩子复制到您的 ~/.claude/settings.json。

配置 MCP

将 mcp-configs/mcp-servers.json 中所需的 MCP 服务器配置复制到您的 ~/.claude.json。

重要： 将 YOUR_*_HERE 占位符替换为您实际的 API 密钥。

---

核心概念

智能体（Agents）

子智能体以有限范围处理委派的任务。示例：

---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---

You are a senior code reviewer...

技能（Skills）

技能是由指令或智能体调用的工作流定义：

# TDD Workflow

1. Define interfaces first
2. Write failing tests (RED)
3. Implement minimal code (GREEN)
4. Refactor (IMPROVE)
5. Verify 80%+ coverage

钩子（Hooks）

钩子在工具（Tool）事件时触发。示例 - 警告 console.log：

{
  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
  "hooks": [{
    "type": "command",
    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
  }]
}

规则（Rules）

规则是必须遵守的准则。保持模块化：

~/.claude/rules/
  security.md      # 禁止硬编码密钥
  coding-style.md  # 不变性、文件组织
  testing.md       # TDD、80% 覆盖率要求

---

执行测试

插件包含完整的测试套件：

# 执行所有测试
node tests/run-all.js

# 执行个别测试文件
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

---

贡献

欢迎并鼓励贡献。

本仓库旨在成为社区资源。如果您有：

• 实用的智能体或技能
• 巧妙的钩子
• 更好的 MCP 配置
• 改进的规则

请贡献！详见 CONTRIBUTING.md 的指南。

贡献想法

• 特定语言的技能（Python、Rust 模式）- Go 现已包含！
• 特定框架的配置（Django、Rails、Laravel）
• DevOps 智能体（Kubernetes、Terraform、AWS）
• 测试策略（不同框架）
• 特定领域知识（ML、数据工程、移动开发）

---

背景

我从实验性推出就开始使用 Claude Code。2025 年 9 月与 @DRodriguezFX 一起使用 Claude Code 打造 zenith.chat，赢得了 Anthropic x Forum Ventures 黑客松。

这些配置已在多个生产应用程序中经过实战测试。

---

重要注意事项

上下文窗口管理

关键： 不要同时启用所有 MCP。启用过多工具会让您的 200k 上下文窗口缩减至 70k。

经验法则：

• 设置 20-30 个 MCP
• 每个项目启用少于 10 个
• 启用的工具少于 80 个

在项目配置中使用 disabledMcpServers 来禁用未使用的 MCP。

自定义

这些配置适合我的工作流。您应该：

1. 从您认同的部分开始
2. 根据您的技术栈修改
3. 移除不需要的部分
4. 添加您自己的模式

---

Star 历史

---

链接

• 简明指南（从这里开始）： Everything Claude Code 简明指南
• 完整指南（进阶）： Everything Claude Code 完整指南
• 关注： @affaanmustafa
• zenith.chat： zenith.chat

---

授权

MIT - 自由使用、依需求修改、如可能请回馈贡献。

---

如果有帮助请为本仓库点赞（Star）。阅读两份指南。打造伟大的作品。