用途:当用户要求记录当前进展、补记需求、说明“还没开始/先记一下/被 fix 打断/稍后继续”、整理恢复入口,或需把自然语言进展沉淀为项目任务状态时使用。不用于直接实现完整 feature、代替 bug 修复或 debug、只做配置状态诊断。
主要能力:先确认项目根目录 .codex/tasks/ 与 .codex/tasks/archived/ 可用,目录缺失时优先初始化;即使目录已存在,也须确认当前会话对项目根目录可写。识别消息中的任务主体,一段话含多个任务时拆成多条状态。状态包括需求中、待开始、进行中、被打断、阻塞中、待恢复、已完成、已取消。已有主线任务时,短期插入的 fix 或调查优先在主线“中断记录”补 checkpoint;范围独立、可能跨多轮的插入任务才单独建文件。用户明确说“还没开始”“先别写代码”时只能落为需求中或待开始。更新任务文件至少补齐“当前结论”“未开始/被打断/阻塞原因”“恢复入口”“下一步”等字段。任务结束后移动到 .codex/tasks/archived/。
使用方式:按上述规则识别、判断状态并写入或更新任务文件;若项目内初始化或写入命中权限边界,优先走平台原生审批提示;审批后仍不可写才说明约束,并明确是否回退到 ~/.codex/tasks/ 继续持久化。
协作约束:需要完整实现 feature 转交 new-feature;修 bug 或 debug 转交 fix;查看任务盘点或配置状态转交 cc-status;涉及接口新增、分页、筛选、详情或响应格式判断时遵循 cc-api-contract-safety。
输出要求:列出识别出的任务主体与状态,区分“当前主线”“候选任务”“插入任务”,说明本次是新建、更新、归档任务还是只补 checkpoint;若发生目录回退,说明是目录缺失已初始化、项目目录确实不可写,还是当前会话受限导致写入被拦截;信息不足时先说明缺口,不臆测已开工。
限制:资料未提供具体安装命令、平台支持范围、收费方式与效果数据;状态模型与抽取规则见 references/state-model.md 与 references/capture-rules.md。