这些模式来自早期采用者和内部团队创建的 Skills。它们代表了我们观察到的常见有效方法，而非规定性模板。

选择方法：问题优先 vs. 工具优先

把它想象成家得宝（Home Depot）。你可能带着一个问题走进去——"我需要修厨房橱柜"——然后员工引导你找到合适的工具。或者你可能挑好了一把新电钻，然后询问如何用它完成你的特定工作。

Skills 的工作方式相同：

  • 问题优先："我需要设置一个项目工作区" → 你的 Skill 按正确顺序编排合适的 MCP 调用。用户描述结果；Skill 处理工具。
  • 工具优先："我已连接了 Notion MCP" → 你的 Skill 教导 Claude 最优工作流程和最佳实践。用户拥有访问权限；Skill 提供专业知识。

大多数 Skills 偏向某一方向。了解哪种框架适合你的使用场景，有助于你选择下方合适的模式。

模式 1：顺序工作流程编排

适用场景： 用户需要按特定顺序执行的多步骤流程。

示例结构：

## 
	
	Workflow: Onboard New Customer
	
	
	
	

### 
	
	Step 1: Create Account
	
	
	
	
Call MCP tool: `
	
	
	
	create_customer
	
	
	
	`
	
	
	
	
Parameters: name, email, company

### 
	
	Step 2: Setup Payment
	
	
	
	
Call MCP tool: `
	
	
	
	setup_payment_method
	
	
	
	`
	
	
	
	
Wait for: payment method verification

### 
	
	Step 3: Create Subscription
	
	
	
	
Call MCP tool: `
	
	
	
	create_subscription
	
	
	
	`
	
	
	
	
Parameters: plan_id, customer_id (from Step 1)

### 
	
	Step 4: Send Welcome Email
	
	
	
	
Call MCP tool: `
	
	
	
	send_email
	
	
	
	`
	
	
	
	
Template: welcome_email_template
 

核心技巧：

  • 明确的步骤顺序
  • 步骤间的依赖关系
  • 每个阶段的验证
  • 失败时的回滚指令

模式 2：多 MCP 协调

适用场景： 工作流程跨越多个服务。

示例： 设计到开发的交接

### 
	
	Phase 1: Design Export (Figma MCP)
	
	
	
	
1
	
	
	
	.
	
	
	
	 Export design assets from Figma
2
	
	
	
	.
	
	
	
	 Generate design specifications
3
	
	
	
	.
	
	
	
	 Create asset manifest

### 
	
	Phase 2: Asset Storage (Drive MCP)
	
	
	
	
1
	
	
	
	.
	
	
	
	 Create project folder in Drive
2
	
	
	
	.
	
	
	
	 Upload all assets
3
	
	
	
	.
	
	
	
	 Generate shareable links

### 
	
	Phase 3: Task Creation (Linear MCP)
	
	
	
	
1
	
	
	
	.
	
	
	
	 Create development tasks
2
	
	
	
	.
	
	
	
	 Attach asset links to tasks
3
	
	
	
	.
	
	
	
	 Assign to engineering team

### 
	
	Phase 4: Notification (Slack MCP)
	
	
	
	
1
	
	
	
	.
	
	
	
	 Post handoff summary to #engineering
2
	
	
	
	.
	
	
	
	 Include asset links and task references
 

核心技巧：

  • 清晰的阶段划分
  • MCP 之间的数据传递
  • 进入下一阶段前的验证
  • 集中的错误处理

模式 3：迭代精炼

适用场景： 输出质量随迭代提升。

示例： 报告生成

## 
	
	Iterative Report Creation
	
	
	
	

### 
	
	Initial Draft
	
	
	
	
1
	
	
	
	.
	
	
	
	 Fetch data via MCP
2
	
	
	
	.
	
	
	
	 Generate first draft report
3
	
	
	
	.
	
	
	
	 Save to temporary file

### 
	
	Quality Check
	
	
	
	
1
	
	
	
	.
	
	
	
	 Run validation script: `
	
	
	
	scripts/check_report.py
	
	
	
	`
	
	
	
	
