全文总结封面图

这个项目是什么

everything-claude-code 是一个面向 Claude Code（Anthropic 官方 CLI 编程助手） 的“全家桶”配置仓库/插件：把常用的 agents（子代理）、skills（工作流技能）、slash commands（斜杠命令）、rules（规则约束）、hooks（事件钩子自动化）、以及 MCP server 配置示例集中在一起，提供一套可直接复用的工程化工作流。

它更像是一个“可安装的 Claude Code 插件 + 参考实现集合”，目标是让 Claude Code 在真实项目里更像一个具备流程纪律的工程助手，而不是只会临时回答问题的聊天机器人。

核心作用/解决什么问题

1.把高频工程能力产品化：将规划、架构评审、代码评审、安全审查、E2E、TDD 等能力沉淀为可调用的 agents/skills/commands。

2.把“怎么用 Claude Code”固化为流程：通过 rules + commands + hooks，将“先计划/先测试/再实现/再验证”的做事方式变成工具行为，而不是依赖使用者记忆。

3.减少跨项目迁移成本：提供一套通用的目录结构与可拷贝配置（手动安装）或插件安装方式（推荐）。

4.统一工具链与脚本习惯：内置包管理器选择/配置逻辑（npm/pnpm/yarn/bun 自动探测），以及测试运行脚本与示例。

主要组成（仓库结构概览 + 参考清单）

.claude-plugin/（插件包装）

• plugin.json：Claude Code 插件元数据（入口、包含哪些资源等）。

• marketplace.json：marketplace 相关信息。

agents/（子代理：把任务委派给专职角色）

skills/（技能：把方法论沉淀成可复用流程）

commands/（斜杠命令：一键触发预设工作流）

rules/（规则：常驻约束，限制助手行为）

hooks/ + scripts/hooks/（钩子：在关键事件点自动化）

• hooks/hooks.json：Claude Code hooks 总配置（如 PreToolUse / PostToolUse / Stop 等事件）。

• hooks/memory-persistence/：会话“记忆持久化”相关 hook（偏方法论与自动化）。

• hooks/strategic-compact/：上下文压缩建议相关 hook。

