Claude技能构建指南｜第五章 模式与故障排除（Patterns and Troubleshooting）

Claude技能构建指南第五章 模式与故障排除Patterns and Troubleshooting1. ① 本章核心主旨本章提供5种高频复用的技能设计模式并针对上传、触发、执行、MCP连接等常见问题给出标准化排查方案学完可直接套用成熟模板开发技能快速定位并解决各类运行故障。2. ② 内容2.1 模式选择问题优先 vs 工具优先问题优先用户提目标技能编排MCP调用顺序聚焦结果如“搭建项目空间”。工具优先已有MCP连接技能教最佳工作流聚焦用法如“用好Notion MCP”。2.2 五大常用设计模式2.2.1 顺序工作流编排适用固定顺序的多步骤任务。核心分步执行、明确依赖、阶段验证、失败回滚。示例新客户入职建账号→设支付→开订阅→发通知。2.2.2 多MCP协同适用跨多个第三方服务的复杂流程。核心分阶段执行、跨服务传数据、阶段校验、统一报错。示例设计转开发交付Figma→Drive→Linear→Slack。2.2.3 迭代优化适用需反复打磨质量的输出报告/文案。核心初稿生成→质量校验→循环优化→达标收尾。示例报告生成取数据→初稿→脚本校验→改问题→终稿。2.2.4 上下文感知工具选择适用同一目标、不同条件选不同工具。核心明确决策规则、备选方案、透明告知选择原因。示例文件存储按大小/类型选云盘/Notion/GitHub。2.2.5 领域专属智能适用需嵌入专业规则/合规逻辑的场景。核心先校验合规、再执行操作、全程留痕审计。示例支付处理合规审查→风控校验→执行→审计日志。2.3 常见故障排除2.3.1 上传失败问题找不到SKILL.md / 无效YAML / 技能名错误。原因文件名大小写错、YAML格式错、命名含空格/大写。解决严格命名、修正YAML、改用kebab-case。2.3.2 技能不触发原因description太笼统、缺触发词、场景不明确。解决细化描述、加精准触发话术、明确适用边界。2.3.3 过度触发原因描述范围过宽、无反向限制。解决加反向触发词、缩小场景、明确“不适用场景”。2.3.4 MCP连接失败原因服务未启动、密钥失效、权限不足、工具名错误。解决检查连接状态、验证密钥、核对工具名、独立测试MCP。2.3.5 指令不执行原因指令冗长、关键信息后置、表述模糊、缺少鼓励。解决精简指令、核心步骤前置、用词精准、加质量优先提示。2.3.6 上下文过大原因技能内容臃肿、同时启用过多技能、未用渐进披露。解决拆分内容到references/、减少并发技能、仅核心内容留SKILL.md。3. 本章小结本章提供5类可直接复用的技能设计模板覆盖从简单流程到复杂领域场景同时覆盖上传、触发、执行、连接、性能全链路故障排查帮快速落地、稳定运行技能大幅降低开发与维护成本。