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)
在实际执行中,可能会遇到以下边缘情况,请参考对应解决方案:
- 报错:
Context Length Exceeded (上下文溢出):- 原因:一次性喂入的素材过大。
- 解法:拆分章节分批输入,或开启
AGENTS.md紧凑模式。
- 权限被拦截 (
Sandbox Approval Required):- 解法:在设置中将该安全操作加入白名单,或运行命令时指定授权参数。
6. 示例源码与产物资源
- 📁 示例源码与产物模版:[GitHub Repository Link / Assets]
- 💡 发现案例失效或有更好优化?[一键反馈/提交优化建议]