2
	
	
	
	.
	
	
	
	 Identify issues:
    -
	
	
	
	 Missing sections
    -
	
	
	
	 Inconsistent formatting
    -
	
	
	
	 Data validation errors

### 
	
	Refinement Loop
	
	
	
	
1
	
	
	
	.
	
	
	
	 Address each identified issue
2
	
	
	
	.
	
	
	
	 Regenerate affected sections
3
	
	
	
	.
	
	
	
	 Re-validate
4
	
	
	
	.
	
	
	
	 Repeat until quality threshold met

### 
	
	Finalization
	
	
	
	
1
	
	
	
	.
	
	
	
	 Apply final formatting
2
	
	
	
	.
	
	
	
	 Generate summary
3
	
	
	
	.
	
	
	
	 Save final version
 

核心技巧：

  • 明确的质量标准
  • 迭代改进
  • 验证脚本
  • 知道何时停止迭代

模式 4：上下文感知工具选择

适用场景： 相同的结果，根据上下文使用不同的工具。

示例： 文件存储

## 
	
	Smart File Storage
	
	
	
	

### 
	
	Decision Tree
	
	
	
	
1
	
	
	
	.
	
	
	
	 Check file type and size
2
	
	
	
	.
	
	
	
	 Determine best storage location:
    -
	
	
	
	 Large files (>10MB): Use cloud storage MCP
    -
	
	
	
	 Collaborative docs: Use Notion/Docs MCP
    -
	
	
	
	 Code files: Use GitHub MCP
    -
	
	
	
	 Temporary files: Use local storage

### 
	
	Execute Storage
	
	
	
	
Based on decision:
-
	
	
	
	 Call appropriate MCP tool
-
	
	
	
	 Apply service-specific metadata
-
	
	
	
	 Generate access link

### 
	
	Provide Context to User
	
	
	
	
Explain why that storage was chosen
 

核心技巧：

  • 清晰的决策标准
  • 备选方案
  • 关于选择的透明度

模式 5：领域特定智能

适用场景： 你的 Skill 在工具访问之外增加了专业知识。

示例： 金融合规

## 
	
	Payment Processing with Compliance
	
	
	
	

### 
	
	Before Processing (Compliance Check)
	
	
	
	
1
	
	
	
	.
	
	
	
	 Fetch transaction details via MCP
2
	
	
	
	.
	
	
	
	 Apply compliance rules:
   -
	
	
	
	 Check sanctions lists
   -
	
	
	
	 Verify jurisdiction allowances
   -
	
	
	
	 Assess risk level
3
	
	
	
	.
	
	
	
	 Document compliance decision

### 
	
	Processing
	
	
	
	
IF compliance passed:
  -
	
	
	
	 Call payment processing MCP tool
  -
	
	
	
	 Apply appropriate fraud checks
  -
	
	
	
	 Process transaction
ELSE:
  -
	
	
	
	 Flag for review
  -
	
	
	
	 Create compliance case

### 
	
	Audit Trail
	
	
	
	
-
	
	
	
	 Log all compliance checks
-
	
	
	
	 Record processing decisions
-
	
	
	
	 Generate audit report
 

核心技巧：

  • 逻辑中嵌入领域专业知识
  • 行动前先合规
  • 全面的文档记录
  • 清晰的治理

故障排除

Skill 无法上传

错误："Could not find SKILL.md in uploaded folder"

原因：文件没有完全命名为 SKILL.md

解决方案：

  • 重命名为 SKILL.md（区分大小写）
  • 用 ls -la 验证，应显示 SKILL.md

错误："Invalid frontmatter"

原因：YAML 格式问题

常见错误：

# 错误——缺少分隔符
	
	
	
	
name
	
	
	
	: my-skill
	
	
	
	
description
	
	
	
	: Does things
	
	
	
	

# 错误——未闭合的引号
	
	
	
	
name
	
	
	
	: my-skill
	
	
	
	
description
	
	
	
	: "
	
	Does things
	
	
	
	

# 正确
	
	
	
	
---
	
	
	
	
name: my-skill
	
	
	
	
description: Does things
	
	
	
	
---
 

