swain-session 是 swain 项目中的会话管理与项目状态仪表盘技能，负责会话身份、偏好设置及跨智能体会话的上下文连续性。它不绑定特定智能体，依赖 AGENTS.md 实现自动调用。
用途与自动运行：会话开始时自动触发，恢复标签名（运行标签命名脚本）、读取 session.json 并应用偏好、显示上一次会话留下的上下文书签。手动调用时可更改偏好或为上下文添加书签。操作者用自由文本启动时，启动器导出 SWAIN_PURPOSE 并可能内联传递会话目的；问候脚本 swain-session-greeting.sh 读取该变量并确定性写入书签。
主要能力：预检脚本一次性收集全部会话状态；问候脚本输出结构化 JSON（分支、脏状态、书签、聚焦、标签、警告）；工作树与分支切换后可重跑 bootstrap 更新标签名；会话生命周期为 start→work→close→resume，状态存于 .agents/session-state.json，支持决策预算（默认 5，可 --budget 7）与决策记录；书籍签写/清、标签重命名、会话信息查看、偏好设置等手动操作；聚焦泳道可按 Vision/Initiative 名称解析为 ID 并设置或清除；状态仪表盘按需响应 status、what's next、dashboard 等指令。
关闭流程：依次生成会话摘要与进度日志、在会话仍活跃时运行 retro、调用 close 写入结束时间与 walkaway、运行 teardown（孤儿工作树检查、git 脏状态检查、工单同步提示、写交接摘要），最后提交 SESSION-ROADMAP.md。
适用场景：需要跨智能体会话保持上下文连续、记录决策、跟踪项目状态与聚焦范围的开发工作流。限制：依赖 tmux 提供标签与面板功能，未安装时会提示安装，未在 tmux 会话中相关功能不可用；需要仓库内存在 .agents/bin 下的相关脚本；README 对账在无 README 时静默跳过，延迟项记录在 session.json 的 readme_deferrals 下并下次会话重启时再次提出。