القائمة
在流水线阶段切换时执行上下文压缩，通过结构化快照保留关键信息，释放 token 空间，防止主线漂移。配合 context-compaction 规则使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
将后端技术方案拆解为接口、应用服务、领域/业务逻辑、数据访问、消息/定时任务、迁移脚本和测试任务时使用。用于补充通用 implementation-planning 的后端归组口径。
分析后端接口、数据库访问、RPC/HTTP 调用、批处理、消息消费、事务和缓存相关性能风险时使用。强调证据、数据规模、低风险优化和回滚方案。
前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
排查并修复前端渲染、状态、表单、表格、路由、API 映射、异步时序和性能回归问题时使用。要求可复现、可定位、可验证、最小修复。
在既有前端项目中新增或扩展页面、表单、列表、弹窗、批量操作、导入导出和权限交互时使用。强调先理解调用链、复用现有结构、最小改动落地。
| name | context-compaction |
| displayName | 战略性上下文压缩 |
| description | 在流水线阶段切换时执行上下文压缩，通过结构化快照保留关键信息，释放 token 空间，防止主线漂移。配合 context-compaction 规则使用。 |
| triggers | ["上下文压缩","压缩上下文","context compact","释放上下文","token 优化"] |
| autoTrigger | false |
| version | 1.0.2 |
在流水线阶段切换时，将当前上下文中的关键信息结构化保存为「上下文快照」，然后执行压缩（compact），再通过恢复检查确认信息无损。整个过程分三步：快照 → 压缩 → 验证。
检查 context-compaction 规则中的时机表：
按以下模板输出快照。所有字段必填，无对应内容时填写「无」。
# 上下文快照
> 生成时间：{当前时间}
> 触发节点：{如 B1→B2 切换}
## 任务标识
- 需求编号：{SV-xxxxx}
- 当前阶段：{如 B1 实施准备完成}
- 下一阶段：{如 B2 编码实施}
- 当前模式：{设计模式 / 编码模式}
## 任务契约摘要
- 目标：{一句话概括}
- 范围：{受影响的模块/层级}
- 允许写入路径：{路径列表}
- 禁止项：{约束列表}
- 验收标准：{关键验收条件}
## 关键决策记录
{列出本阶段做出的重要决策，包括方案选型、已确认的疑问答案、取舍理由}
1. {决策1}
2. {决策2}
3. ...
## 任务进度
### 已完成
- [ ] {已完成的任务项，含任务ID}
### 未完成
- [ ] {未完成的任务项，含任务ID和依赖关系}
## 待恢复文件
{压缩后如需回溯细节，应读取以下文件}
| 文件 | 用途 |
|------|------|
| docs/design/SV-xxxxx-tech-design.md | 技术方案（含架构设计、接口定义） |
| docs/delivery/SV-xxxxx-changelist.md | 变更清单（编码阶段增量记录） |
| AGENTS.md | 项目画像（技术栈、架构模式） |
| {其他相关文件} | {用途说明} |
## 下一步行动
{进入下一阶段后的第一个动作}
向用户展示快照摘要（不必展示完整模板，突出关键信息），并询问：
即将执行上下文压缩。以上快照包含了当前阶段的关键信息，压缩后将以此快照为恢复基础。
- 是否有需要补充的信息？
- 确认后将执行压缩。
用户确认后，使用 Cursor 的 compact 机制压缩对话上下文。压缩时将快照内容作为保留摘要的核心输入。
压缩完成后，立即执行以下自检：
| 检查项 | 验证方式 |
|---|---|
| 需求编号 | 能正确说出当前 SV-ID |
| 当前阶段 | 能正确说出当前处于哪个阶段 |
| 当前模式 | 能正确说出当前工作模式和写入边界 |
| 任务契约 | 能复述目标、范围、禁止项 |
| 未完成任务 | 能列出所有未完成的任务清单 |
| 关键文件路径 | 能说出技术方案和变更清单的文件路径 |
若任何必检项无法回答：
压缩完成后，向用户输出简要确认：
✅ 上下文压缩完成
- 需求编号：SV-xxxxx
- 当前阶段：{阶段}（{模式}）
- 未完成任务：{N} 项
- 恢复验证：全部通过
当用户在非标准时机主动要求压缩时：
通过 /code SV-ID 独立进入流水线 B 时，不存在需要压缩的历史上下文，跳过压缩直接执行 B0。
若短时间内（如 B0→B1→B2 连续切换）多次触发压缩建议，可合并为一次压缩，在到达最近的高优先级压缩点时统一执行。