用途
close-session 是一个系统级收尾技能,用途是在会话或项目结束时保存进度、更新记忆、重新生成导航,并确保系统完整性。资料将其称为“最重要的系统技能”(the most critical system skill),强调它确保“没有任何东西丢失”。
触发条件
资料称该技能会在用户说出 "done"、"finish"、"complete"、"close"、"wrap up"、"end session" 等词语,或任何系统技能、项目完成时加载。此外它被声明为“AUTO-TRIGGERED by all other skills and projects”,即不依赖用户手动触发。
主要能力
根据资料,close-session 的具体能力包括:
- 从 steps.md 的复选框读取和更新项目进度
- 校验 workspace-map.md 的准确性(自动检测不匹配)
- 用决策和模式更新记忆
- 清理根目录中的临时文件
- 创建历史会话报告
- 显示综合摘要
任务完成方面,资料描述其支持自动与交互式两种方式:若本会话完成了项目工作则自动批量完成;若自动检测遗漏,则在检查阶段提供批量完成选项;会显示前 10 个未勾选任务供手动选择,用户可按编号(如 "1, 3, 5")、"all"、"bulk complete" 或 "none" 选择,随后自动更新 tasks.md(通过 Edit 工具或 bulk-complete 脚本),并在任何变更后重新计算进度。
临时文件清理方面,它会扫描根目录中的临时文件,逐个询问保留、删除或跳过;保留的文件会移动到项目的 outputs/ 目录,并报告清理摘要。
会话报告方面,它在 01-memory/session-reports/ 下生成包含已完成工作、进度、决策和模式的报告,为下一次会话提供上下文。
进度追踪方面,它从复选框自动计算:统计总任务数(- [ ] 与 - [x])、已完成任务数(仅 - [x])、状态(PLANNING/IN_PROGRESS/COMPLETE),并识别下一个任务。
资料还说明它会被 create-project、validate-system 以及任何技能完成时自动调用。
使用方式
执行序列方面,资料要求:初始化 TodoWrite 并包含全部 10 个步骤(标注为 MANDATORY,防止跳过步骤)、加载 workflow.md、按序执行步骤 1 到 10、每完成一步就在 TodoWrite 中标记完成。
来自 workflow.md 的步骤列表包括:读取项目状态(无 IN_PROGRESS 项目时跳过)、检查任务完成(PLANNING 阶段跳过)、更新地图、获取时间戳、更新记忆、清理临时文件(删除不在系统文件夹中的 .md 文件)、创建会话报告、显示摘要(不超过 5 行)、标记完成、提示开启新会话。资料对步骤数量的表述不一致(一处称 10 步,一处称 9 步,集成部分又提到 Step 2/2.5)。
调用格式方面,由其他技能自动触发时输出 “Auto-triggering close-session skill...”,执行完整流程后显示 “Session saved! ✅” 及摘要;用户触发(如说 "done for now")时输出 “Closing your session...”,流程相同。资料还建议所有技能与项目工作流都以“Final Step: Close Session”结尾。
与 bulk-complete 的集成方面,资料称步骤 2 与 2.5 会在项目工作完成时自动运行 bulk-complete,命令示例为: python 00-system/skills/bulk-complete/scripts/bulk-complete.py --project [ID] --all --no-confirm 详细选项与测试覆盖需参见 bulk-complete/SKILL.md。
关键规则与错误处理
资料列出的关键规则包括:TodoWrite 强制初始化全部 10 步;PLANNING 阶段项目跳过任务完成(Step 2/2.5);IN_PROGRESS 阶段项目若检测到执行信号则自动完成;会话报告创建于 01-memory/session-reports/;摘要显示不超过 5 行(依据 orchestrator.md 规则)。
错误场景包括:无活动项目则跳过项目步骤并继续地图与清理;缺少 tasks.md 则在摘要中报告并建议 validate-system;记忆损坏则从扫描重建并报告问题;地图生成失败则保留旧地图、报告错误并建议重试;用户不响应则临时文件默认按“skip”处理。完整错误场景需参见 error-handling.md。
适用场景与限制
该技能面向使用 Nexus 类工作流、以 steps.md、tasks.md、workspace-map.md、01-memory/ 等文件组织上下文的项目环境。资料强调不运行它会导致进度更新丢失、导航地图过期、无历史记录、临时文件堆积。
限制方面,资料未提供关于平台支持、依赖环境版本、收费方式、安装步骤或性能效果的明确信息,这些内容暂未提供。资料中出现的文件路径(如 workflow.md、error-handling.md、bulk-complete/SKILL.md)与命令均为原文引用,未在本条目中给出可独立验证的完整安装与使用说明。