测试命令刚交代过,换个任务又得重说;资料整理步骤复制了几遍,新的对话还是漏了一步。提示词继续加长之前,先看重复的究竟是项目约定、操作方法,还是缺少了可调用的工具。
Codex的扩展能力可以分成几层。本文只挑与日常复用最相关的部分,用一个虚构的资料整理任务说明如何选择,并在2026年10月26日核对了文末所列OpenAI官方文档。功能和权限仍以实际入口、账号与管理设置为准。
先分清“怎么做”和“能做什么”
项目希望怎样组织工作,可以用说明文件表达;能否读取某个目录、写入外部系统,则取决于执行环境和授权。把“不要删除原始资料”写进规则,是行为约定,真正的数据保护还要有备份、访问控制和可检查的操作记录。
按下面的分工找位置即可,暂时用不到的能力不必安装。
| 序号 | 放置位置 | 主要承载的内容 |
|---|---|---|
| 1 | config(配置) | 运行默认设置,修改前核对生效范围 |
| 2 | AGENTS.md(项目说明) | 项目常用约定、检查要求和目录边界 |
| 3 | Skill(技能) | 可复用流程及需要的脚本、参考材料 |
| 4 | MCP(模型上下文协议) | 连接可用的外部资料与工具 |
需要程序触发任务或分发给团队时,还可能涉及软件开发工具包、插件或其他协作机制。这里先不展开,也不要求为了整理几份文件一次装齐。
长期约定写短,放在适用的项目范围
假设你要让Codex整理练习目录中的公开资料,可以约定:保留原件、生成结果放在指定目录、输出差异清单、报告哪些文件没有读全。它们比“认真工作、保证质量”更容易核对。具体目录与检查命令应来自当前项目,不能照抄别人的配置。
官方文档说明,AGENTS.md可以按全局和项目目录形成指导链。实际加载与作用范围需要核对,重要约定也应搭配可执行的检查。文件里写了要求,不代表每一次任务都已经遵守。可让当前任务列出采用的依据,再检查实际产物。
重复流程形成技能,先写清输入与结束条件
若每周都要整理同类资料,可以把确认输入、读取来源、整理内容、检查差异和保存结果写成技能。技能通常以SKILL.md(技能说明文件)为入口,也可以附脚本和参考资料。长期约定告诉它要遵守什么,技能则描述这一类任务如何完成。
例如,公开资料整理技能可以要求先记录来源与日期,再输出内容和缺失项,最后回读生成文件。遇到来源无法读取时,保存缺口,而不是用记忆补成最新版本。新流程先在练习副本验证,不直接拿正式资料试错。
缺少外部资料时,再判断是否需要连接
如果任务只处理已提供的文件,未必需要MCP。需要查询团队工具时,应先核对服务来源、账号范围和实际工具列表。能查询记录与能修改记录是不同能力,先做获准的只读核对更容易看清数据边界。
一个具体例子是OpenAI官方文档MCP:它提供文档搜索和内容读取,不替你调用模型API。连接名称相同,也不能推断所有服务都有相同权限。安装成功、连接成功和业务结果正确,仍需分别检查。
稳定后再考虑定时运行
先手动整理一份资料,回读输出,检查来源、路径、完整性和失败说明。换一份再做一次。如果方法还能复用,再安排定时,并写清如何识别重复任务、保存结果和处理失败。
自动运行后,应能看见本轮改了什么、依据是什么、检查到哪一步。定时触发不是完成证明,读取了资料也不是已经产生业务改善。涉及外部写入时,沿用已批准范围和系统本身的权限限制。
这句话下次应该放在哪里
找一句最近反复交代的话:是整个项目都要遵守,就放进项目说明;是某类任务的步骤,就整理成技能;若实际缺的是读取外部资料的能力,再查工具连接。先给这一个问题找到位置。
动配置之前,拿练习任务列出输入、输出、权限和检查结果。还没弄清少了哪一项能力,就先别增加扩展。
官方参考:Codex定制能力概览、AGENTS.md作用范围、技能说明、OpenAI官方文档MCP。以上用于核对概念与入口,不构成费用、账号权限或可用性的承诺。
转载请注明:三五二萌文网 » Codex总要重复交代?把项目约定、技能和工具分开放