autosnippet

--- # Required Fields title: Your Recipe Title Here (English, ≤50 chars, verb-based) trigger: @my_trigger category: Network # MUST be one of: View, Service, Tool, Model, Network, Storage, UI, Utility language: swift # swift, objectivec, go, python, java, kotlin, javascript, typescript, dart, rust summary_cn: Chinese summary, ≤100 chars summary_en: English summary, ≤100 words headers: ["import Foundation"] # Complete import statement array knowledgeType: code-pattern # code-pattern, architecture, best-practice, code-standard, code-style, code-relation, data-flow, event-and-data-flow, module-dependency, boundary-constraint, solution, anti-pattern # V3 Cursor Delivery Required Fields kind: pattern # rule = mandatory constraint | pattern = reusable pattern | fact = project fact doClause: "Use dependency injection via constructor" # English imperative, verb-first, ≤60 tokens dontClause: "Don't instantiate services with new directly" # English negative constraint whenClause: "When creating a new service class" # English trigger scenario coreCode: | class MyService { constructor(private db: Database) {} } usageGuide: | ### When to Use When creating a new Service class ### Convention Always use constructor injection # Optional Fields (recommended) keywords: ["keyword1", "keyword2", "keyword3"] tags: [tag1, tag2] whenToUse: | - Applicable scenario 1 - Applicable scenario 2 - Applicable scenario 3 whenNotToUse: | - Scenario to avoid 1 - Scenario to avoid 2 difficulty: beginner # beginner, intermediate, advanced authority: 1 # 1~5 relatedRecipes: ["@related_recipe_trigger"] version: "1.0.0" updatedAt: 1706515200 author: team_name deprecated: false --- ## Snippet / Code Reference ``` // Paste or write code snippet here (ideally runnable, with error handling and comments) ``` ## AI Context / Usage Guide ### When to Use - Applicable scenario description - Typical business or technical context - Typical user role ### When Not to Use - Exclusion scenarios, easy-to-misuse cases - When to apply alternatives ### Steps 1. Step 1: Preparation or prerequisites 2. Step 2: Core logic 3. Step 3: Result handling or follow-up ### Key Points - Error-prone areas, easily overlooked details - Thread/memory/lifecycle constraints - Performance characteristics or limitations ### Dependencies & Prerequisites - Required modules/frameworks to import - Minimum system/API version - 权限、配置或环境要求 ### 错误处理 - 常见失败场景和处理方式 - 重试、超时、降级策略 - 异常分支处理 ### 性能与资源 - 缓存、内存使用、线程安全 - 频率限制或节流建议 - 大数据量或高并发处理 ### 安全与合规 - 敏感信息处理（token、密钥等） - 鉴权、日志脱敏策略 - 合规要求（数据保护、用户隐私） ### 常见误用 - ❌ 错误做法 1：原因分析 - ❌ 错误做法 2：原因分析 - ✅ 正确做法：推荐方式 ### 最佳实践 - 推荐做法 1：适用场景或原因 - 推荐做法 2：性能或可维护性考量 - 推荐工具或设计模式 ### 替代方案 - **方案 A**：优缺点对比 - **方案 B**：何时优先使用 - **其他 Recipe**：关联或互补方案 ### 相关 Recipe - `@相关_trigger_1`：简要说明关系 - `@相关_trigger_2`：简要说明关系