抽象、冲突、忘读、乱序、混淆——逐个排查逐个修。图 1 —— 5 个坑一张图看完写好的 Skill 不生效别慌大概率是这 5 个坑里的一个。每个坑我都踩过每个都花了至少 1 小时排查。今天帮你一圈跳过。图 2 —— 坑 1写得太抽象Skill 里写生成标题五点——Claude 确实会生成但质量极差每次格式不一样。因为没写清楚怎么做。拆成读产品资料→读素材标准→按模板写 3 个候选→合规检查→输出。图 3 —— 坑 2规则互相冲突一个 Skill 说别删文件CLAUDE.md 说过期文件进归档——Claude 不知道该听谁的行为随机。修法给其中一条加确认后才能执行的后置条件。图 4 —— 坑 3Agent 忘了读素材创建了一个 Agent结果它凭经验写 Listing跳过了素材库。因为 Agent 文件里没写必须读素材。修法在 Agent 文件第一段加执行前必须读取 XX 素材。图 5 —— 坑 4Skill 太多读取顺序乱了8 个 Skill 文件Claude 不按你想的顺序读。可能先读 03 再读 01上下文错乱。修法CLAUDE.md 里写死启动时优先读取 00 → 01 → 02用编号控制顺序。图 6 —— 坑 5不同产品的卖点混在一起素材库里有 iPad 笔的卖点快充、防误触也有 EMR 笔的卖点不用充电、橡皮擦。Claude 分不清哪个卖点属于哪个产品就全写进去。修法CLAUDE.md 加产品功能防误用规则写清什么卖点只属于什么产品。图 7 —— 5 坑速查清单存下这张图Skill 不生效时逐个排查①步骤够不够具体②规则有没有冲突③Agent 有没有写读素材④编号顺序对不对⑤不同产品有没有防混淆规则这 5 个坑你中过几个评论区打个数字1-5让我看看哪个坑中的人最多。全系列 8 篇结束。收藏这篇排错清单Skill 不生效就回来翻。