错误："Invalid skill name"

原因：名称含有空格或大写字母

# 错误
	
	
	
	
name
	
	
	
	: My Cool Skill
	
	
	
	

# 正确
	
	
	
	
name
	
	
	
	: my-cool-skill
 

Skill 不触发

症状： Skill 从不自动加载

修复：

修改你的 description 字段。参见「Description 字段」章节中的好/坏示例。

快速检查清单：

  • 是否太通用？（"Helps with projects" 无效）
  • 是否包含用户实际会说的触发短语？
  • 如果适用，是否提及了相关文件类型？

调试方法：

询问 Claude："When would you use the [skill name] skill?" Claude 会引用 description 内容。根据缺失的内容进行调整。

Skill 触发过于频繁

症状： Skill 在无关查询时加载

解决方案：

1. 添加负面触发词

description
	
	
	
	: Advanced data analysis for CSV files. Use for
	
	
	
	
statistical modeling, regression, clustering. Do NOT use for
	
	
	
	
simple data exploration (use data-viz skill instead).
 

2. 更加具体

# 太宽泛
	
	
	
	
description
	
	
	
	: Processes documents
	
	
	
	

# 更具体
	
	
	
	
description
	
	
	
	: Processes PDF legal documents for contract review
 

3. 明确范围

description
	
	
	
	: PayFlow payment processing for e-commerce. Use
	
	
	
	
specifically for online payment workflows, not for general
	
	
	
	
financial queries.
 

MCP 连接问题

症状： Skill 加载但 MCP 调用失败

检查清单：

  1. 验证 MCP 服务器是否已连接

    • Claude.ai：Settings > Extensions > [你的服务]
    • 应显示"Connected"状态

  2. 检查身份验证

    • API 密钥有效且未过期
    • 已授予正确的权限/范围
    • OAuth token 已刷新

  3. 独立测试 MCP

    • 让 Claude 直接调用 MCP（不使用 Skill）
    • "Use [Service] MCP to fetch my projects"
    • 如果这也失败，问题在 MCP 而非 Skill

  4. 验证工具名称

    • Skill 引用了正确的 MCP 工具名称
    • 检查 MCP 服务器文档
    • 工具名称区分大小写

指令未被遵循

症状： Skill 加载但 Claude 不遵循指令

常见原因：

  1. 指令太冗长

    • 保持指令简洁
    • 使用项目符号和编号列表
    • 将详细参考内容移至单独文件

  2. 指令被埋没

    • 将关键指令放在最前面
    • 使用 ## Important 或 ## Critical 标题
    • 如有必要，重复关键要点

  3. 语言模糊

# 
	
	差
	
	
	
	
Make sure to validate things properly

# 
	
	好
	
	
	
	
CRITICAL: Before calling create_project, verify:
-
	
	
	
	 Project name is non-empty
-
	
	
	
	 At least one team member assigned
-
	
	
	
	 Start date is not in the past
 

高级技巧： 对于关键验证，考虑打包一个以编程方式执行检查的脚本，而不是依赖语言指令。代码是确定性的；语言解读则不然。参见 Office skills 了解此模式的示例。

  1. 模型"偷懒" 添加明确的鼓励：
## 
	
	Performance Notes
	
	
	
	
-
	
	
	
	 Take your time to do this thoroughly
-
	
	
	
	 Quality is more important than speed
-
	
	
	
	 Do not skip validation steps
 

注意：将此内容添加到用户提示中比放在 SKILL.md 中更有效。

大上下文问题

症状： Skill 看起来变慢或响应质量下降

原因：

  • Skill 内容太大
  • 同时启用的 Skills 太多
  • 所有内容被加载而非递进式披露

解决方案：

  1. 优化 SKILL.md 大小

    • 将详细文档移至 references/
    • 链接引用而非内联
    • 将 SKILL.md 控制在 5,000 字以内

  2. 减少启用的 Skills 数量

    • 评估是否同时启用了超过 20-50 个 Skills
    • 建议选择性启用
    • 考虑将相关能力打包成 Skill "套件"