Skill: Session_Checkpoint

触发指令

• 命令：/checkpoint
• 语义触发：用户提及“总结上下文”、“开个新窗”、“存档”等。

执行动作约束 (Agent Rules)

1. 停止生成：中止所有正在进行的代码编写或逻辑推理。
2. 全局扫描：深度回顾本会话的上下文，不仅提取代码改动，更要提取“隐藏的系统状态”和“未决定的业务选项”。
3. 拒绝幻觉：对于不确定的状态、未获取到的信息，必须明确标记为 [待确认]或 [缺失]，绝不允许自行捏造。
4. 覆盖写入：将生成的【全局状态快照】以 Markdown 格式，覆写（Overwrite）到项目根目录的 .project_state.md 文件中，禁止追加，确保文件唯一且精简。
5. 结束语：写入完成后，向用户输出：“✅ .project_state.md已保存。新会话使用 /resume 唤醒工作区。”

输出模板 (.project_state.md)

请严格按照以下 Markdown 格式生成快照文件内容：

项目状态快照 [Project State Snapshot]

存档时间：[YYYY-MM-DD HH:MM:SS]（用于校验存档新鲜度，判断 Token 等时效性凭证是否过期）

1. 核心里程碑 (Milestone Reached)

• 精炼概括当前会话达成了什么实质性进展（例如：完成了某个特定接口的签名逻辑封装、打通了某条数据流）。

2. 关键业务与架构上下文 (Architecture & Business Logic Context)

(详细记录当前所处环境的业务规则，这是新会话继承智商的核心)

• 集成与鉴权状态：当前对接的第三方服务/平台处于什么鉴权阶段？Token/Cookie 的刷新与生命周期管理机制是什么？
• 数据与状态流转：当前正在处理的核心数据结构是什么？数据的输入源和最终落库/输出目标是什么？
• 核心业务约束：当前模块必须遵循的关键规则有哪些？（例如：特定 API 的频率限制、接口重试的幂等性设计、批量操作的并发锁逻辑等）。
• 环境与代理配置：当前依赖的运行环境（如特定的沙箱环境、本地代理端口或全局环境变量）有何特殊要求？

3. 当前挂起状态与未决异常 (Pending States & Blockers)

(不仅限代码报错，涵盖所有阻碍推进的因素)

• 代码运行基线：当前代码库整体是否可编译/可运行？哪些文件处于逻辑中断状态？
• 代码级报错：如有未解决的 Exception、Error Log 或非预期的 API Response（保留关键 JSON 字段）。
• 工程级阻塞 (Blockers)：
  • 缺失的外部依赖（如：缺少某个接口的具体文档说明、第三方沙箱宕机）。
  • 待确认的业务逻辑（如：异常情况下是静默失败还是抛出重试策略？）。
  • 网络或环境异常。

4. 唤醒后首要任务与执行蓝图 (Next Action Items & Execution Blueprint)

(为新窗口设定极度明确的、可直接执行的启动指令。禁止使用“继续完善”、“修复问题”等模糊词汇，必须符合以下结构)

• 任务 1：[动作类型：如 编写/调试/重构/接口联调] [任务简述]

  • 精准定位：明确指出需要操作的具体文件路径、类名或核心函数名（例如：src/api/batch_sync.py 中的 create_campaign()）。
  • 具体操作指令：详细描述下一步到底要写什么逻辑。（例如：不要写“处理鉴权”，要写“在发起批量创建请求前，增加 Token 的生命周期检验逻辑。若 Token 离期小于 5 分钟，则先调用刷新接口”）。
  • 业务约束注入：该段代码必须遵守的特定规则（例如：确保该重试动作符合全局系统要求的幂等性，防止重复提交）。
  • 验收标准 (DoD)：新会话中的 AI 如何自行判断该任务已完成？（例如：即使传入临期 Token，系统也能静默刷新并返回 HTTP 200，且不产生重复数据）。

• 任务 2：(结构同上，无明确任务则留空，切勿凑数)

• 唤醒前置物料要求 (Required Inputs)

  • 为了顺利执行上述任务，需要用户在新窗口提供什么核心信息？（例如：“请在新会话开始时，提供一份最新的含签名 (Signature) 的测试请求 JSON”、“请确认批量处理失败时的死信队列配置”）。