Codex 用例
创建 Codex 可用的 CLI
为 Codex 提供一个可组合的命令，用于 API、日志源、导出或团队脚本。
让 Codex 创建一个可组合的 CLI，使其能从任何文件夹运行、与仓库脚本结合使用、用于下载文件，并通过配套技能记住这些操作。
适用场景
- 当 Codex 需要重复搜索、读取、下载或安全写入同一服务、导出、本地归档或仓库脚本时。
- 需要分页搜索、按 ID 精确读取、可预测的 JSON、下载文件、本地索引或写入前先起草等操作的智能体工具。
目录
创建 Codex 可用的 CLI
为 Codex 提供一个可组合的命令，用于 API、日志源、导出或团队脚本。
让 Codex 创建一个可组合的 CLI，使其能从任何文件夹运行、与仓库脚本结合使用、用于下载文件，并通过配套技能记住这些操作。
技能与插件
- 设计命令接口，构建 CLI，添加设置和身份验证检查，将命令安装到 PATH，并从其他文件夹进行验证。
- 创建配套技能，指导后续的 Codex 任务应首先运行哪些 CLI 命令，以及哪些写入操作需要批准。
起始提示词
简介
当 Codex 持续使用同一 API、日志源、导出的收件箱、本地数据库或团队脚本时，请为该工作提供一个可组合的接口：一个可从任何文件夹运行、可检查、可缩小范围并可与 git, gh, rg、测试以及仓库脚本。
添加一项配套技能，记录 Codex 何时应使用该 CLI、首先运行什么、如何保持输出精简、下载文件存放的位置，以及哪些写入命令需要批准。
In this workflow, $cli-creator 帮助 Codex 构建命令。 $skill-creator 帮助 Codex 保存可复用的技能，例如 $ci-logs，以便未来的任务可以通过名称调用它们。
如何使用
选择 CLI 应执行的操作
从你希望 Codex 执行的操作开始，而不是你想让它编写的技术。优秀的 CLI 能将重复的读取、搜索、下载、导出、起草、上传、轮询或安全写入操作转化为 Codex 可从任何仓库运行的命令。
| 场景 | Codex 使用 CLI 可执行的操作 |
|---|---|
| CI 日志位于构建页面之后。 | 获取构建 URL，将失败任务的日志下载到 ./logs，并返回文件路径和简短的代码片段。 |
| 支持工单以每周导出的形式接收。 | 索引最新的 CSV 或 JSON 导出，按客户或短语搜索，并通过稳定 ID 读取单张工单。 |
| API 响应对于上下文而言过大。 | 仅列出所需字段，按 ID 读取完整对象，并将完整响应导出到文件。 |
| Slack 导出包含长线程。 | 使用以下条件进行搜索： --limit、读取一个线程，并返回相关上下文而非整个归档。 |
| 一个团队脚本运行四个不同的步骤。 | 将设置、发现、下载、起草、上传、轮询和实时写入拆分为独立的命令。 |
| 插件找到了记录，但 Codex 需要一个文件。 | 在线程中保留该插件；使用 CLI 下载附件、追踪记录、报告、视频或日志包，并返回路径。 |
分享文档、文件或命令
Codex 需要具体的内容来学习：文档或 OpenAPI、脱敏的 curl 命令、导出或数据库路径、日志文件夹或现有脚本。如果你希望 CLI 遵循熟悉的风格，请粘贴一段简短的 --help 输出来自 gh, kubectl，或者是你们团队自己的工具。
如果命令需要身份验证，请告诉 Codex 它应支持的环境变量名称、配置文件路径或登录流程。请在你自己的 Shell 或配置文件中设置密钥。切勿将密钥粘贴到线程中。要求 Codex 使 CLI 的设置检查在缺少身份验证时明确报错。
要求 Codex 构建 CLI 和技能
使用本页的起始提示词。填入 Codex 应从中学习的来源以及 CLI 应首先支持的任务。
在 Codex 编写代码之前，它应展示拟定的命令接口，并仅询问会阻碍构建的缺失细节。
验证命令在任何文件夹中均可工作
Codex 不应在以下步骤之后停止 cargo run, python path/to/script.py，或一个未安装的包命令。要求它从其他仓库或临时文件夹中测试已安装的命令，就像后续任务将使用它的方式一样。
像未来的智能体一样测试 CLI
如果 Codex 返回了一个巨大的 JSON 数据块，请让它缩小默认响应，并为完整负载添加文件导出。如果它忘记了审批边界，请让它在另一个线程中使用之前更新配套技能。
稍后使用该技能
当你再次需要 CLI 时，调用该技能，而不是再次粘贴文档：
对于重复性工作，在普通线程中测试一次该技能，然后让 Codex 将相同的调用转化为自动化。
