用途：session-loop 是面向多日项目的暂停/恢复工具包，配合智能体助手（Claude Code、Codex 等）使用。它不替代项目账本，而是围绕账本提供会话交接的脚手架，解决跨会话时上下文丢失、决策重复争论和隐性漂移问题。
主要能力：提供七个子流程。结束会话用 /session-wrap；开始或恢复用 /session-catchup；会话中途轻量保存用 /session-checkpoint；核对现实与账本是否一致用 /session-drift；记录 ADR 式决策用 /session-decide；扫描未解决事项用 /session-open-loops；压缩前持久化状态用 /session-compact-check。每个子文件自包含，按意图加载对应文件。
使用方式：安装命令为 npx skills add akshayrao14/session-loop，会安装到对应智能体的 skills 目录（Codex ~/.codex/skills、Claude Code ~/.claude/skills 或 ~/.agents/skills），之后需重启会话。可用触发短语路由，如“Let's wrap up”“Pick up where we left off”“Save my place”“Check the world”“Log this decision”“What's still open”“Compact now”等；无明确斜杠形式时按意图分派。
共享产物约定：项目根目录使用三个文件。NEXT_SESSION.md 为临时文件，每次 wrap 和 checkpoint 覆盖写入，由 catchup 消费；DECISIONS.md 或项目已有账本为追加式，不追溯编辑，用新日期条目取代；UPDATES.md 为追加式叙述，最新在上并带日期。文件缺失不会硬失败，三者齐备时最有用。子流程会按顺序查找已有账本：DECISIONS.md、MIGRATION_LEDGER.md、PROJECT_LOG.md、ADR.md 或 docs/adr/，以及前 50 行同时含“append”与“ledger/ADR/decision”的顶层 md 文件，首个匹配生效，否则默认写入 DECISIONS.md，并在输出中报告所选路径。
设计原则：追加式，决策与叙述不追溯编辑；幂等，重复运行不产生重复条目；验证而非轻信，交接包含可复跑的验证命令；拒绝危险停止，工作树存在未提交密钥、半应用 IaC 或孤立云资源时 /session-wrap 拒绝写入，除非使用 --force；暴露漂移，catchup 与 drift 会重跑验证命令并优先报告分歧；与已有约定组合，已有账本时追加而不另建。
限制：资料未提供具体定价、平台支持范围或效果数据。该工具依赖智能体会话与项目账本约定，子流程不会在文件缺失时硬失败，但最有用的情况是三份文件齐备。版本方面所有子流程同步发布，变更日志见 README.md。