Context Master 是一个通用的上下文管理与规划技能，面向复杂任务、长会话和多文件项目。无论你是在 Web 应用、API 还是 Claude Code CLI 中工作，它的工作方式都相同；CLI 专属的附加功能位于 references/claude-code-cli.md。该 SKILL.md 被有意保持简短，详细材料放在 references/ 目录中，按需加载。
何时激活
当请求符合以下任一情况时，主动激活：多文件项目（3 个以上相关文件、网站、应用、API、文档集）；架构或技术决策（“应该用 X 还是 Y”“哪种方法……”）；研究/对比/权衡分析；重构或迁移工作；上下文效率重要的长编码会话；任何有 3 个以上顺序步骤或共享依赖的任务。如果请求是单个文件且无依赖，则跳过此技能。
5 步工作流（需记住）
对于任何多文件项目——网站、应用、API、文档集——按顺序执行以下五步：
- STOP——暂时不要创建任何文件。
- PLAN——使用扩展思考或规划文档（两者同样有效；见 references/multi-file-planning.md）。
- ANNOUNCE——向用户说明文件列表和创建顺序。
- CREATE——按最优顺序编写文件（基础先于依赖）。
- VERIFY——检查每个引用都能解析；在宣布完成前修复问题。
示例（作品集网站）
用户：“创建一个包含 home、about、projects 和 contact 页面的作品集。”
步骤 1 STOP——不要从 index.html 开始。 步骤 2 PLAN——“深入思考架构：需要 5 个文件，styles.css 是共享依赖。” 步骤 3 ANNOUNCE——“我将创建：1. styles.css（共享样式）2. index.html（引用 styles.css）3. about.html 4. projects.html 5. contact.html” 步骤 4 CREATE——按该顺序编写文件。 步骤 5 VERIFY——每个 HTML 文件都链接 styles.css；导航可解析。
结果：无需重构、无需重新导出、无断链。完整模板、按项目类型（网站 / React / 后端 API 等）的最优顺序模式以及验证清单见 references/multi-file-planning.md。
核心原则（每条一句话）
先规划再编写——扩展思考或规划文档，绝不能两者都跳过。 基础优先——共享依赖（CSS、配置、基类、schema）先于依赖项。 将深度分析委托给隔离上下文——子代理（CLI）或思考产物（Web/API）保持主线程干净。 阶段边界——为每个阶段命名（“阶段 1 完成；进入阶段 2：……”），避免上下文模糊。 产物优于内联内容——长代码或文档放在产物/文件中，而非聊天历史。 渐进式披露——一次请求一个切片；不要批量处理不相关的步骤。 信号重置——改变方向时说“暂时搁置之前的方法……”。 大型项目后反思——是否规划过？引用是否断裂？使用 references/multi-file-planning.md 中的项目后清单。
每条原则的完整理由和示例：references/universal-best-practices.md。
Token 节省经验法则
项目规模 / 无规划 / 有规划 / 节省： 小（3-4 个文件）：约 6,000 tokens / 约 2,500 tokens / 约 58% 中（7-8 个文件）：约 12,000 tokens / 约 4,500 tokens / 约 63% 大（20+ 个文件）：约 35,000 tokens / 约 12,000 tokens / 约 66%
一个 200K token 的上下文窗口在有规划时大约可容纳 16-17 个中型项目，无规划时 7-8 个——有效提升 2.1 倍。数字和方法论见 references/multi-file-planning.md。
被动深度思考架构
上下文效率最强大的单一模式：将深度推理路由到隔离空间，并向主线程返回简短摘要。
Claude Code CLI：/agent deep-analyzer "Ultrathink about [decision]"——约 5K tokens 的推理在带外进行；主上下文收到约 200 token 的摘要（约 23 倍效率）。 Web / API：“Create a deep-analysis artifact and ultrathink about [decision]”——相同思路，用产物代替子代理。
触发器、反模式和现成提示词：references/thinking-delegation.md。
常见工作流（仅指针）
以下每个在 references/workflows.md 中都有分步流程：
工作流 0——多文件网站/项目创建（默认——即上述 5 步，含额外细节）。 工作流 1——复杂决策（架构、技术选型）。 工作流 2——复杂功能开发（分析 → 设计 → 实现 → 测试 → 集成）。 工作流 3——研究与技术评估。 工作流 4——通过产物进行代码生成与迭代。 工作流 5——带隔离分析的重构。
反模式（避免这些）
快速清单——示例和修复见 references/anti-patterns.md：
规划前创建文件——在重构上浪费上下文。 一次性请求所有内容——使上下文过载并产生浅层输出。 在聊天中内联长代码/文档——使历史膨胀；使用产物/文件。 让深度推理发生在主线程——花费约 5K tokens，本可只需约 200。 没有阶段边界——上下文在无关子任务间模糊。
故障排查
当会话漂移（响应不聚焦、对话过长、代码重新生成而非编辑、扩展思考未启用）时，见 references/troubleshooting.md 中的症状 → 补救表，分别覆盖 Web/API 和 CLI。
Claude Code CLI 附加功能
如果你在 Claude Code CLI 中运行，还可获得：/clear、/compact、/continue——内置上下文控制；/agent <name>——委托给隔离子代理；CLAUDE.md——持久项目记忆；用于生成 CLAUDE.md 和子代理定义的辅助脚本。详情、脚本调用和深度分析委托模式：references/claude-code-cli.md。技能–子代理集成模式（两者都可用时）见 references/agent-skills-integration-2025.md。长格式上下文策略和子代理提示模式：references/context_strategies.md 和 references/subagent_patterns.md。
参考文件地图
references/multi-file-planning.md——规划模板、按项目类型的最优顺序模式、验证清单、项目后反思。 references/universal-best-practices.md——需要 8 条核心原则中任何一条的理由或示例时。 references/workflows.md——需要特定场景（决策、功能、研究、重构）的分步流程时。 references/thinking-delegation.md——设计深度分析委托或编写思考提示词时。 references/anti-patterns.md——审查当前方法是否浪费上下文时。 references/troubleshooting.md——会话漂移、缓慢或产生过多解释时。 references/claude-code-cli.md——在 Claude Code CLI 中运行并想要子代理 / CLAUDE.md 工具时。 references/agent-skills-integration-2025.md——在 CLI 中结合技能与子代理时。 references/context_strategies.md——长格式策略笔记。 references/subagent_patterns.md——子代理提示模式。
成功指标
在创建任何文件前宣布了计划。 基础文件（CSS、配置、schema）先于依赖项编写。 首次运行无引用断裂；无需重构。 深度推理发生在子代理或产物中，而非主线程。 跨越阶段时为其命名。
如果其中任何一项失败，在下一个任务前回顾 references/anti-patterns.md 和 references/multi-file-planning.md 的项目后部分。