用途:在 leader agent 工作流开始时开启一个新的上下文会话,记录 token 用量、agent 身份与 story 上下文,供多 agent 工作流中的 worker 通过配套的 session-inherit 技能继承。会话跟踪属于遥测,绝不能阻塞或门控工作流;若无法创建会话(数据库不可用、返回 null),leader 发出警告并正常继续。
主要能力:调用 mcp__postgres-knowledgebase__sessionCreate,传入 agentName、storyId、phase;记录返回的 session_id 并输出结构化 SESSION CREATED 块;优雅处理 null 返回,输出 SESSION UNAVAILABLE 并继续。
使用方式:/session-create 在 leader 工作流开始时调用;/session-create storyId=WINT-1234 phase=execute 可带 story 与 phase 上下文。参数中 agentName 必填(默认当前 agent 名),storyId、phase、sessionId 可选,sessionId 省略时自动生成 UUID。SessionCreateInput 还支持 inputTokens、outputTokens、cachedTokens(默认 0)与 startedAt(默认 now())。
输出:成功时输出 SESSION CREATED 块,含 session_id、agent、story_id、phase,session_id 行需匹配正则 /SESSION CREATED\n\s+session_id:\s+([0-9a-f-]{36})/;null 返回时输出 SESSION UNAVAILABLE — continuing without session tracking 并继续,不阻塞、不重试、不报错。
会话生命周期:leader 开启(session-create → sessionCreate → 输出 SESSION CREATED);worker 继承(session-inherit → sessionQuery(activeOnly: true) → 输出 SESSION INHERITED);worker 更新 token(sessionUpdate({ sessionId, mode: 'incremental', inputTokens, outputTokens }));仅开启会话的 leader 调用 sessionComplete;定期清理 sessionCleanup({ retentionDays: 90 }) 归档旧会话。worker 不得调用 sessionComplete。
限制:数据库连接不可用、sessionCreate 返回 null、MCP 工具不可用或网络超时等情况均只记录警告并继续,leader 的下游工作(计划执行、文件写入、代码生成)不受会话状态影响。session_id 应通过 prompt 上下文传给派生的 worker;worker 使用 sessionQuery({ activeOnly: true, limit: 50 }) 并在客户端过滤,不直接接收 sessionId 过滤。其余细节暂未提供。