编钟最佳实践 🏆

专业团队总结的实战经验
让你的工作流更稳定、更高效、更安全

98.5% 成功率
效率提升 300%
企业级安全

使用清晰的命名规范

必须掌握

给你的模板和步骤起有意义的名字

示例代码
# ✅ 好的命名
name: "微信文章保存到Obsidian"
description: "抓取微信文章并保存到Obsidian笔记"

steps:
  - name: "抓取文章内容"
    tool: "crawl-mcp"
  
  - name: "保存到Obsidian"
    tool: "obsidian-mcp"

# ❌ 不好的命名
name: "task1"
steps:
  - name: "step1"
    tool: "tool1"
关键要点
  • 使用动词+名词的格式:如"抓取文章内容"
  • 避免使用缩写和技术术语
  • 保持命名的一致性

合理设置错误处理

重要建议

为每个关键步骤设置错误处理和重试机制

示例代码
steps:
  - name: "抓取网页内容"
    tool: "playwright-mcp"
    retry: 3
    timeout: 30s
    on_error: 
      action: "skip"
      message: "网页抓取失败,跳过此步骤"
  
  - name: "保存文件"
    tool: "file-mcp"
    on_error:
      action: "stop"
      cleanup: true
      message: "文件保存失败,停止执行并清理临时文件"
关键要点
  • 网络操作设置重试机制
  • 文件操作设置清理机制
  • 提供有意义的错误信息

使用变量和参数化

进阶技巧

让模板更灵活,可以适应不同场景

示例代码
# 参数定义
parameters:
  source_url: 
    type: "string"
    required: true
    description: "要抓取的网页URL"
  
  output_folder:
    type: "string" 
    default: "Articles"
    description: "保存文件的文件夹"

steps:
  - name: "抓取内容"
    tool: "crawl-mcp"
    config:
      url: "{{source_url}}"
      
  - name: "保存文件"
    tool: "obsidian-mcp"
    config:
      folder: "{{output_folder}}"
      filename: "{{title}}_{{date}}.md"
关键要点
  • 使用双大括号语法 {{variable}}
  • 为参数提供默认值
  • 添加参数描述和类型信息

记住:实践出真知

最佳实践不是教条,而是经验的总结。 根据你的具体场景灵活应用,持续优化改进。