CocoSession 是 CocoPlus 长时运行工作的连续性与操作员控制层技能，目标是让每个 CocoFlow 或长时运行的操作员会话都能仅凭文件恢复。
用途 用于管理多会话连续性、迭代与成本预算、终端状态、操作员急停开关、一次性指令注入和谓词上下文。它面向需要跨多轮持续执行、并可能在途中被操作员干预或中止的工作流。
主要能力 命令方面提供：$session status 读取 .cocoplus/session/PROGRESS.md、CONTEXT.md、iteration-budget.json、budget-state.json、status.json、.cocoplus/pod-state.json、.cocoplus/AGENT_STOP 和 .cocoplus/STEER.md，报告交接新鲜度、活跃谓词状态、排队工作数、迭代预算、成本预算状态、终端状态、急停开关状态和待处理指令；$session progress 显示 PROGRESS.md 的 Done、In Progress、Next、Notes 四个交接段落；$session steer "<instruction>" 把指令写入 .cocoplus/STEER.md，由 UserPromptSubmit 钩子注入一次并记录会话事件后清空文件；$session stop 创建带时间戳、操作员和原因的 .cocoplus/AGENT_STOP，PreToolUse 钩子在哨兵文件存在时阻止工具使用；$session resume 在确认操作员意图后删除 .cocoplus/AGENT_STOP。
连续性契约 PROGRESS.md 是人工交接文档；CONTEXT.md 是以 CLASS.key=value 形式、可机器 grep 的谓词状态；task-queue.jsonl 记录会话中途请求而不替换当前活动项；新工作排入 Next，除非操作员明确更改当前项；iteration-budget.json 跟踪上限、已消耗轮次、警告阈值和停止状态；budget-state.json 跟踪 normal、reserve、exhausted 三种成本预算状态，预算检查仅在阶段边界进行，进行中的阶段不会被打断；status.json 与 pod-state.json 使用规范状态词汇：running、paused、completed、exited、failed、idle、retired。恢复任何长时工作前应先读 PROGRESS.md，引用 CONTEXT.md 谓词时需逐字引用，不得改写为新状态。
迭代预算 cocoplus.toml 的 [session] 配置控制 max_iterations = 200、iteration_warn_at = 160、budget_limit = 0.0、budget_reserve_fraction = 0.10、budget_enforcement = "stage-boundary"。PostToolUse 钩子递增已消耗计数；达到警告阈值时在 session/steps.jsonl 记录主动检查点请求；达到上限时创建 .cocoplus/AGENT_STOP 并写入最终预算状态，以便操作员获得干净交接而非耗尽上下文窗口。当设置了 budget_limit 且 budget_enforcement = "stage-boundary" 时，成本执行基于接缝，预留比例用于收尾工作（最终质量审查、控制台状态更新、交接说明）。预算停止记为 exited 而非 failed，除非由执行错误导致。PROGRESS.md 需包含 Iteration Budget 段落，列出 Cap、Consumed、Warn At。
ctx 补充 当 ctx 可用时，CocoSession 可读取 cortex ctx show all 作为 PROGRESS.md 的补充：task-list 状态中的 ctx 任务映射为 In Progress，ctx ready 步骤映射为 Next，ctx discoveries 映射为会话上下文补充。硬性约束：切勿在 CocoPlus 生产工作流中设置 CTX_DIR，它会改变 process.cwd() 并可能破坏 CocoPod 相对路径；为 CocoFlow 阶段执行设置 CTX_STEP_ENFORCEMENT=false，以免 ctx 门与 CocoFlow 门冲突；若 ctx 与 CocoFlow 对活动任务的判断不一致，以 CocoFlow 为准。
退出标准 PROGRESS.md 包含 Done / In Progress / Next / Notes 段落；长时工作活跃时包含 Iteration Budget；成本预算状态区分 normal、reserve、exhausted；终端状态使用规范词汇且不把 exited 归入 failed；CONTEXT.md 每行一个谓词；急停开关与指令文件被视为操作员控制而非永久指令。
限制 该技能依赖 .cocoplus 目录下特定文件与钩子协作，ctx 为可选补充；具体安装方式与平台支持暂未提供。