agents-docs

Agent 文档

此技能无需协调：对其声明的工作，跳过 ai-coord 门禁。

支持的聊天宿主

开始任何工作前，先确认当前聊天宿主。如果不是 Claude Code 或 Codex CLI，请停止并显示以下错误： This skill only works in Claude Code or Codex CLI.

根据最相关的官方文档，回答有关 Codex 和 Claude Code 产品的问题。

对请求进行分类

将请求分类为 Codex、Claude Code 或比较。仅将此技能用于这些产品及其文档中描述的行为。将通用 Agent 工作以及有关提供商 API、SDK、定价、身份验证、模型、迁移或托管 Agent 的问题转交给相关来源。

将 $imagegen 和 Codex 图像提示词相关问题视为 Codex 产品问题。即使详细的模型指导依据来自 OpenAI 的 API Cookbook，也适用此分类。

将有关 Codex 的模型提示词问题视为 Codex 产品问题，并参考 OpenAI 的模型文档获取支持性指导。

访问官方来源

• 对于 Codex，仅从 https://developers.openai.com 开始。以此技能目录为基准解析 scripts/fetch-doc.sh。运行 fetch-doc.sh codex-manual。使用 rg 在返回的路径中进行精准搜索。仅将匹配标题范围读入上下文。固定的手册和架构端点可能会重定向到对应的 https://learn.chatgpt.com/docs/ 页面。
• 关于 Codex 中的模型提示词，请阅读 OpenAI 最新模型指南。该指南涵盖当前 GPT 模型系列。将针对某个模型提出的建议视为基于该模型的测量结果。应用 API 参数前，请依据产品文档确认 Codex 设置。
• 关于 $imagegen 和 Codex 图像提示词相关问题，请先阅读手册中的图像生成具体主题。需要详细的提示词模式或生产示例时，还应阅读 GPT 图像生成模型提示词指南。 将其中的提示词编写指导应用于 $imagegen。除非 Codex 文档确认内置技能提供了相关功能，否则应将模型选择、标志和 API 参数视为仅适用于 API。
• 对于 Claude Code，仅使用 https://code.claude.com。从 https://code.claude.com/docs/en/overview.md 开始进行广泛的产品调研。
• 对于 Codex，一般产品问题可使用 cached 手册。对于版本发布或变更问题、新鲜度存在重大争议、架构／配置不一致、与观察到的本地行为冲突以及其他明确不稳定的情况，使用 --refresh。
• 当 Codex 手册包含足够的支持文本并指出最终的主题官方 URL 时，根据这些证据作答并引用主题 URL。当手册指出了主题页面但细节不足时，直接获取该 Markdown 页面。仅当确切的官方页面仍未知时，才进行一次精简的域名限定搜索。切勿仅为重新查找手册已指出的 URL 而搜索。
• 针对具体的 Claude Code 主题，进行精简的域名限定网络搜索，以查找确切的官方页面。然后在有 Markdown 版本时获取该版本。只检索作答所需的页面或章节。切勿将完整的文档目录作为发现捷径获取。
• 优先使用当前客户端支持 URL 的获取功能来获取精简的主题页面。仅对两个固定的 Codex 资源使用辅助脚本。
• 对于比较问题，分别完整执行两个提供方的检索流程。切勿从一个产品的文档推断另一个产品的行为。

准确解读辅助脚本的诊断信息：

• cached 表示完整性有效的资源在不超过 24 小时前经过验证，并在未访问网络的情况下重用。验证时间戳不会更新。
• revalidated 表示较旧的资源收到成功的条件式 304 响应，且其验证元数据已刷新。
• fetched 表示成功的 200 响应提供了完整性有效的内容，并原子性地替换了之前的资源。
• stale 表示常规重新验证失败，辅助脚本回退到不超过七天的完整性有效资源。应说明其验证时间戳和检索失败情况。不要将 cached 或 stale 证据描述为实时获取的内容。

仅在匹配的官方域名内跟随重定向，但辅助脚本将确切的 Codex 资源重定向到 https://learn.chatgpt.com/docs/ 的情况除外。引用辅助脚本或实时获取所报告的最终页面 URL。

调查文档记录不足的 Codex 配置

当 prose 文档中缺少某项 Codex 功能或 config.toml 键时，请使用以下有界流程：

1. 通过 codex --version 和 codex features list 记录已安装的客户端及有效功能状态。
2. 根据此技能目录确定捆绑辅助脚本的位置。运行 fetch-doc.sh --refresh codex-config-schema。然后 仅搜索返回文件中的相关定义或路径。
3. 将架构与当前的 prose 配置参考进行比较。仅存在于架构中的字段应视为文档记录不足，而非每个客户端都保证支持的行为。
4. 使用已安装的客户端，通过 codex --strict-config --help 验证候选语法。必要时使用一次性的 -c 覆盖项，不要持久保存更改。解析通过并不能证明运行时行为。
5. 分别报告证据属于官方文档／架构、本地观察还是推断。如果来源存在分歧，应优先采用用户环境中已安装客户端的实际行为，并说明差异。

仅调查与请求相关的键或功能。不要将此流程扩展为完整的功能清单。

基于证据作答

• 对于缓存策略范围内返回或实时检索的官方文档，应将其视为已发布产品声明的权威依据。如果可以刷新相关页面，不要凭记忆回答当前或不稳定的产品事实。
• 对每项重要声明引用提供依据的确切官方页面；如果使用了特定主题页面，不要仅引用宽泛的入口页面。优先简短转述。仅在措辞必须精确时才引用原文。
• 如果已验证的本地命令、版本、配置或可调用功能与最新文档冲突，应报告差异，并优先采用该已安装环境中的实际行为。
• 如果找不到某个确切术语，应搜索相邻的官方概念，并说明文档未提及该术语本身。

将 Codex hook、app-server 和信任相关问题路由到相应资料

对于 Codex hooks、app-server、托管 hooks 或 hook-trust 操作问题，请先获取以下相关官方页面：

• https://developers.openai.com/codex/hooks
• https://developers.openai.com/codex/app-server

然后阅读版本对应的 hooks 参考。仅当已明确确认已安装客户端的版本与该参考中列出的版本一致时，才使用其中的本地协议和配置详情。在回答中区分官方行为与本地观察。不要将本地实现细节说成产品保证。

限定失败处理范围

如果主题页面检索失败，请尝试直接 URL 和一次限定域名的搜索。随后停止扩展来源。发生常规检索失败后，辅助脚本可能会返回过去七天内验证过的缓存条目。如果它报告 stale，请说明其验证时间戳，不要将其描述为实时内容。强制刷新、过期条目和完整性验证失败均应直接报错。说明有限范围内的不确定性。

仅在相关时使用本地 --help、--version、配置或观察到的行为，并将其标记为本地证据。不得悄然改用第三方来源、其他提供商的文档或捆绑知识。

进行比较时，即使无法获取另一方资料，也要回答有依据的一方。将缺乏依据的一方标记为未知，不要凭空制造对称结论。在网络受限的会话中，只能使用符合有界新鲜或过期策略的辅助脚本缓存条目；否则应如实说明无法作答。不得在代码仓库或技能安装目录中创建缓存。

完成条件

使用范围最窄且相关的官方来源，附上精确引用，并明确说明文档与本地版本之间的差异或检索限制。