一句话定义
技能没生效时，先不要重写整份 skill。优先排查安装、触发和 description 三个最常见位置。
机制 / 原理
第一步看 技能是否安装成功，确认智能体能看到这个 skill；第二步看 当前对话是否触发了技能，有些平台需要新对话或重新加载；第三步看 description 是否匹配用户说法，如果描述写“工作报告”，用户却说“写周报”，就可能漏触发。排查时可以直接让智能体读 SKILL.md 并分析触发失败原因。
经典实验 / 例子
本书案例：周报 skill 没有触发时，排查不是先重写整份 SKILL.md。用户先让智能体列出已安装技能，确认周报 skill 是否存在；再重启或打开新对话，排除扫描时机问题；最后查看 description。若 description 写的是“生成工作报告”，而用户说的是“帮我写周报”，智能体就可能匹配不上，于是需要补进“周报、工作总结、每周汇报”等真实触发表达。
书中案例出处
周报 skill 三步排查
核心原文线索
周报 skill 三步排查
案例现场复述
周报技能不触发时，先查是否安装，再查是否需要重启或新对话，最后检查 description 是否覆盖用户真实说法。
为什么重要
触发失败常常是入口描述问题，不是正文规则问题。
生活中的例子
引申案例：客户访谈整理 skill 装好后，小周说“帮我处理这段用户聊天记录”，系统没有调用。她没有马上改正文流程，而是检查 description，发现里面只写了“访谈纪要”。她补上“用户聊天记录、客户反馈、访谈整理”等说法，再开新对话测试，技能才被选中。
常见误区
误区：技能没生效就说明正文规则写错了。 很多问题其实发生在触发前。先确认智能体能发现这个 skill，再检查 description 是否覆盖真实用户说法。