概览
让 Codex 创建一个可组合的 CLI，使其可以从任意文件夹运行、与仓库脚本组合使用、用于下载文件，并通过配套 skill 记住它。
适合场景
- 适用于重复性工作：Codex 需要反复搜索、读取、下载，或安全地写入同一个服务、导出文件、本地归档或仓库脚本。
- 适用于需要分页搜索、按 ID 精确读取、稳定 JSON、下载文件、本地索引，或先生成草稿再写入命令的 agent 工具。
构建一个 CLI 和配套 skill
使用 $cli-creator 创建一个你可以使用的 CLI，并使用 $skill-creator 在同一线程中创建配套 skill。 学习来源：[文档 URL、OpenAPI 规范、已脱敏的 curl 命令、现有脚本路径、日志文件夹、CSV 或 JSON 导出文件、SQLite 数据库路径，或粘贴的 --help 输出]。 CLI 应支持的第一个任务：[从构建 URL 下载失败的 CI 日志、搜索支持工单并按 ID 读取其中一条、查询管理 API、读取本地数据库，或运行现有脚本中的某一步]。 可选写入任务：[创建评论草稿、上传媒体、重试失败任务，或目前仅只读]。 命令名称：[cli-name，或请推荐一个]。 在编写代码之前，先向我展示建议的命令接口，并且只询问会阻碍构建的缺失细节。
简介
当 Codex 持续使用同一个 API、日志源、导出的收件箱、本地数据库或团队脚本时，可以为这项工作提供一个可组合的接口：一个它能从任意文件夹运行、检查、缩小范围，并与 git、gh、rg、测试和仓库脚本组合使用的命令。
再添加一个配套 skill，用来记录 Codex 何时应使用这个 CLI、先运行什么、如何保持输出精简、下载的文件会保存到哪里，以及哪些写入命令需要审批。
在这个工作流中，$cli-creator 会帮助 Codex 构建命令。$skill-creator 会帮助 Codex 保存一个可复用的 skill，例如 $ci-logs，以便未来任务按名称调用。
使用方法
决定 CLI 应该做什么
从你希望 Codex 完成的事情开始，而不是从你希望它编写的技术开始。一个好的 CLI 会把重复性的读取、搜索、下载、导出、起草、上传、轮询或安全写入，变成一个 Codex 可以在任何仓库中运行的命令。
| 场景 | Codex 可以借助 CLI 做什么 | | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | | CI 日志位于构建页面之后。 | 接收构建 URL，将失败任务的日志下载到 ./logs，并返回文件路径和简短片段。 | | 支持工单以每周导出形式到达。 | 为最新的 CSV 或 JSON 导出建立索引，按客户或短语搜索，并通过稳定 ID 读取单条工单。 | | API 响应对于上下文来说过大。 | 只列出它需要的字段，通过 ID 读取完整对象，并将完整响应导出到文件。 | | Slack 导出包含很长的线程。 | 使用 --limit 搜索，读取单个线程，并返回附近上下文而不是整个归档。 | | 一个团队脚本会运行四个不同步骤。 | 将设置、发现、下载、起草、上传、轮询和实际写入拆分为单独命令。 | | 某个插件能找到记录，但 Codex 需要一个文件。 | 让插件保留在线程中；使用 CLI 下载附件、追踪文件、报告、视频或日志包，并返回路径。 |
分享文档、文件或命令
Codex 需要一些具体内容来学习：文档或 OpenAPI、已脱敏的 curl 命令、导出文件或数据库路径、日志文件夹，或现有脚本。如果你希望 CLI 遵循熟悉的风格，可以粘贴 gh、kubectl 或你们团队自有工具的一小段 --help 输出。
如果命令需要鉴权，请告诉 Codex 它应支持的环境变量名称、配置文件路径或登录流程。请你自行在 shell 或配置文件中设置密钥。不要把密钥粘贴到线程中。让 Codex 在缺少鉴权时，将 CLI 的设置检查明确失败并给出清晰提示。
让 Codex 构建 CLI 和 skill
使用本页的入门提示。填写 Codex 应学习的来源，以及 CLI 应支持的第一个任务。
在 Codex 编写代码之前，它应先展示建议的命令接口，并且只询问那些会阻碍构建的缺失细节。
验证命令可从任意文件夹运行
Codex 不应在 cargo run、python path/to/script.py 或未安装的软件包命令之后就停止。要求它从另一个仓库或临时文件夹测试已安装命令，就像后续任务会实际使用它那样。
像未来的 agent 一样测试 CLI
如果 Codex 返回了一个巨大的 JSON 数据块，请要求它缩小默认响应范围，并为完整负载添加文件导出。如果它忘记了审批边界，请要求它先更新配套 skill，再在另一个线程中使用。
稍后使用该 skill
当你再次需要这个 CLI 时，调用这个 skill，而不是再次粘贴文档：
对于重复性工作，先在普通线程中测试一次该 skill，然后让 Codex 将相同的调用方式转换为自动化。