菜单
Codex 的持久化任务管理技能。任务跨多个文件、需要拆分、可能中断、需要恢复、需要显式注册和过程记录时使用。它通过 `.codex/plans/{branch}/TASKS.md` 与 `process.md` 管理任务生命周期，并提供断点恢复、研究发现、错误记录和状态同步规则。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | task-control |
| description | Codex 的持久化任务管理技能。任务跨多个文件、需要拆分、可能中断、需要恢复、需要显式注册和过程记录时使用。它通过 `.codex/plans/{branch}/TASKS.md` 与 `process.md` 管理任务生命周期，并提供断点恢复、研究发现、错误记录和状态同步规则。 |
管理长任务生命周期：注册、拆分、暂停、恢复、取消、完成。
所有任务数据按分支隔离，默认使用：.codex/plans/{branch}/。
每次操作前执行：
main.codex/plans/{branch}/ 是否存在，不存在则创建.codex/plans/{branch}/TASKS.md 是否存在，不存在则初始化建议初始化内容：
# 任务清单
<!-- 暂无任务 -->
满足任一条件即注册：
以下情况可以跳过：
每个任务建议记录：
推荐格式：
# 任务清单
## [任务名称]
- 状态：进行中
- 摘要：[任务简述]
- 过程文件：.codex/plans/{branch}/{task}/process.md
- 恢复提示：读取 process.md，然后从 [~] 步骤继续。
每个任务一个 process.md。
最少包含以下部分：
必须放在文件顶部，且每次写断点时同步更新。建议字段：
使用统一状态标记：
[ ] 未开始[~] 进行中 / 断点[v] 已完成[x] 已取消断点步骤必须包含：
记录执行过程中发现的重要信息，避免恢复后重复探索。
记录失败尝试和结果，避免重复踩坑。
TASKS.mdprocess.md[~] 步骤中的“下一步”TASKS.md 中把任务标记为暂停process.md 中把当前步骤标记为 [~]TASKS.md 中移除，并删除或归档任务目录TASKS.md 中移除任务需要判断、确认或切换产出形态时拆分子任务，例如：
纯执行型连续步骤可以不拆。
当长任务被拆给子代理时，task-control 仍应由主代理维护主记录，不能因为子代理存在就跳过持久化。
建议额外记录：
如果任务已经注册，派发子代理前至少做到：
process.md 中写明当前进入哪个子任务阶段。process.md 的“研究发现”“步骤列表”或“下一步”。常见异常处理建议：
process.md 格式损坏：尽量按现有信息恢复，无法恢复时提示用户确认状态TASKS.md 与实际目录不一致：以文件系统为准修正Codex 的设计阶段技能。需要根据 requirements 文档产出技术设计、明确实现方案、拆分关键模块、梳理依赖和风险，并把结果写入 `docs/codex/{version}/designs/` 时使用。它应与 `project-skill-convention` 配合，并在完成后回写 `status.md`。
Codex 的项目开发约束技能。涉及代码修改、代码阅读、业务上下文建立、文档编辑、查询代码逻辑、多文件实现时使用。它会约束任务启动、文档优先级、工作区与正式区的使用方式、代码变更后的文档同步，以及对外变更时的确认规则。
Codex 的基础设施只读查询技能。适用于查看数据库表结构、索引、ES mapping、ES 文档、Nacos 配置，以及追踪服务依赖的中间件连接信息。当任务涉及“查配置”“查索引”“查表结构”“查数据库”“DESC”“nacos”“mapping”“文档数”等场景时优先使用，核心原则是不猜，直接查。
Codex 的业务域文档生成技能。适用于为 Java 项目初始化或补充 `docs/desc/` 业务域文档、建立领域上下文、生成技术速查和域文档骨架。当项目缺少业务域文档、需要建立知识库或需要补齐某个业务域说明时使用。
Codex 的计划阶段技能。需要根据 design 文档拆解实施步骤、确定执行顺序、验证依赖、形成可执行计划，并把结果写入 `docs/codex/{version}/plans/` 时使用。它应与 `project-skill-convention` 配合，并在完成后回写 `status.md`。
Codex 的项目入口技能。适用于进入一个项目后的大多数任务起点，包括代码修改、缺陷修复、代码阅读、需求分析、技术设计、执行计划、实现推进、闭环追踪、基础设施查询、业务文档沉淀和长任务恢复。它负责根据任务意图自动选择并串联 `dev-constraints`、`task-control`、`project-skill-convention`、`req-analysis`、`design-phase`、`plan-phase`、`req-trace`、`dev-small-tool`、`docs-desc-generation` 等技能，作为整套 Codex 项目工作流的统一入口。