用途:当用户明确要求开发新功能、完整推进一个 feature,或提到 new-feature、恢复未完成任务时使用。若只想补记需求、登记进展或标记稍后继续,应优先使用 cc-task-state。不适用于小范围 bug 修复、纯需求或设计文档、一次性代码评审。
主要能力:本技能是用户显式调用的完整工作流,拥有从需求到实现的全流程控制权。执行期间禁止调用会接管设计或实现流程的外部 skill;设计文档必须写入 .codex/tasks/。流程包括:初始化任务目录、归档已完成任务、检查未完成任务并优先续做、开工前判断任务状态、进入实现前做 3-5 个关键澄清问题、产出实现范围与步骤计划、按步骤实现并逐步更新状态、完成后自查并归档。
使用方式:运行开始先在项目根目录确保 .codex/tasks/ 与 .codex/tasks/archived/ 存在,缺失时执行 mkdir -p .codex/tasks/archived。检查根目录中已完成任务并移动到 archived/,检查未完成任务时忽略 archived/。使用 templates/task.md 持久化状态,优先写入项目内 .codex/tasks/;若项目目录确认不可写,才允许回退到 ~/.codex/tasks/。任务状态需与进度一致:未开工保持需求中或待开始,确认实现后切换为进行中,完成后标记已完成并归档。
适用场景:显式新功能开发、从需求到实现的一站式推进、恢复未完成任务。
限制:同一时刻只应有一个主任务处于进行中;接口或联调工作需记录契约确认和临时兼容退出条件;语言和框架细节交给对应语言 skills;完成后需说明残余风险和后续建议。恢复策略、编排方式和任务模板见对应 references 与 templates 文件。