Claude Code 高阶工作流：记忆、Skills、子代理、MCP、Hooks 与 CI/CD

Claude Code 每次工作阶段都是全新上下文窗口，跨工作阶段知识靠两种机制：CLAUDE.md（你写的指令）与 auto memory（Claude 自记的笔记）。项目级指令放 ./CLAUDE.md 或 ./.claude/CLAUDE.md，随版本控制与团队共享；个人偏好放 ~/.claude/CLAUDE.md（跨所有项目）；不想入库的个人项目偏好放 ./CLAUDE.local.md 并加入 .gitignore。工作阶段启动时从工作目录向上逐级加载并合并进 context。建议每份控制在 200 行内，用「Use 2-space indentation」「Run npm test before committing」这类可验证的具体表述。用 /init 自动产生初始 CLAUDE.md，/context 确认已加载（Memory files 列表），/memory 打开编辑。注意：CLAUDE.md 是上下文而不是强制设置，硬性拦截需用 PreToolUse hook。

大项目用 .claude/rules/ 目录按主题拆分指令（如 testing.md、api-design.md、security.md），所有 .md 递归发现，可用子目录分 frontend/backend。带 paths frontmatter 的规则只在 Claude 读取相符文件时才加载，节省 context：

glob 支持 **/*.ts、src/**/*、*.md、src/components/*.tsx 及 {ts,tsx} 花括号展开。CLAUDE.md 用 @path 导入其它文件：@README、@package.json、@docs/git-instructions.md，相对导入深度最多 4 层，导入内容同样在启动时进 context（反引号包住 @README 则不导入）。兼容其它代理的 AGENTS.md：在 CLAUDE.md 首行写 @AGENTS.md，或 ln -s AGENTS.md CLAUDE.md。忽略 monorepo 里他人 CLAUDE.md 用 claudeMdExcludes。

auto memory 默认开启，Claude 在工作过程中自动记录构建指令、调试经验、代码风格偏好等，保存到 ~/.claude/projects/<project>/memory/ 目录，其中 MEMORY.md 是索引，每工作阶段加载前 200 行或前 25KB，细节放独立主题文件（如 debugging.md）。同一 git 仓库的所有 worktree 共用一个记忆目录，且只存本机。开启时你会看到「Saved 2 memories / Recalled 2 memories」提示。关闭方式三选一：/memory 面板切换、settings.json 写 {"autoMemoryEnabled": false}、或环境变量 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1。保存位置可用 autoMemoryDirectory 自定义。subagent 也可用 frontmatter 的 memory 字段维护自己的记忆目录。

Skill 是含必需 SKILL.md 的目录（YAML frontmatter + 指令正文），目录名即指令，可直接 /skill-name 调用。自定义 slash command 已并入 skills：.claude/commands/deploy.md 与 .claude/skills/deploy/SKILL.md 都会产生 /deploy 且行为一致，旧指令文件仍可用。位置：个人 ~/.claude/skills/<name>/SKILL.md（跨项目）、项目 .claude/skills/（入库共享）。最小示例：

frontmatter 字段：name、description、disable-model-invocation（仅手动触发，适合 /deploy）、user-invocable、allowed-tools、model、context。与 CLAUDE.md 不同，skill 正文只在被调用时才加载，适合放长流程文档。

参数占位符：$ARGUMENTS（全部参数）、$ARGUMENTS[N] / $N（按位置，0 起）、frontmatter arguments: [issue, branch] 映射 $issue。动态上下文注入 !command：在发送给 Claude 前执行并把输出替换进 skill 正文（如 !gh pr diff、!gh pr view --comments），多行指令用

Subagent 是独立 context 窗口、独立 system prompt 与独立权限的专职助手，只把摘要回传主对话，从而保护主 context。内置三类：Explore——只读、擅长搜索/分析代码库（Write/Edit 被拒，model 继承主工作阶段且封顶 Opus）；Plan——plan mode 下做只读代码库调研；general-purpose——拥有全部 subagent 工具的复杂多步助手（探索+修改）。Claude 依据任务描述和 subagent 的 description 自动委派。停用/限制：permissions.deny: ["Agent(Explore)"] 阻止单个类型，deny Agent 工具本身则禁止一切委派，CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1 移除内置 Explore/Plan。

Subagent = 带 YAML frontmatter 的 Markdown 文件，放 .claude/agents/（项目共享、入库）或 ~/.claude/agents/（个人跨项目）。完整示例：

仅 name 和 description 必填；tools 省略则继承全部可用工具，disallowedTools: Write, Edit 做黑名单；model 可写 sonnet/opus/haiku 或 inherit。调用方式三档：自然语言点名、@"code-reviewer (agent)" @ 提及（保证执行）、claude --agent code-reviewer 整工作阶段以该 subagent 执行。位置优先级：managed settings > --agents CLI > .claude/agents/ > ~/.claude/agents/ > plugin。

frontmatter 更多能力：memory: user 给 subagent 持久记忆目录（user→~/.claude/agent-memory/<name>/、project→.claude/agent-memory/、local→本地不入库）；mcpServers: - github 或内联定义 - playwright: {type: stdio, command: npx, args: ["-y", "@playwright/mcp@latest"]} 让子代理独享 MCP 工具；frontmatter 内可写 hooks: 作用域到该 agent；tools: Agent(worker, researcher) 可限制可派生的子代理类型，但此白名单仅对主线程 agent（claude --agent）生效；subagent 定义中括号内类型会被忽略。默认可嵌套 3 层。控成本：model: haiku 把任务路由到更平价模型。CLI 临时定义：claude --agents '{ "code-reviewer": { "description": "...", "prompt": "...", "tools": ["Read","Bash"], "model": "sonnet" } }'。v2.1.198 起 subagent 默认后台执行，Ctrl+B 前后台切换，/tasks 查看；permissionMode: acceptEdits 可让子代理自动接受文件编辑。

MCP（Model Context Protocol）让 Claude Code 直连外部工具/数据库/API。新增服务器：远程 HTTP（推荐，支持 OAuth）claude mcp add --transport http notion https://mcp.notion.com/mcp；本地 stdio claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server（注意 -- 之后才是服务器指令，之前是 --transport/--env/--scope 等自身参数）；SSE --transport sse 已弃用。管理命令：claude mcp list、claude mcp get <name>、claude mcp remove <name>，工作阶段内 /mcp 面板查看连接状态与工具数。三种 scope：--scope local（默认，写 ~/.claude.json 只限当前项目私有）、--scope project（写 .mcp.json 入库与团队共享）、--scope user（跨所有项目）。同一服务器重名时按 local > project > user > plugin > claude.ai 连接器取最高优先级。

项目共享服务器写入 .mcp.json，格式：

.mcp.json 支持 ${VAR} 与 ${VAR:-default} 环境变量展开（可用于 command/args/env/url/headers，如 "Authorization": "Bearer ${API_KEY}"），安全起见 .mcp.json 首次使用需批准。认证：HTTP 服务器 OAuth 在工作阶段内 /mcp 登录，或命令行 claude mcp login <name>（无浏览器加 --no-browser）；静态 token 用 --header "Authorization: Bearer your-token" 传入。安全注意：远程 MCP 服务器可能引入 prompt injection 风险，只连接信任的服务器；MCP 工具走标准权限系统，可用 permissions.deny 限制，服务器作者可用 _meta["anthropic/requiresUserInteraction"]: true 强制每个工具调用都需人工批准。企业可用 managed-mcp.json 集中管控（allowedMcpServers/deniedMcpServers）。

Hooks 是用户定义的 shell 指令，Claude Code 在生命周期固定节点确定性执行（不依赖 LLM 决策），用于强制执行规则与自动化。核心事件：SessionStart（工作阶段开始）、UserPromptSubmit（提交提示词）、PreToolUse（工具调用前，可阻止）、PostToolUse（成功后）、PermissionRequest（权限决策）、Notification（等待输入通知）、Stop（回应结束）、PreCompact/PostCompact（压缩前后）、SubagentStart/SubagentStop、SessionEnd。在 settings 里配 hooks 区块：

位置决定作用域：~/.claude/settings.json（全局）、.claude/settings.json（入库共享）、.claude/settings.local.json（个人不入库）。/hooks 菜单浏览；disableAllHooks: true 全局关闭。

自动格式化：PostToolUse + matcher Edit|Write，指令 jq -r '.tool_input.file_path' | xargs npx prettier --write。保护敏感文件：PreToolUse 脚本读 stdin JSON，命中 .env/package-lock.json/.git/ 时向 stderr 写原因并 exit 2 阻止（exit 0 = 放行走正常权限流）。压缩后重注入上下文：SessionStart matcher compact，echo 'Reminder: use Bun, not npm. Run bun test before committing.'。自动批准计划模式：PermissionRequest matcher ExitPlanMode，stdout 输出 JSON {"hookSpecificOutput": {"hookEventName": "PermissionRequest", "decision": {"behavior": "allow"}}}。判定类决策用 type: "prompt"（Haiku 单轮返回 {"ok": true/false}）或 type: "agent"（subagent 核查代码后决定）。matcher 区分大小写，工具名用 | 分隔（Bash|Edit）。

非交互模式用 -p（或 --print）传提示词即可跑脚本/CI：claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"。自动批准用 --allowedTools "Bash(git diff *)"（尾随 * 前缀匹配）；或用权限模式 --permission-mode acceptEdits（免确认改文件）、dontAsk（锁定 CI，未授权即拒绝）。结构化输出 --output-format json（含 result/session_id/每模型成本 total_cost_usd）或 stream-json（--verbose --include-partial-messages 流式事件）；--json-schema '{"type":"object",...}' 获得 schema 化输出。管道 stdin：cat build-error.txt | claude -p 'concisely explain this build error' > output.txt。CI 推荐加 --bare 跳过 hooks/skills/plugins/MCP/CLAUDE.md 自动发现，保证各机器结果一致。续工作阶段：claude -p "..." --continue 或 --resume "$session_id"。

用官方 anthropics/claude-code-action@v1 在 workflow 里跑 Claude Code（基于 Agent SDK）。先在仓库 Settings→Secrets 新增 ANTHROPIC_API_KEY，workflow 中引用 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}（绝不可硬编码密钥）。基本示例：

claude_args 透传任意 CLI 参数（--max-turns/--model/--mcp-config/--allowedTools）。在 PR/issue 评论里 @claude implement this feature 可触发交互；skill 经 plugin_marketplaces/plugins 安装后可在 prompt 里以 /code-review:code-review ... 调用。成本控制：设置合理 --max-turns 防失控迭代、加 workflow 级 timeout、用 GitHub 并发限制，并优先让 CLAUDE.md 引导行为减少无效调用。仓库根的 CLAUDE.md 即 CI 中 Claude 遵循的编码规范来源。