企业官网建设流程全解析

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

1. ① 本章核心主旨

本章提供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类可直接复用的技能设计模板，覆盖从简单流程到复杂领域场景；同时覆盖上传、触发、执行、连接、性能全链路故障排查，帮快速落地、稳定运行技能，大幅降低开发与维护成本。