用途
Context Manager 是一个用户可调用的辅助技能，用于在长时运行的构建任务中管理上下文窗口用量、压缩策略和会话交接。当一段对话的上下文即将耗尽、需要压缩或交接给新会话时，用户会直接调用它。它不会在构建过程中由编排器（orchestrator）自动派生。
在编排式构建过程中，交接校验由 skills/orchestrator/references/handoff-protocol.md（编排器实际运行的协议）管理。本技能面向的是该循环之外、由用户驱动的压缩与交接。
主要能力
- 帮助用户在会话过满时高效管理上下文窗口。
- 当用量接近上限（约 80%）时，协助生成结构化交接文件，使新的续接会话能够无缝接手。
- 校验交接质量：在用户转移到新会话之前，确保所写的交接文件包含可执行的续接上下文。
所有权与边界
- 独占拥有：.claude/handoffs/ 目录
- 共享读取：所有项目文件（只读）
- 禁止触碰：src/、实现代码
- 已解决的冲突（v1.1）：.claude/handoffs/ 此前被 orchestrator 与 context-manager 同时声明拥有。context-manager 是用户驱动交接的最终所有者——由它写入并校验。编排式构建期间的构建循环交接由 skills/orchestrator/references/handoff-protocol.md 单独管理。
输入
- 上下文信号——当前会话接近约 80% 的上下文用量
- 交接草稿（可选）——用户可提供一份草稿交接文件供校验和改进
- 压缩请求（可选）——用户在诉诸完整交接之前，请求帮助压缩会话
何时行动
- 会话上下文用量接近 80%
- 长时运行任务需要跨多个会话继续
- 用户希望把对话转移到新会话
交接协议
当会话需要交接时，向 .claude/handoffs/ 写入一个结构化 YAML 文件。完整规范见 references/compaction-guide.md。
交接文件结构：
handoff_version: "1.0.0"
agent_role: [role name]
timestamp: [ISO 8601]
session_id: [string]
context_usage_pct: [number]
task_state:
assigned_task: [what was assigned]
completion_pct: [honest estimate]
completed_subtasks: [list]
remaining_subtasks: [list]
blockers: [list]
decisions_made:
- decision: [what was decided]
rationale: [why]
affects_files: [which files]
files_modified: [list of relative paths]
files_created: [list of relative paths]
contracts_consumed: [which contract files were read]
continuation_context: |
[Free-text: what the continuation agent needs to know.
Key variable names, error states, partial work, next action.
≤500 words.]
suggested_first_action: [exact next step]
在新会话中续接
交接文件写入后，用户启动一个新会话，并将其指向 .claude/handoffs/ 中最新的文件。续接会话读取 files_modified 和 files_created 以了解当前状态，然后从 suggested_first_action 开始。
在编排式构建内部，对交接的读取/校验/派生行为由 skills/orchestrator/references/handoff-protocol.md 管理，而非本技能。本技能负责写入和质检用户驱动的交接文件，不重复编排器的构建循环校验。
上下文效率提示
对于接近上下文上限的会话：
- 避免重复读取已在上下文中的文件
- 在存入上下文之前先总结冗长输出
- 聚焦当前任务，而非此前已完成的工作
- 使用 references/compaction-guide.md 中的压缩策略
协调
- 交接文件为仅追加——绝不修改先前的交接
- 每个交接使用唯一文件名：{role-or-session}-{timestamp}.yaml
- 质量门（你的职责）：在宣布交接就绪之前，校验 continuation_context 具体且可执行（不含糊）、suggested_first_action 是确切的下一步、completion_pct 是诚实的估计。拒绝并重写含糊的交接。
适用场景与限制
适用场景：长时运行、多智能体构建中，会话上下文接近 80% 需要压缩或交接；用户希望把对话转移到新会话；用户提供交接草稿需要校验改进。
限制：本技能不参与编排构建循环内的交接校验（由 orchestrator 协议管理）；不触碰 src/ 与实现代码；交接文件仅追加，不可修改历史交接。关于收费、价格、平台支持等信息，资料中暂未提供。