Context Engineering

Context Engineering

用途

• 为复杂、多会话、多角色任务建立 结构化项目上下文，保证每轮 agent 启动时拿到完整且受控的项目背景。
• 与 context-lifecycle（运行时记忆管理）互补：本 skill 管 项目级文档层（L3+），context-lifecycle 管 运行时窗口层（L0-L2）。
• 控制文档 token 预算，避免"文档越来越多、上下文越来越模糊"的腐烂问题。

触发信号

• 新任务 intake 阶段需要建立或刷新项目上下文。
• /team-intake、/team-plan 输出后需要落盘为结构化文档。
• 跨会话恢复时需要快速加载上下文而不丢失关键决策。
• 多个 agent 并行工作需要共享一致的项目背景。
• 上下文窗口利用率接近阈值，需裁剪文档到预算范围。

四层文档模型

docs/artifacts/{slug}/
├── PROJECT.md          # 项目愿景、边界、关键假设   (≤ 3000 tokens)
├── REQUIREMENTS.md     # 范围化需求与验收标准       (≤ 5000 tokens)
├── ROADMAP.md          # 阶段路线与里程碑           (≤ 3000 tokens)
└── STATE.md            # 运行时状态：决策、阻塞、进度 (≤ 4000 tokens)

PROJECT.md — 项目愿景（≤ 3000 tokens）

不变频率最低，只在项目方向调整时更新。

# {Project Name}

## 愿景
一句话说明项目存在的原因和最终目标。

## 边界
- In Scope: ...
- Out of Scope: ...