PowerPoint Copilot 自定义技能,Codex 连上 TaoToken 后能按 SKILL.md 格式生成
2026/9/16 1:37:32 网站建设 项目流程

1. 卡住你的不是 Copilot,是 SKILL.md 的文件夹名

在 PowerPoint 的 Copilot 面板里手动创建自定义技能时,最让人头疼的不是写指令,而是SKILL.md 的 front matter 和文件夹名必须完全匹配。举个例子,技能名字叫“创建-执行摘要-幻灯片”,那文件夹就必须叫create-executive-summary-slide,万一中间多个空格或少个横线,Copilot 在管理技能面板里就直接不显示。这个场景正好适合交给 Codex:连上 TaoToken 后,让它按规范生成技能文件夹和 SKILL.md,你只需要做最后一步拖拽上传。先去 TaoToken 创建一把 API Key,后面每一步都省事。

原文里的路径是:打开 PowerPoint → 点击右下角 Copilot 图标 → 选择技能 → 管理技能 → 点击自定义技能。你可以在那里选择手动创建,也可以直接上传做好的.skill文件夹。手动创建要自己填名称、触发时机、用途描述,还得保证格式不出错;上传技能则是把写好的文件夹拖进去,Copilot 会自动放到 OneDrive 的技能文件夹里,并在下拉菜单里出现。问题在于,很多人第一次写 SKILL.md 时不知道前置部分怎么填,也不知道文件夹命名规则,于是反复试错。

与其让 Copilot 像猜谜一样识别你的文件,不如把“写 SKILL.md”这件事拆给 Codex 去做。Codex 本身擅长按规范生成结构化文件,只要你在提示词里把 PowerPoint Copilot 自定义技能的格式约束写清楚,它就能一次产出符合要求的SKILL.md和配套文件夹。整个流程里,Codex 消耗的是 TaoToken 上的模型额度,你只需要在最后把文件夹拖回 PowerPoint。

2. 准备材料:TaoToken 拿 Key,Codex 填 Base URL

2.1 在 TaoToken 控制台创建 YOUR_API_KEY

打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册登录后,进入控制台找到 API Keys 页面。点击创建新 Key,复制生成的字符串,这就是你的YOUR_API_KEY。注意这个 Key 会在下一步填进 Codex 的配置里,不要出现在 SKILL.md 或任何上传给 Copilot 的文件里,它只属于你的本地配置。

TaoToken 在这里扮演的是“统一 API 通道”的角色:你用一把 Key 换取模型调用的能力,Codex 通过它的兼容接口去请求模型生成内容。不需要在多个平台分别开通额度,也不需要去研究每家厂商的计费规则,模型广场上列出什么模型,你就用什么模型 ID。

2.2 在 ~/.codex/config.toml 里把模型供应商指到 TaoToken

Codex 的配置文件在用户目录下的~/.codex/config.toml。如果文件不存在,新建一个即可。下面是最小可用的配置,把默认模型供应商指向 TaoToken,Base URL 填https://taotoken.net/api,注意末尾不要加/v1

model_provider = "taotoken" model = "YOUR_MODEL_ID" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

其中YOUR_MODEL_ID需要替换成你在 TaoToken 模型广场 看到的模型 ID,以当时列表为准,不要凭记忆填。env_key指定了从哪个环境变量读取 Key,所以还要在终端里导出:

export TAOTOKEN_API_KEY=YOUR_API_KEY

如果想省去每次导出的麻烦,可以在~/.codex/.env里写:

TAOTOKEN_API_KEY=YOUR_API_KEY

配置好之后,先跑一句codex exec "hello"验证连通性。如果返回正常,说明 Codex 已经能通过 TaoToken 调用模型了。如果提示 401,优先检查YOUR_API_KEY有没有复制全,以及 Base URL 是否写成了https://taotoken.net/api/v

3. 让 Codex 按 create-executive-summary-slide 规范生成技能

3.1 给 Codex 的提示词要包含哪些约束

原文里给了一个关键例子:名为“创建-执行摘要-幻灯片”的技能,它的SKILL.md必须放在名为create-executive-summary-slide的文件夹中,Copilot 才能识别。让 Codex 生成时,你要把这个约束直接写进提示词,否则它可能给你一个中文文件夹名或者根本没有文件夹。

我给 Codex 的提示词结构是:先说目标角色,再说要生成的目录结构,然后把 front matter 的字段要求列出来,最后要求它输出完整可用的 SKILL.md。参考写法如下:

你是 PowerPoint Copilot 自定义技能生成器。请帮我创建一个执行摘要幻灯片技能。 要求: 1. 文件夹名必须是 create-executive-summary-slide 2. 文件夹内包含一个 SKILL.md 文件 3. SKILL.md 必须包含用 --- 包裹的 YAML front matter,至少包含 name 和 description 两个字段 4. description 里要写清楚“什么时候使用该技能” 5. body 部分是给 Copilot 的指令,告诉它如何从当前演示文稿生成执行摘要幻灯片,包括提取重点、组织成要点、建议放到第二页等 6. 只输出这个文件夹下所有文件的内容,用代码块区分文件路径

Codex 收到这个提示词后,会按你的要求产出两个代码块:一个标注为create-executive-summary-slide/SKILL.md,另一个可能是create-executive-summary-slide/README.md(如果它想补充说明)。你要做的就是新建同名文件夹,把内容复制进去。

3.2 检查 front matter 和 body 是否合规

生成完之后,别急着上传,先打开SKILL.md检查三个最容易出错的地方。

