SuperAPI AI 工具集

conventions-codex

编程与开发

查看项目

更新于 10-16 07:18

技能介绍

该技能是 Codex CLI 的工具专属叠加层,供评分器与检查器在制品被判定为 Tier 2-Codex 时加载,在通用约定之上补充 Codex 专属 schema。

用途:编写或评分 Codex CLI 制品,包括配置、插件清单、技能布局、钩子与 AGENTS.md 等。

主要能力:给出文件系统布局区分(跨工具的 .agents/ 与 Codex 私有的 .codex/);SKILL.md 位于 .agents/skills/<name>/SKILL.md,Codex 不读取 .codex/skills/;Codex 专属元数据放在旁车文件 agents/openai.yaml(interface、policy、dependencies.tools 为对象数组);插件清单 .codex-plugin/plugin.json 必填字段仅 name,其余可选,路径字段为字符串;市场清单 .agents/plugins/marketplace.json 的 policy 值为大写枚举;config.toml 为 TOML,涉及 [features]、[mcp_servers.<id>]、[hooks.<event>]、[agents]、[permissions.] 等;子代理为 .codex/agents/.toml 独立文件;钩子事件与 I/O 契约;AGENTS.md 按位置覆盖并受 project_doc_max_bytes 限制;以及近半年破坏性变更(如 [features].codex_hooks 更名、[profiles.*] 移除、旧内置 MCP 移除等)。

使用方式:由评分器与检查器自动加载,非人工直接调用。

限制:不覆盖通用 SKILL.md 规范、评分惩罚表与跨制品检查;plugin apps 的 .app.json schema 未公开;部分版本变更需先核实一手变更日志。