用途:为智能体完成复杂编程任务生成结构化计划,明确意图、范围、需求、行动项、测试/验证与风险;也可用于撰写代码库或系统概览。
主要能力:支持查找/列出、读取、创建、更新、删除计划;创建时只读扫描仓库上下文(README、docs/、CONTRIBUTING.md、ARCHITECTURE.md 等),识别约束后起草实现计划或概览计划。计划可保存为 Markdown 文件,磁盘计划需带仅含 name 与 description 的 YAML frontmatter,命名须短小、小写、连字符分隔,文件名等于 <name>.md。
使用方式:计划目录为 $CODEX_HOME/plans,未设置 CODEX_HOME 时用 ~/.codex/plans,不存在则创建。仅写入该目录,绝不修改仓库代码。在聊天中起草时只输出正文(从 # Plan 开始,不含 frontmatter);保存时再前置 frontmatter。可用脚本:python ./scripts/create_plan.py --name codex-rate-limit-overview --description "Scope and update plan for Codex rate limiting" --body-file /tmp/plan-body.md;python ./scripts/read_plan_frontmatter.py ~/.codex/plans/codex-rate-limit-overview.md;python ./scripts/list_plans.py --query "rate limit"。
限制:仅读取仓库以理解上下文,不写入仓库;未找到计划时需明确说明并提供创建选项;更新时保持计划名稳定,重命名需同时改 frontmatter 与文件名;实现计划须包含测试/验证与风险/边界情况,开放问题最多 3 个;避免模糊步骤、微步骤与代码片段,保持实现无关。其他收费、平台与效果信息暂未提供。