Skip to content

Codex × [工具名]:[一句话说明实现什么成果]

难度:🟢 入门 / 🟡 进阶 / 🔴 深度
耗时:⏱️ 5 分钟
适用版本:Codex CLI / Codex 桌面客户端 / Claude Code


1. 场景价值与交付产物预览

[清晰描述本案例解决的痛点:例如在什么业务场景下,如果手动做需要耗费 2 小时,而使用该配方只需要 1 句话。]

  • 输入:[如:一段 Markdown 文本、或者一个数据 JSON]
  • 输出成果:[如:自动生成的专业 PPTX 文件、Draw.io 架构图文件等]

2. 前置准备与环境配置

在执行核心任务前,需确保以下依赖已就绪:

bash
# 安装所需 CLI 或扩展
agy skill add [skill-name]
# 或配置相关 MCP 服务

3. 核心配置文件 (开箱即用)

将以下配置添加至你的配置文件中(如 ~/.codex/config.toml 或项目级配置文件):

json
{
  "name": "example-service",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-example"]
}

4. 黄金 Prompt 指令流

直接复制以下经过真机实测调优的指令,粘贴至 Codex / Agent 对话框中:

markdown
你是一名专业的 [专业角色],请基于当前目录下的 [输入文件],执行以下操作:
1. 提取核心结构与关键指标;
2. 遵循 [特定规范] 生成对应交付物;
3. 输出结果并执行自检,确认无格式错误。

5. 排障与避坑指南 (Troubleshooting)

在实际执行中,可能会遇到以下边缘情况,请参考对应解决方案:

  1. 报错:Context Length Exceeded (上下文溢出)
    • 原因:一次性喂入的素材过大。
    • 解法:拆分章节分批输入,或开启 AGENTS.md 紧凑模式。
  2. 权限被拦截 (Sandbox Approval Required)
    • 解法:在设置中将该安全操作加入白名单,或运行命令时指定授权参数。

6. 示例源码与产物资源

  • 📁 示例源码与产物模版:[GitHub Repository Link / Assets]
  • 💡 发现案例失效或有更好优化?[一键反馈/提交优化建议]

遵循 MIT 协议开源,严格执行 Google DESIGN.md 规范