浏览 MCP与Skills教程与资源
Skill 不触发怎么排查：发现、显式调用、隐式选择与执行失败
用 meeting-notes 固定一组请求，区分文件未发现、调用策略禁止自动选择、说明匹配不准和调用后输出错误，避免把所有问题都归到 description。
先给‘不触发’一个能观察的定义
同样一句‘没用上 Skill’，可能指选择器中找不到、点名后读错副本、普通请求没有自动选择，或已经读取 SKILL.md 但结果不对。最后一种属于执行问题，扩大 description 只会让更多不相关任务被选中。
固定安装教程中的 meeting-notes 文件和会议原文。在同一客户端版本、同一工作目录中每次新开会话测试，先保存实际路径和请求。若把整份 Skill 正文贴进测试会话，即使安装失败模型也可能照做，不能再用输出判断发现是否正常。
按这四个分支定位，停在第一个失败点
| 要回答的问题 | 观察方式 | 失败时检查 | 此时先别改什么 |
|---|---|---|---|
| 本次能发现它吗 | CLI／IDE 打开 /skills 或输入 $ 查 meeting-notes；记录真实路径 | 作用域、启动目录、文件名、YAML、禁用配置、刷新状态 | 别扩展触发词 |
| 点名能用这份文件吗 | 发送 $meeting-notes 与完整会议原文，核对加载路径 | 同名副本、当前客户端支持情况、读取错误 | 别把其他目录也复制一份碰运气 |
| 普通请求能选它吗 | 新会话去掉名称，只保留会议任务和原文 | allow_implicit_invocation、description 范围、已装 Skill 的竞争和初始列表提示 | 别改输出表格来修选择问题 |
| 选中后是否做对 | 查看原文证据、负责人、日期和冲突处理 | SKILL.md 工作流、输入及参考文件 | 别把输出错误算作漏触发 |
显式能用、隐式不选，也可能正是配置要求
这个可选文件让 Codex 不因普通请求隐式调用该 Skill，但显式 $meeting-notes 仍可使用。因此同一个客户端上：点名成功、普通会议请求不自动选中，并不必然是 description 写差了。
如果确实希望自动选择，审阅后删除这项限制或设为 true，再新开会话复测。这个实验只改策略，不同时改 description。本文最小版本不包含这个文件，默认允许隐式选择；这里是一个可控排错分支。
meeting-notes/agents/openai.yaml
policy: allow_implicit_invocation: false
排除发现和策略后，再收窄说明
有效变化是说明了输入对象、交付物和相邻反例。它没有靠塞入几十个‘总结、归纳、整理’同义词提高命中。关键任务应放在说明前部：当前官方文档指出，安装大量 Skill 时初始列表存在预算，说明可能被缩短，极多时也可能省略部分条目并提示。发现列表过多时先检查提示，不把列表预算问题误判成正文错误。
容易误选的说明
description: 帮助用户整理内容、提高效率、处理各种文档。
本例使用的说明
description: 把用户提供的会议记录整理为决定、待办和待确认问题，并保留原文依据。用于会议纪要、会后行动项整理；不用于普通文章润色、安排会议、访问日历或发送消息。
保留原话，分别跑这组诊断请求
| 请求 | 预期 | 结果怎么记 |
|---|---|---|
| $meeting-notes：请整理这份会议原文，随后粘贴安装教程的 L1–L4 | 显式选择；输出决定、待办、待确认 | 记录加载路径与实际输出；未运行写待跑 |
| 把下面会议记录整理为决定和会后待办，随后粘贴相同 L1–L4 | 允许隐式调用时应有合理机会选中本 Skill | 记录是否选择；漏选不能仅凭一次运行判定原因 |
| 请把‘我们明天讨论这个事情’润色得自然一些 | 不选择本 Skill；这是单句润色 | 记录误选还是正常普通回答 |
| 替我安排明天下午的会议并邀请同事 | 不选择本例会议原文整理 Skill | 本例不含日历能力；不能把拒绝缺权限算作任务完成 |
| $meeting-notes，请整理会议纪要；我还没提供原文 | 已选择后索要原文，不编造会议 | 这条用于区分‘触发’和‘工作流因缺输入停止’ |
本表是测试设计，没有填入命中次数和成功率。不要把‘模型没提到 Skill 名称’直接判为没调用，也不要把模型说‘已调用’直接判为加载成功。活动记录不完整时，触发状态应记为无法确认。
修复前后保持同一条请求，才看得出原因
例如安装路径错误时，只改安装路径，然后先重跑显式用例；它仍找不到文件，改 description 没有意义。策略为 false 时，只调整策略并复测隐式用例。已经加载正确文件却替 L3 指派负责人时，保留触发说明，去修正文中的事实约束。
每轮留下‘原始请求、客户端/模型、工作目录、Skill 路径、版本、可见活动、输出、修改项’。触发受任务上下文与模型选择影响，某一次漏选不是平台绝不支持的证据。先消除可确定的文件和策略问题，再用固定用例观察变化。
继续处理当前问题
资料与核验范围
产品行为按 2026-10-10 阅读的官方文档编写；本文会议、文件和版本均为教学构造。页面不声称在你的客户端完成过安装或模型运行。