القائمة
项目级上下文工程框架：通过 PROJECT / REQUIREMENTS / ROADMAP / STATE 四层文档 为每个任务建立结构化上下文，控制 token 预算，防止上下文腐烂， 确保跨会话连续性。与 context-lifecycle 的 L0-L3 层互补。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | context-engineering |
| description | 项目级上下文工程框架：通过 PROJECT / REQUIREMENTS / ROADMAP / STATE 四层文档 为每个任务建立结构化上下文，控制 token 预算，防止上下文腐烂， 确保跨会话连续性。与 context-lifecycle 的 L0-L3 层互补。 |
| origin | gsd-get-shit-done + harness-engineering |
context-lifecycle（运行时记忆管理）互补：本 skill 管 项目级文档层（L3+），context-lifecycle 管 运行时窗口层（L0-L2）。/team-intake、/team-plan 输出后需要落盘为结构化文档。docs/artifacts/{slug}/
├── PROJECT.md # 项目愿景、边界、关键假设 (≤ 3000 tokens)
├── REQUIREMENTS.md # 范围化需求与验收标准 (≤ 5000 tokens)
├── ROADMAP.md # 阶段路线与里程碑 (≤ 3000 tokens)
└── STATE.md # 运行时状态：决策、阻塞、进度 (≤ 4000 tokens)
不变频率最低，只在项目方向调整时更新。
# {Project Name}
## 愿景
一句话说明项目存在的原因和最终目标。
## 边界
- In Scope: ...
- Out of Scope: ...
## 关键假设
- [ ] 假设 1（待验证 / 已验证 / 已推翻）
- [ ] 假设 2
## 技术栈
- 语言 / 框架 / 基础设施
## 利益相关方
- 角色: 关注点
每个 /team-intake 结束后由 product-manager 或 tech-lead 刷新。
# Requirements — {slug}
## 用户故事
- US-001: 作为…我希望…以便…
- AC: 验收标准 1, 2, 3
## 功能需求
| ID | 需求 | 优先级 | 状态 |
|----|------|--------|------|
## 非功能需求
| 维度 | 目标 | 验证方式 |
## 约束
- 技术约束
- 业务约束
- 时间约束
里程碑粒度的阶段划分，由 project-manager 维护。
# Roadmap — {slug}
## 当前阶段
Phase N: {name} — {status}
## 阶段划分
| Phase | 名称 | 关键产出 | 完成标准 | 状态 |
|-------|------|----------|----------|------|
## 依赖图
Phase 1 → Phase 2 → Phase 3
↘ Phase 2b ↗
频率最高，每个 /team-execute、/team-review、/pause 后刷新。
# State — {slug}
## 最后更新
{ISO timestamp} by {role}
## 当前焦点
当前正在推进的工作项。
## 决策日志（最近 10 条）
| # | 日期 | 决策 | 原因 | 影响 |
|---|------|------|------|------|
## 阻塞项
| 阻塞 | Owner | 状态 |
## 进度快照
| 工作项 | 状态 | 负责角色 | 备注 |
## 下一步
1. ...
2. ...
| 文档 | 上限 | 占上下文比例 | 更新频率 |
|---|---|---|---|
| PROJECT.md | 3000 tokens | ~1.5% | 极低 |
| REQUIREMENTS.md | 5000 tokens | ~2.5% | 低 |
| ROADMAP.md | 3000 tokens | ~1.5% | 低 |
| STATE.md | 4000 tokens | ~2% | 高 |
| 合计 | 15000 tokens | ~7.5% | — |
docs/memory/decisions.md。[DONE] 后迁移到 docs/artifacts/{slug}/requirements-archive.md。| 命令 / 事件 | 写入文档 | 操作 |
|---|---|---|
/team-intake 完成 | PROJECT.md, REQUIREMENTS.md | 创建或刷新 |
/team-plan 完成 | ROADMAP.md, STATE.md | 创建或刷新 |
/team-execute 每步完成 | STATE.md | 更新进度和决策 |
/team-review 完成 | STATE.md | 更新放行结论 |
/pause | STATE.md | 写入暂停快照 |
/resume | — | 读取全部四层作为恢复上下文 |
| 角色 handoff | STATE.md | 追加交接记录 |
Agent 启动时加载顺序：
1. PROJECT.md → 建立背景
2. ROADMAP.md → 确认阶段
3. STATE.md → 获取当前焦点和阻塞
4. REQUIREMENTS.md → 按需参考（仅在需求相关任务时）
| context-engineering 文档 | Team Skills Platform 既有产物 | 关系 |
|---|---|---|
| PROJECT.md | PRD 背景/约束 + Delivery Plan 版本目标 | 精简聚合 |
| REQUIREMENTS.md | PRD 用户故事/验收标准 | token 受控子集 |
| ROADMAP.md | Delivery Plan 工作拆解 | 阶段视图 |
| STATE.md | Execute Log + docs/memory/decisions.md | 运行时快照 |
docs/memory/decisions.md 双向同步。[DONE] 标记或已归档/resume 能在 < 15s 内加载全部四层并展示当前焦点上下文优化技能，通过 trigger-based 懒加载和 context composition awareness 自动重组长会话上下文。
Goal-oriented autonomous loop with external completion oracle. Keeps iterating until verifiable stopping conditions are met, checked by a separate model.
Scheduled discovery automation that runs scans on a heartbeat interval, classifies findings, and routes them to goals or triage inbox.
Active MCP connector polling that integrates external tools (issue trackers, error monitoring, CI) into the heartbeat loop for cross-system discovery.
Structured rework with git blame attribution for failed goal iterations. Maps failures to responsible changes and routes targeted fix briefs.
将 CodeGraph 作为默认内置 MCP-backed 代码图谱能力接入，用于 brownfield 符号搜索、 调用链、影响面和上下文查询。输出必须回落到 `/team-*` 主链和 artifacts。