skills/cc-switch-dev-workflow/references/knowledge-base/foundations/context-engineering.md

Foundation: Context Engineering

Purpose

定义稳定知识、运行时上下文和 handoff 摘要之间的边界，避免把会议纪要、长文档和临时报错直接堆给所有 agent。

When to Use

• 设计 CC Switch 多 agent 协作方式时
• 某个线程上下文越来越大、输出开始发散时
• 需要决定什么该进入知识库、什么只留在本轮执行时

Inputs

• 当前阶段的源材料
• 上一阶段的高密度产物
• 当前任务的范围边界

Outputs

• 边界清晰的 handoff 摘要
• 可复用稳定知识
• 可丢弃的运行时噪音

Primary Agent/Model

GPT-5.4 Pro xhigh

Secondary Agent/Model

Claude Opus 4.6

Required Skills

• 无强制 skill；遵循本知识库的 handoff 和阶段模板

Steps

1. 区分“长期规则”和“单次执行信息”。
2. 只把可复用、可稳定引用的内容写入知识库。
3. 每个阶段结束后，把长上下文压缩成 ANALYSIS.md、SPECS/*.md、.plans/*.md 或 handoff 摘要。
4. 进入下一阶段前，优先开新线程，让新线程只读取高密度产物，而不是带着旧对话继续滚动。

Exit Criteria

• 下一阶段不依赖上一阶段的完整长对话
• handoff 内容短、准、可执行
• 知识库只保留长期有效的规则

Failure Recovery

• 如果模型开始引用过时讨论、已废弃方案或混乱术语，立即 reset 线程并只提供高密度产物
• 如果手头信息无法压缩成一句目标、一个范围、一个来源清单，说明当前上下文还没整理好，先回到计划阶段

Related Templates

• ../templates/analysis-template.md
• ../templates/agent-handoff-template.md

Stable Knowledge

• 设计哲学、命名规则、阶段流程、技术栈白名单、技能映射、模板、ADR

Runtime Context

• 当前会议摘录
• 单次探索结果
• 临时报错和实验结论
• 某一轮对比参考仓库的细节

Handoff Rule

• 任何 handoff 必须能回答：要做什么、不能做什么、以什么为准、交付什么、怎么验收。
• handoff 不是全文转发，更不是把整个聊天记录交给下一个 agent。