Context Master
适用于复杂任务、长时间会话和多文件项目的通用上下文管理与规划技能。无论是在 Web 应用、API 还是 Claude Code CLI 中，其工作方式相同；针对 CLI 的特定增强功能位于 references/claude-code-cli.md 中。
此 SKILL.md 文件有意保持简洁。详细材料位于 references/ 目录中——仅加载您需要的内容。
何时激活
当请求符合以下任一情况时，请主动激活：
- 多文件项目（3个以上相关文件、网站、应用、API、文档集）。
- 架构或技术决策（“我们应该用 X 还是 Y”、“哪种方法……”）。
- 研究 / 对比 / 权衡分析。
- 重构或迁移工作。
- 需要关注上下文效率的长时间编码会话。
- 任何包含3个以上连续步骤或共享依赖关系的任务。
如果请求是单个文件且无依赖关系，则跳过此技能。
5步工作流程（请牢记）
对于任何多文件项目——网站、应用、API、文档集——请按顺序执行以下五个步骤：
- 停止 —— 暂时不要创建任何文件。
- 规划 —— 使用延展性思考 或 一份规划文档（两者同样有效；请参阅
references/multi-file-planning.md）。 - 宣布 —— 向用户说明文件列表及创建顺序。
- 创建 —— 按最优顺序编写文件（基础文件先于依赖文件）。
- 验证 —— 检查所有引用是否解析正确；在声明完成前修复问题。
示例（投资组合网站）
用户：“创建一个包含主页、关于、项目和联系页面的投资组合。”
步骤 1 停止 —— 不要从 index.html 开始。
步骤 2 规划 —— “仔细思考架构：需要5个文件，styles.css 是共享依赖项。”
步骤 3 宣布 —— “我将创建：
1. styles.css （共享样式）
2. index.html （引用 styles.css）
3. about.html
4. projects.html
5. contact.html”
步骤 4 创建 —— 按此顺序编写文件。
步骤 5 验证 —— 每个 HTML 文件都链接到 styles.css；导航解析正确。
结果：无需重构，无需重新导出，无链接损坏。
完整的模板、按项目类型（网站 / React / 后端 API 等划分的最优顺序模式）以及验证核查清单，请参阅 references/multi-file-planning.md。
核心原则（每行一条）
- 先规划再编写 —— 使用延展性思考或规划文档，两者不能都跳过。
- 基础先行 —— 共享依赖项（CSS、配置、基类、模式）先于依赖项。
- 将深度分析委托给隔离上下文 —— 将子代理（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 "对 [决策] 进行深度思考"—— 约 5K tokens 的推理在带外进行；主上下文收到约 200 tokens 的摘要（约 23 倍效率）。 - Web / API：
"创建一个深度分析工件并对 [决策] 进行深度思考"—— 理念相同，使用工件代替子代理。
触发条件、反模式和现成提示词：references/thinking-delegation.md。
常见工作流程（仅指路）
以下每个工作流程均有分步步骤，详见 references/workflows.md：
- 工作流程 0 —— 多文件网站/项目创建（默认流程——与上述 5 步相同，但包含更多细节）。
- 工作流程 1 —— 复杂决策制定（架构、技术选择）。
- 工作流程 2 —— 复杂功能开发（分析 → 设计 → 实现 → 测试 → 集成）。
- 工作流程 3 —— 研究与技术评估。
- 工作流程 4 —— 通过工件进行代码生成与迭代。
- 工作流程 5 —— 通过隔离分析进行重构。
反模式（避免这些）
快速列表——示例和修复方法见 references/anti-patterns.md：
- 在规划前创建文件 —— 浪费上下文在重构上。
- 一次要求所有内容 —— 使上下文过载并产生浅层输出。
- 在聊天中内联长代码/文档 —— 使历史记录臃肿；应使用工件/文件。
- 让深度推理发生在主线程 —— 成本约 5K tokens，而本可减少至约 200 tokens。
- 没有阶段边界 —— 上下文在不相关的子任务间模糊不清。
故障排除
当会话偏离主题（回复不集中、对话过长、代码重新生成而非编辑、延展性思考未启用）时，请参阅 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、配置、模式）在依赖文件之前编写。
- 首次运行时没有引用损坏；无需重构。
- 深度推理发生在子代理或工件中，而非主线程。
- 在跨越阶段时命名了各个阶段。
如果上述任何一项未能满足，请在执行下一个任务之前，回溯检查 references/anti-patterns.md 和 references/multi-file-planning.md 的项目后反思部分。