mcpField
C
context-master

context-master

github.com/josiahsiegelAgent 工作流59397 次安装19 周前更新
代码仓库

关于 context-master

context-master 是面向复杂多文件任务和长会话的上下文管理与规划技能，提供项目执行步骤及分析、实施和验证参考资料。

主要功能

  1. 01多文件项目五步工作流
  2. 02规划与文件排序指导
  3. 03上下文效率原则及反模式
  4. 04研究与重构参考工作流
  5. 05Claude Code CLI 上下文管理指导

适用场景

  1. 01规划网站或多文件应用
  2. 02评估架构或技术选型
  3. 03组织长时间编码或重构会话

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/josiahsiegel/claude-plugin-marketplace --skill context-master

安装后在 Claude Code 中输入/context-master确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
agent-skills-integration-2025.md
anti-patterns.md
claude-code-cli.md
context_strategies.md
multi-file-planning.md
subagent_patterns.md
thinking-delegation.md
troubleshooting.md
universal-best-practices.md
workflows.md
scripts/
create_subagent.py
generate_claude_md.py

详细介绍

Context Master

适用于复杂任务、长会话和多文件项目的通用上下文管理与规划技能。无论你使用 Web 应用、API 还是 Claude Code CLI，操作方式都相同；CLI 专属优势见 references/claude-code-cli.md。

此 SKILL.md 刻意保持简短。详细内容位于 references/ 中——只加载你需要的内容。

何时启用

只要请求符合以下任一情形，就主动启用：

  • 多文件项目（3 个或更多相关文件、网站、应用、API、文档集）。
  • 架构或技术决策（“我们应该用 X 还是 Y”“哪种方案……”）。
  • 研究、比较或权衡分析。
  • 重构或迁移工作。
  • 需要关注上下文效率的长时间编码会话。
  • 任何包含 3 个或更多连续步骤或共享依赖项的任务。

如果任务只涉及一个没有依赖项的文件，则跳过此技能。

5 步工作流（请牢记）

对于任何多文件项目——网站、应用、API、文档集——按顺序执行以下五个步骤：

  1. STOP — 暂时不要创建任何文件。
  2. PLAN — 使用扩展思考或规划文档（两者同样有效；参见 references/multi-file-planning.md）。
  3. ANNOUNCE — 向用户说明文件列表和创建顺序。
  4. CREATE — 按最佳顺序编写文件（基础文件优先于依赖文件）。
  5. VERIFY — 检查每个引用是否都能解析；在宣布完成前修复问题。
示例演练（作品集网站）
User: "Create a portfolio with home, about, projects, and contact pages."

Step 1 STOP    -- do not start with index.html.
Step 2 PLAN    -- "Think hard about architecture: 5 files needed,
                  styles.css is the shared dependency."
Step 3 ANNOUNCE -- "I'll create:
                  1. styles.css       (shared styling)
                  2. index.html       (references styles.css)
                  3. about.html
                  4. projects.html
                  5. contact.html"
Step 4 CREATE   -- write files in that order.
Step 5 VERIFY   -- every HTML file links styles.css; navigation resolves.

Result: no refactor, no re-export, no broken links.

完整模板、按项目类型（网站 / React / 后端 API 等）整理的最佳顺序模式，以及验证清单，见 references/multi-file-planning.md。

核心原则（每条一句）

  1. 先规划，再编写 — 使用扩展思考或规划文档，不能两者都不做。
  2. 先打好基础 — 共享依赖项（CSS、配置、基类、架构）应先于依赖它们的内容。
  3. 将深入分析委派到隔离上下文 — 子 Agent（CLI）或思考产物（Web/API）可让主线程保持清晰。
  4. 明确阶段边界 — 标明每个阶段（“阶段 1 已完成；进入阶段 2：……”），避免上下文混乱。
  5. 优先使用产物，而非内联内容 — 长篇代码或文档应放在产物 / 文件中，而不是聊天记录里。
  6. 渐进式披露 — 一次询问一个部分；不要把无关步骤打包处理。
  7. 标记重置 — 改变方向时，说“先搁置之前的方案……”。
  8. 大型项目完成后复盘 — 是否做好了规划？引用是否失效？使用 references/multi-file-planning.md 中的项目后检查清单。

