用途:Squad 智能体运行在 Copilot CLI 会话中,可能因终端崩溃、网络中断、机器重启或误关窗口而中断,导致分支存在未提交改动、issue 标记为进行中却无活跃智能体、检查点未完成。本技能教智能体查询 session_store 以检测并恢复这些会话。
主要能力:session_store 是只读 SQLite 数据库,通过 sql 工具以 database: "session_store" 访问。可查询 sessions 表按时间窗口找最近会话并带出最后检查点;可过滤掉 keep-alive、heartbeat 等自动化会话;可用 search_index FTS5 表做关键词搜索(需用同义词扩展,非语义搜索);可按工作目录搜索;恢复前可查看 turns、checkpoints、session_files、session_refs 了解会话上下文;可检测遗留的 issue 工作,并与 gh issue list --label "status:in-progress" 交叉比对。
使用方式:先定位会话 ID,再执行 copilot --resume SESSION_ID 恢复。
限制与注意:始终使用完整 UUID,不要用部分 ID;不要恢复已成功完成的会话;MATCH 中特殊字符需转义,路径用双引号包裹;不要跳过自动化会话过滤,否则结果会被淹没;FTS5 是关键词搜索而非语义搜索;不要忽略检查点数据。