• scripts/hooks/*.js（Node 实现，跨平台）：
  • session-start.js：会话开始加载上下文/状态。

  • session-end.js：会话结束保存状态。

  • pre-compact.js：压缩前保存状态/准备。

  • suggest-compact.js：输出“战略性压缩”建议。

  • evaluate-session.js：会话评估/提炼模式。

其他支撑目录

• scripts/lib/：工具函数与包管理器探测逻辑（如 package-manager.js）。

• mcp-configs/mcp-servers.json：MCP server 配置模板集合（把外部服务接进 Claude Code）。

• tests/：测试用例与 tests/run-all.js。

• contexts/：场景化上下文注入（dev.md/review.md/research.md）。

• examples/：示例 CLAUDE.md 等。

它是如何工作的（概念协作）

• commands（斜杠命令）：把一次“工作流动作”封装成可触发的命令（例如 plan/tdd/review）。

• skills（技能）：承载“怎么做”的方法论与检查清单，可被命令或 agent 调用。

• agents（子代理）：把复杂任务拆分给专用角色（规划/评审/测试/安全等），提高产出质量与一致性。

• rules（规则）：限制/规范助手行为，避免跑偏（例如禁止某些危险操作、要求先读代码再改等）。

• hooks（钩子）：在 Claude Code 的事件点自动执行脚本，进一步把流程自动化（比如在工具调用前后记录信息、提醒上下文窗口管理等）。

安装/使用方式（README 提供的两种路线）

1) 推荐：作为 Claude Code 插件安装

• /plugin marketplace add affaan-m/everything-claude-code

• /plugin install everything-claude-code@everything-claude-code

也可以在 ~/.claude/settings.json 里配置额外 marketplace 并启用插件（README 有 JSON 示例）。

2) 手动安装（按需拷贝）

• 将 agents/ rules/ commands/ skills/ 拷贝到 ~/.claude/ 对应目录

• 将 hooks/hooks.json 合并进 ~/.claude/settings.json

• 将 mcp-configs/mcp-servers.json 中需要的 MCP server 配置拷贝到 ~/.claude.json（并替换密钥占位符）

额外：包管理器自动探测/设置

仓库内置包管理器选择逻辑，支持：

• 环境变量 CLAUDE_PACKAGE_MANAGER

• node scripts/setup-package-manager.js --global|--project|--detect

• Claude Code 命令 /setup-pm

Claude Code 概念速查：触发场景 + 怎么用

Claude Code 组件机制总览

Claude Code Hooks 触发生命周期

Skills：触发、配置与运行

everything-claude-code：目录结构与映射

Claude Code：组件选型决策树

这一节补充 Claude Code 里几个核心概念（skills / subagents / hooks / rules / commands）在什么场景会被触发、以及你该怎么用。这能帮助你把 everything-claude-code 这类“组件仓库”对齐到 Claude Code 的官方机制。

1) Skills（技能 / 自定义 slash command）

它是什么

• 一个目录 .../skills/<skill-name>/SKILL.md（必须）+ 可选的 supporting files。

• SKILL.md 顶部 YAML frontmatter 里的 name 决定了命令名 /skill-name；description 用于让 Claude 判断何时自动加载。

• Claude Code 文档说明：Custom slash commands 已合并进 skills，所以 .claude/commands/review.md 与 .claude/skills/review/SKILL.md 都可以提供 /review，但 skill 优先。

什么时候触发

• 手动触发：你在对话里输入 /skill-name ...args。

• 模型自动触发：当 skill 的 description 与用户问题/上下文匹配，且没有设置 disable-model-invocation: true 时。

怎么用（实操要点）

• 通过 frontmatter 控制“谁能触发”：
  • disable-model-invocation: true：只允许你手动 /name 触发（适合有副作用的流程，如 deploy/commit）。

  • user-invocable: false：从 / 菜单隐藏；通常用于“背景知识型 skill”。
• 通过 allowed-tools 限制 skill 执行期的工具权限（例如只读）。

• 通过 $ARGUMENTS 接收 /skill-name 后的参数。

• 支持 context: fork + agent: Explore/Plan/... 让 skill 在隔离子代理里跑（适合大吞吐研究）。

典型选择指南

• 你要“可复用的一段流程/提示词（可能带参数）”→ 用 Skill。

• 你要“这次任务专门找文件/总结，不想污染主上下文”→ 用 context: fork 的 Skill 或直接用 Subagent。

2) Subagents（子代理 / Task tool）

它是什么

• 专用 AI 助手，独立上下文窗口 + 自己的系统提示词 + 可配置工具权限/模型。

• 既有内置（Explore/Plan/general-purpose 等），也可在 .claude/agents/、~/.claude/agents/ 或插件里定义自定义 subagent。

什么时候触发

• Claude 会依据 subagent 的 description 自动委派（delegation）。

• 你也可以显式要求：例如“用 code-reviewer subagent 看一下最近改动”。

怎么用（实操要点）

• 内置 subagents（官方定义）：
  • Explore：快速、只读，擅长 Glob/Grep/Read 做代码库探索（文档：read-only tools，拒绝 Write/Edit）。

  • Plan：计划模式下做研究（只读），用于产出计划前的代码检索。

  • general-purpose：需要读写改动 + 多步操作时。

• Subagent frontmatter（自定义 agent）里可配置：
  • tools / disallowedTools：白名单/黑名单工具。

  • permissionMode：default / acceptEdits / dontAsk / bypassPermissions / plan。

  • skills：把某些 skills 全文预加载进 subagent 上下文（注意：subagents 不继承主对话 skills，需要显式列）。

• 子代理适合隔离“高输出任务”（跑测试、拉大量 diff、分析日志等），只把摘要回传主对话。

3) Hooks（事件钩子：自动化）

它是什么

• 在 Claude Code session 生命周期的特定事件点自动执行：
  • type: command（执行 shell 命令脚本）

  • type: prompt（LLM 评估，输出 JSON 决定 allow/block 等）

• 可配置位置：用户级 ~/.claude/settings.json、项目级 .claude/settings.json、插件 hooks 等。

什么时候触发（官方生命周期）

怎么用（实操要点）

• matcher 用来匹配工具名（如 Write|Edit）或用正则匹配 MCP tool（如 mcp__memory__.*）。

• SessionStart、UserPromptSubmit 等可以向对话注入额外上下文（stdout/additionalContext）。

• PreToolUse 可以通过 JSON 输出做 permissionDecision: allow/deny/ask，实现“自动放行/拦截/要求确认”。

• 强提醒：hooks 能执行任意命令，有安全风险；要严格审计。

4) Rules（规则约束）

它是什么

• 一组“长期有效的行为约束/偏好”，通常作为系统提示词的一部分存在（在 everything-claude-code 里是 rules/*.md）。

什么时候生效

• 只要规则文件被加载进当前会话/插件配置的有效范围，就会持续影响 Claude 的行为（不像 skill 需要触发）。

怎么用（实操要点）

• 把规则分成：安全底线、代码风格、测试纪律、git 流程、代理使用策略、性能/上下文管理。

• 规则适合写“永远要这样做”的东西；一次性流程用 skill。

5) Commands（斜杠命令）

它是什么

• 从官方机制看，自定义 commands 已并入 skills：一个 skill 自然就是一个 /command。

• 仍兼容旧的 .claude/commands/*.md，但推荐迁移成 skills（支持 supporting files / invocation control / fork subagent 等）。

什么时候触发

• 你输入 /xxx（或 Claude 在某些实现里会主动建议你用某个 /xxx 工作流）。

总结（一句话）

everything-claude-code 提供了一套可安装、可迁移、可组合的 Claude Code 工程化工作流组件库：用 agents/skills/commands/rules/hooks 把“规划→实现→评审→测试→验证”的软件工程节奏固化到工具里。