每项原则的完整依据和示例：references/universal-best-practices.md。

Token 节省经验法则

项目规模未规划已规划节省
小型（3-4 个文件）~6,000 个 token~2,500 个 token~58%
中型（7-8 个文件）~12,000 个 token~4,500 个 token~63%
大型（20 个以上文件）~35,000 个 token~12,000 个 token~66%

200K-token 上下文窗口在规划的情况下大约可容纳 16-17 个中型项目；不规划则可容纳 7-8 个——实际容量提升 2.1 倍。数字和方法见 references/multi-file-planning.md。

被动式深度思考架构

提升上下文效率最有力的模式：将深度推理交由隔离空间处理，再把简短摘要返回主线程。

  • Claude Code CLI：/agent deep-analyzer "Ultrathink about [decision]" — 约 5K 个 token 的推理在外部完成；主上下文收到约 200 个 token 的摘要（效率约提升 23 倍）。
  • Web / API："Create a deep-analysis artifact and ultrathink about [decision]" — 思路相同，但使用产物而非子 Agent。

触发条件、反模式和现成提示词：references/thinking-delegation.md。

常见工作流（仅提供指引）

每种工作流都在 references/workflows.md 中提供了分步操作流程：

  • 工作流 0 — 多文件网站/项目创建（默认流程 — 与上文相同的 5 个步骤，但细节更多）。
  • 工作流 1 — 复杂决策（架构、技术选择）。
  • 工作流 2 — 复杂功能开发（分析 → 设计 → 实现 → 测试 → 集成）。
  • 工作流 3 — 研究与技术评估。
  • 工作流 4 — 通过工件生成和迭代代码。
  • 工作流 5 — 通过隔离分析进行重构。

反模式（请避免）

快速参考 — 示例和修正方法见 references/anti-patterns.md：

  1. 计划前就创建文件 — 重构会浪费上下文。
  2. 一次性提出所有要求 — 会使上下文过载，导致输出浅显。
  3. 在聊天中内联大段代码/文档 — 会使历史记录膨胀；请使用工件/文件。
  4. 让深度推理发生在主线程中 — 会耗费约 5K 个令牌，而交给子 Agent 处理可能只需约 200 个。
  5. 没有阶段边界 — 上下文会在无关子任务之间混淆。

故障排除

当会话偏离方向时（回复不聚焦、对话变得过长、代码被重新生成而非编辑、扩展思考未启动），请参阅 references/troubleshooting.md，其中的症状 → 解决方法表分别涵盖 Web/API 和 CLI。

Claude Code CLI 的额外优势

如果你在 Claude Code CLI 中运行，还可以使用：

  • /clear、/compact、/continue — 内置的上下文控制功能。
  • /agent <name> — 将任务委派给隔离的子 Agent。
  • CLAUDE.md — 持久化项目记忆。
  • 用于生成 CLAUDE.md 和子 Agent 定义的辅助脚本。

详细信息、脚本调用方法和深度分析委派模式见 references/claude-code-cli.md。

两者都可用时，Skill 与子 Agent 的集成模式见 references/agent-skills-integration-2025.md。长篇上下文策略和子 Agent 提示词模式见 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 中运行并需要子 Agent / CLAUDE.md 工具。
references/agent-skills-integration-2025.md在 CLI 中将技能与子 Agent 结合使用。
references/context_strategies.md长篇策略笔记。
references/subagent_patterns.md子 Agent 提示词模式。

成功指标

  • 创建任何文件前，你已宣布计划。
  • 基础文件（CSS、配置、架构）先于依赖文件编写。
  • 首次运行时没有引用失效；无需重构。
  • 深度推理在子 Agent 或工件中进行，而非主线程。
  • 每进入一个阶段，都为其命名。

如果其中任何一项未达成，请在开始下一个任务前，回顾 references/anti-patterns.md 和 references/multi-file-planning.md 中的项目后复盘部分。

评论

支持 Markdown