61 行
2.2 KiB
Markdown
61 行
2.2 KiB
Markdown
# 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/analysis-template.md)
|
|
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
|
|
|
|
## Stable Knowledge
|
|
- 设计哲学、命名规则、阶段流程、技术栈白名单、技能映射、模板、ADR
|
|
|
|
## Runtime Context
|
|
- 当前会议摘录
|
|
- 单次探索结果
|
|
- 临时报错和实验结论
|
|
- 某一轮对比参考仓库的细节
|
|
|
|
## Handoff Rule
|
|
- 任何 handoff 必须能回答：要做什么、不能做什么、以什么为准、交付什么、怎么验收。
|
|
- handoff 不是全文转发，更不是把整个聊天记录交给下一个 agent。
|