创建 Codex 可使用的 CLI

Create a CLI Codex can use EngineeringCode

场景定位

当 Codex 反复使用同一个 API、日志源、导出文件、本地数据库或团队脚本时，把它做成可组合 CLI，并配套一个 companion skill，让以后任务可以直接调用稳定命令而不是重新粘贴文档。

难度: 中级
时间跨度: 约 30-60 分钟

适合用于

Codex 需要反复搜索、读取、下载或安全写入同一个服务、导出、归档、脚本或本地数据源的工作
需要分页搜索、按 ID 精确读取、可预测 JSON、文件下载、本地索引或 draft-before-write 命令的 agent tools

Skills & Plugins

起步提示词

Use $cli-creator to create a CLI you can use, and use $skill-creator to create the companion skill in this same chat.

Source to learn from: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output].

First job the CLI should support: [download failed CI logs from a build URL, search support tickets and read one by ID, query an admin API, read a local database, or run one step from an existing script].

Optional write job: [create a draft comment, upload media, retry a failed job, or read-only for now].

Command name: [cli-name, or recommend one].

Before coding, show me the proposed command surface and ask only for missing details that would block the build.

在 ChatGPT 中尝试

介绍

当 Codex 不断使用同一个 API、日志源、导出的 inbox、本地数据库或团队脚本时，应该给这类工作一个可组合接口：一个可以从任意文件夹运行、可以检查、缩小范围，并能和 `git`、`gh`、`rg`、测试命令和 repo scripts 组合使用的命令。

再加一个 companion skill，记录 Codex 何时应该使用这个 CLI、首先运行什么、如何保持输出小、下载文件落在哪里，以及哪些写命令需要审批。

在这个流程里，`$cli-creator` 帮 Codex 构建命令，`$skill-creator` 帮 Codex 保存一个可复用 skill，例如 `$ci-logs`，后续任务就能按名称调用。

如何使用

使用本页 starter prompt：给出 CLI 要学习的来源、第一件要支持的工作、是否需要可选写操作，以及期望命令名。

在写代码前，要求 Codex 先展示 proposed command surface，只询问真正阻塞构建的缺失信息。这样可以先修正命令语义，再投入实现。

选择 CLI 应该做什么

从你希望 Codex 完成的事情开始，而不是从要写什么技术栈开始。好的 CLI 会把重复读取、搜索、下载、导出、草稿、上传、轮询或安全写入变成 Codex 能从任意 repo 运行的命令。

第一版应该聚焦一个高频任务，例如下载失败 CI 日志、搜索 support tickets 并按 ID 阅读、查询 admin API、读取本地数据库，或运行现有脚本的某个步骤。

分享文档、文件或命令

Codex 需要具体材料来学习：文档或 OpenAPI、脱敏 curl 命令、导出文件或数据库路径、日志文件夹，或现有脚本。如果希望 CLI 遵循熟悉风格，可以粘贴 `gh`、`kubectl` 或团队内部工具的一小段 `--help` 输出。

如果命令需要 auth，告诉 Codex 应支持的环境变量名、配置文件路径或登录流程。secret 由你自己放到 shell 或配置文件里，不要粘贴到对话中。

要求 Codex 让 CLI 的 setup check 在缺少 auth 时清晰失败，并给出修复方式。

要求 Codex 构建 CLI 和 skill

填写本页 starter prompt，让 Codex 先从来源材料提炼命令面，再实现 CLI 与 companion skill。

命令面应包含可预测的 reads、search、exact read by ID、download/export、可选 draft 或 safe write，以及 `--json`、`--limit`、`--output` 这类 agent-friendly 参数。

mycli setup-check
mycli search --query "timeout" --limit 10 --json
mycli read --id TICKET-123 --json
mycli download-logs --build-url <url> --output ./tmp/logs
mycli draft-comment --id TICKET-123 --body-file reply.md

验证命令可从任意目录运行

Codex 不应该停在 `cargo run`、`python path/to/script.py` 或未安装包命令。要求它把命令安装到 PATH，并从另一个 repo 或临时文件夹测试，这才接近后续任务的真实用法。

像未来 agent 一样测试 CLI：运行 setup check、窄搜索、按 ID 精确读取、下载到可预测目录，并确认默认输出不会变成巨大 JSON blob。

如果 Codex 返回巨大的 JSON，要求它缩小默认响应，并为完整 payload 添加文件导出。如果它忘记 approval boundary，先更新 companion skill 再让其它任务使用。

之后使用 skill

下次需要这个 CLI 时，直接调用 skill，而不是再次粘贴文档。例如：`Use $ci-logs to inspect the failed build and summarize the most likely root cause.`

对重复工作，可以先在一个 chat 里测试 skill，再从同一 chat 安排任务。关键是让 skill 记住入口命令、输出限制、文件位置和审批边界。

在 chat 内安排任务

Prompt Library

建议提示词

为 CI 日志创建 CLI

Use $cli-creator and $skill-creator to build a CLI for downloading failed CI logs from a build URL. The default command should summarize available jobs first, download full logs only when requested, and save artifacts under a predictable local folder.

为导出数据库创建 CLI

Create a read-only CLI for this SQLite database export. It should expose schema inspection, paged search, exact row reads by ID, and JSON output with `--limit`. Add a companion skill that tells Codex when to use it.