메뉴
会话记忆固化 skill (v9.8.0 新). 会话结束/中途, agent 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot hook 互补 (hook 机械兜底, skill 做需推理的总结).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Athena 全局首次配置 (跨项目, 一次性). 从分发包部署 settings/config/rules/standards/hooks/agents/skills 到 ~/.claude/ (CC) 与 ~/.codex/ (CX). 和 athena-init 区别: setup 全局一次性, init 每项目一次. 已装则转 verify/upgrade (走 athena-migrate).
Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 铁律引用名称化 (CC/CX 编号非对称, 引用一律用 铁律[名称]).
Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.
Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.
Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).
维护 .ai_state/requirements/ 长效需求档 (软件要素: 为什么要这个能力). 原始用户故事 + 当时权衡, 独立于会演化的 design.md —— 代码烂掉时弃码重生的逃生通道. 借 CodeStable requirements 实体, 适配 agent-in-loop: 需求落盘可召回, 隐知识不丢.
| name | athena-checkpoint |
| description | 会话记忆固化 skill (v9.8.0 新). 会话结束/中途, agent 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot hook 互补 (hook 机械兜底, skill 做需推理的总结). |
| effort | medium |
每次会话要结束, 你都得手动描述一堆 "现在做到哪、下次接着干啥", 让 Athena 存进 .ai_state. 本 skill 把这个动作做成一键: agent 自己回顾本会话、提炼增量、落进工程, 你只需确认。
/athena-checkpoint / "存一下进展" / "记录到 ai_state" / "收尾"ts=$(date +%Y-%m-%d-%H%M%S)
cp .ai_state/_index.md ".ai_state/.snapshots/pre-checkpoint-${ts}.md"
与 compact-snapshot hook 同机制的手动版. 改坏了能回滚。
主 agent 回顾本会话 (不是整个项目历史), 提炼三块:
_index.md frontmatter: 校正 stage / path / next_action / current_sprint_slug / last_critic_round 等字段, 确保与实际一致 (hook 自动维护的字段也复核一遍)sprints/{slug}/session-log.md: 追加本会话日志段 (见格式)向用户回显:
✓ checkpoint 已存 ({ts})
stage: impl path: System sprint: 2026-06-22-xxx
next_action: runtime-verify (T4-T6 单测已过, 待实跑)
下次接续: 跑 /athena-runtime-verify 验 /api/refresh 的并发场景
快照: .snapshots/pre-checkpoint-{ts}.md
你扫一眼确认, 不对当场说, agent 改。
# Session Log — {slug}
## 2026-06-22 14:30 (checkpoint)
- 做了: plan 4 轮 critic PASS → impl T1-T6 写完, 单测过; runtime-verify T4 并发场景卡住
- 状态: stage=impl, next_action=runtime-verify
- 决策: 并发刷新用乐观锁 (见 compound/2026-06-22-decision-refresh-lock.md)
- 下次接续: /athena-runtime-verify 复跑并发用例, 过了进 review
- blocker: 无
## 2026-06-21 ...
[更早的会话, 倒序追加]
| compact-snapshot hook | athena-checkpoint skill (本) | |
|---|---|---|
| 触发 | PreCompact 自动 | 用户手动 /checkpoint |
| 能力 | 机械复制 _index.md → .snapshots/ | agent 推理总结本会话增量 |
| 写什么 | 原样快照 | _index 校正 + session-log 日志 + 接续点 |
| 场景 | compact 兜底 (防丢) | 会话结束主动固化 (给下次用) |
hook 是"防丢的保险", skill 是"主动留交接". hook 触发不了需要推理的总结 — 那是本 skill 的活。
| /checkpoint (本) | /compound | |
|---|---|---|
| 存什么 | 本会话状态 + 接续点 (短期, 给下次接续) | 跨 sprint 经验 (长期, learning/trick/decision) |
| 范围 | 当前 sprint 进展 | 项目级复利知识 |
| 频率 | 每次会话收尾 | 踩坑/优雅模式/决策时 |
checkpoint 是"我做到哪了", compound 是"我学到了啥". 不混。