第一,front matter 的上下分隔线必须是三个短横线---,不是中文破折号,也不是三个以上的横线。原文里特别强调了“三个破折号分隔符(—)之间”,很多人在这里复制了 Word 里的长横线,结果 Copilot 识别失败。

第二,name字段的值最好和文件夹名保持一致或强相关。比如文件夹是create-executive-summary-slidename可以写同一个字符串,或者写更易读的“创建执行摘要幻灯片”,但只要文件夹名和 SKILL.md 里的技能标识对不上,管理面板就可能显示不出来。

第三,body 部分没有格式限制,但要让 Copilot 能执行。如果你的技能是“创建执行摘要幻灯片”,body 里应该包含类似“分析当前演示文稿的每页内容,找出关键数据、结论和建议,生成一页包含项目符号的执行摘要”这样的指令。Codex 生成的版本可能更具体,你只需确保它不是一句空话。

下面是一个简化的 SKILL.md 示例,用于和 Codex 的输出对照格式:

--- name: 创建执行摘要幻灯片 description: 当用户需要把当前演示文稿总结成一页执行摘要,或需要向管理层快速汇报时使用。 --- 从当前演示文稿中提取每页的核心结论、关键数据和待办事项。 将内容压缩成一页,使用标题“执行摘要”放在演示文稿第二页。 用项目符号列出最重要的三个发现,避免复制完整的段落。

注意这个示例只是格式参照,实际生成交给 Codex 会得到更完整的版本。你不需要自己手写,重点是把生成结果和这个格式做比对。

4. 把技能拖回 PowerPoint 并验证下拉菜单

生成好create-executive-summary-slide文件夹后,回到 PowerPoint:打开 Copilot 面板,点击“技能”,进入“管理技能”,选择“上传技能”。你可以直接把这个文件夹从文件管理器拖到上传区域。如果一次拖不了文件夹,可以压缩成 zip 后上传,PowerPoint 会自动解压并识别里边的 SKILL.md。上传成功的标志是:在 Copilot 面板的技能下拉菜单里能看到“创建执行摘要幻灯片”这个名字。

为了确认 Codex 生成的技能确实可用,我建议你在演示文稿里插入一段测试内容,然后打开 Copilot,选中这个技能,看它是否按 body 里的指令生成执行摘要。如果 Copilot 回答“我没有找到该技能”,先回到管理技能面板,点击右上角的刷新按钮。这是官方文档里没有细写但很常见的处理方式。

验证通过后,你实际获得的是一套可复用的技能文件:以后任何需要执行摘要的 PPT 都可以直接上传这份文件夹,不需要再让 Codex 重新生成。这也正是自定义技能的价值——把高频工作沉淀成一个指令包,而写指令包这个过程由 Codex 帮你完成。

5. 上传不显示?先查这三个位置

如果技能不在下拉菜单里,优先检查以下三项,它们对应了原文里“如果上传后没看到技能,可以在管理技能面板里试试”这句话背后的实际原因。

第一项是文件夹名。Copilot 对文件夹命名非常敏感,空格、大小写、连字符位置都会影响识别。你最好让 Codex 生成的文件夹名完全使用小写字母和连字符,不要用空格或下划线。如果发现文件名被系统改成了“新建文件夹”,请立即重命名为create-executive-summary-slide

第二项是 front matter 的分隔线。用文本编辑器打开 SKILL.md,确认文件最顶部是---,然后换行写字段,再换行写---。如果分隔线写成了或是-少了重复次数,Copilot 会把整个文件当成纯文本,技能自然不生效。

第三项是文件的编码和扩展名。确保文件后缀是.md,并且用 UTF-8 编码保存。Windows 自带的记事本有时候会把文件存成 UTF-8 with BOM,这会导致第一行不被识别。建议用 VS Code 打开,右下角编码显示“UTF-8”即可。

排除了这三个位置,技能还是不出来,那就要回到 Codex 这一步重新生成。这次把提示词改得更严格,比如明确要求“front matter 必须只包含 name 和 description,不要加额外字段”,然后重新复制文件内容。注意,重新上传前先删掉旧的技能文件夹,不要在 OneDrive 里保留同名文件夹,否则 Copilot 可能读的是旧缓存。

6. 跑通后去控制台对一下这次调用

技能在 PowerPoint 里被 Copilot 真正触发过一次之后,你可以回到 TaoToken 控制台查看这几次 Codex 调用的记录。生成的 SKILL.md 只是文本文件,本身不消耗 token,真正消耗 token 的是你让 Codex 生成文件、以及反复修改时的那几次模型请求。去控制台看看到底花了多少,心里有数。

如果你想在正式写技能之前先确认模型 ID 和 Key 的状态,可以在 模型对话 里用同一把 Key 发一条测试消息,然后回到 Codex 再跑一遍生成。这样可以把配置问题和模型能力问题分开排查。

如果后续要把这种“写技能”的流程批量用到其他场景,比如生成会议记录摘要技能、竞品分析技能,可以考虑在 Coding Plan 里评估一下自己的调用量。Key 的统一管理始终在 控制台 API Keys,换机器时只需要同步config.toml和新的YOUR_API_KEY,不需要重新申请其他平台的账号。

最后留一句个人体会:自定义技能这件事,真正的门槛不是 Copilot 本身,而是你对格式规范的理解。把 Codex 接进 TaoToken 后,等于让一个懂格式的助手替你写文件,你只负责验收。多试几次之后你会发现,SKILL.md 的生成速度和准确度,比手动复制粘贴模板高得多,而且不会再因为文件夹名里少一个横线而浪费时间。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询