深入理解 Claude Code：从 CLAUDE.md 到 Hooks、Skills、Subagents..

📌 一句话摘要

本文系统梳理 Claude Code 中 CLAUDE.md、Rules、Skills、Subagents、Hooks、Output Styles、System Prompt Append 及 Dynamic Workflows 等上下文注入机制的原理、适用场景与最佳实践，帮助开发者理解如何为不同指令赋予合适的生命周期。

📝 详细摘要

文章以「上下文即一切」为核心前提，详细拆解了 Claude Code（及类似 Coding Agent）提供的多种上下文注入方法。作者首先通过对比表格，从加载时机、作用域、是否占用 token 等维度，清晰区分了 CLAUDE.md（全程加载）、Rules（路径限定）、Skills（按需加载）、Subagents（独立上下文）、Hooks（确定性执行）等机制。随后逐一深入讲解每种方法：CLAUDE.md 适合存放项目事实（构建命令、目录结构），但应避免放入流程或绝对性约束；Rules 通过路径限定实现精细控制；Skills 本质是打包的文件集合，用于按步骤执行的流程；Subagents 在独立上下文中运行，适合脏活累活；Hooks 是确定性脚本，适合做安全护栏。文章还介绍了 Output Styles（替换默认 system prompt）和 System Prompt Append（临时追加指令）两种轻量级方法，并总结了常见配置误区。最后，文章介绍了 Dynamic Workflows，它通过让 Claude 自己编写编排脚本，协调多个 Subagent 并行工作，以解决 Agent 的偷懒、自我偏好和目标漂移问题，并列举了六种常见编排模式。

💡 主要观点

- 不同的指令应有不同的生命周期，不应全部塞入 CLAUDE.md。 CLAUDE.md 全程占用 token，适合存放项目事实；流程应放 Skills，护栏放 Hooks，隔离任务给 Subagents，精细约束用 Rules。

Skills 的本质是打包的文件集合，而非单纯的提示词。 Skill 是一个包含 SKILL.md 和辅助文件的文件夹，打包为 .skll 文件。调用时加载完整内容，适合部署流程、Review Checklist 等按步骤执行的流程。

Hooks 是确定性执行机制，是唯一可靠的安全护栏。 Hooks 通过事件触发执行命令或脚本，完全绕过模型判断。PreToolUse hook 可拦截危险命令，exit code 2 直接阻止执行，比任何提示词防护都可靠。

Dynamic Workflows 通过独立上下文窗口隔离子任务，解决 Agent 的偷懒、自我偏好和目标漂移问题。 Claude 自己编写编排脚本，使用 Agent()、parallel()、pipeline() 等函数协调多个 Subagent 并行工作。常见模式包括扇出合成、对抗验证、锦标赛等。

绝对性约束不应写在提示词中，而应使用 Hooks 或 Managed Settings。 提示词防护在长会话、压力大或被 Prompt Injection 干扰时可能失效。PreToolUse hook 或组织级 Managed Settings 提供确定性执行，用户无法覆盖。

💬 文章金句

- 不同的指令，要有不同的生命周期。

• 事实放 CLAUDE.md，流程放 Skill，护栏放 Hook，隔离任务给 Subagent。
• 如果某件事绝对不能发生，用 hook 或 permission 做硬护栏。
• Agent 和 ChatBot 的区别在一件事上【谁来构建上下文】。

📊 文章信息

AI 初评：88

来源：赛博禅心

作者：赛博禅心

分类：人工智能

语言：中文

阅读时间：24 分钟

字数：5897

标签： AI 编程, Claude Code, AI Agent, 提示工程, 上下文工程

阅读完整文章