autosnippet 3.0.0 → 3.0.2

package/skills/autosnippet-reference-objc/SKILL.md

@@ -33,12 +33,20 @@ description: Objective-C 业界最佳实践参考。涵盖命名前缀、属性
 ```json
 {
   "title": "ObjC 命名: 使用 3+ 字符类前缀避免冲突",
-  "code": "// ✅ 好的命名 — 3 字符前缀\n@interface ABCNetworkManager : NSObject\n@interface ABCUserProfileViewController : UIViewController\n\n// ❌ 差的命名\n@interface NetworkManager : NSObject  // 无前缀，可能与其他库冲突\n@interface NSUser : NSObject  // 使用系统前缀 NS\n@interface ABUser : NSObject  // 只有 2 字符",
+  "content": {
+    "markdown": "## ObjC 命名: 使用 3+ 字符类前缀避免冲突\n\n### 标准模式\n```objective-c\n// ✅ 好的命名 — 3 字符前缀\n@interface ABCNetworkManager : NSObject\n@interface ABCUserProfileViewController : UIViewController\n\n// ❌ 差的命名\n@interface NetworkManager : NSObject  // 无前缀，可能与其他库冲突\n@interface NSUser : NSObject  // 使用系统前缀 NS\n@interface ABUser : NSObject  // 只有 2 字符\n```",
+    "pattern": "// ✅ 好的命名 — 3 字符前缀\n@interface ABCNetworkManager : NSObject\n@interface ABCUserProfileViewController : UIViewController\n\n// ❌ 差的命名\n@interface NetworkManager : NSObject  // 无前缀，可能与其他库冲突\n@interface NSUser : NSObject  // 使用系统前缀 NS\n@interface ABUser : NSObject  // 只有 2 字符",
+    "rationale": "Objective-C 无命名空间，类前缀是避免符号冲突的唯一手段。Apple 保留 2 字符前缀（NS/UI/CG 等），三方代码应用 3+ 字符。"
+  },
+  "description": "ObjC 命名: 使用 3+ 字符类前缀避免冲突",
+  "kind": "rule",
+  "doClause": "Apply the ObjC 命名 pattern as described",
   "language": "objective-c",
+  "headers": [],
   "category": "Tool",
   "knowledgeType": "code-standard",
+  "usageGuide": "### 使用场景\\n触发 `@trigger` 获取ObjC 命名: 使用 3+ 字符类前缀避免冲突的标准实现模式。",
   "scope": "universal",
-  "rationale": "Objective-C 无命名空间，类前缀是避免符号冲突的唯一手段。Apple 保留 2 字符前缀（NS/UI/CG 等），三方代码应用 3+ 字符。",
   "antiPattern": {
     "bad": "@interface User : NSObject",
     "why": "ObjC 中无命名前缀的类在大型项目或依赖多库时极易命名冲突",
@@ -46,7 +54,10 @@ description: Objective-C 业界最佳实践参考。涵盖命名前缀、属性
   },
   "reasoning": {
     "whyStandard": "Google ObjC Style Guide 明确要求 3+ 字符前缀，Apple 2 字符已被系统框架保留",
-    "sources": ["Google Objective-C Style Guide", "Apple Coding Guidelines for Cocoa"],
+    "sources": [
+      "Google Objective-C Style Guide",
+      "Apple Coding Guidelines for Cocoa"
+    ],
     "confidence": 0.95
   }
 }
@@ -89,12 +100,20 @@ description: Objective-C 业界最佳实践参考。涵盖命名前缀、属性
 ```json
 {
   "title": "ObjC 属性: NSString 必须用 copy",
-  "code": "// ✅ 正确: NSString 属性用 copy\n@interface ABCUser : NSObject\n@property (nonatomic, copy) NSString *name;\n@property (nonatomic, copy) NSArray<NSString *> *tags;\n@property (nonatomic, weak) id<ABCUserDelegate> delegate;\n@property (nonatomic, strong) ABCProfile *profile;\n@end\n\n// ❌ 危险: NSString 属性用 strong\n@property (nonatomic, strong) NSString *name;\n// 如果传入 NSMutableString 并之后修改:\n// NSMutableString *m = [NSMutableString stringWithString:@\"Alice\"];\n// user.name = m;\n// [m appendString:@\" (hacked)\"];\n// user.name 会变成 \"Alice (hacked)\"!",
+  "content": {
+    "markdown": "## ObjC 属性: NSString 必须用 copy\n\n### 标准模式\n```objective-c\n// ✅ 正确: NSString 属性用 copy\n@interface ABCUser : NSObject\n@property (nonatomic, copy) NSString *name;\n@property (nonatomic, copy) NSArray<NSString *> *tags;\n@property (nonatomic, weak) id<ABCUserDelegate> delegate;\n@property (nonatomic, strong) ABCProfile *profile;\n@end\n\n// ❌ 危险: NSString 属性用 strong\n@property (nonatomic, strong) NSString *name;\n// 如果传入 NSMutableString 并之后修改:\n// NSMutableString *m = [NSMutableString stringWithString:@\"Alice\"];\n// user.name = m;\n// [m appendString:@\" (hacked)\"];\n// user.name 会变成 \"Alice (hacked)\"!\n```",
+    "pattern": "// ✅ 正确: NSString 属性用 copy\n@interface ABCUser : NSObject\n@property (nonatomic, copy) NSString *name;\n@property (nonatomic, copy) NSArray<NSString *> *tags;\n@property (nonatomic, weak) id<ABCUserDelegate> delegate;\n@property (nonatomic, strong) ABCProfile *profile;\n@end\n\n// ❌ 危险: NSString 属性用 strong\n@property (nonatomic, strong) NSString *name;\n// 如果传入 NSMutableString 并之后修改:\n// NSMutableString *m = [NSMutableString stringWithString:@\"Alice\"];\n// user.name = m;\n// [m appendString:@\" (hacked)\"];\n// user.name 会变成 \"Alice (hacked)\"!",
+    "rationale": "copy 语义保证属性值不会被外部 mutable 子类修改，是 Cocoa 编程的基础安全准则"
+  },
+  "description": "ObjC 属性: NSString 必须用 copy",
+  "kind": "pattern",
+  "doClause": "Apply the ObjC 属性 pattern as described",
   "language": "objective-c",
+  "headers": [],
   "category": "Model",
   "knowledgeType": "best-practice",
+  "usageGuide": "### 使用场景\\n触发 `@trigger` 获取ObjC 属性: NSString 必须用 copy的标准实现模式。",
   "scope": "universal",
-  "rationale": "copy 语义保证属性值不会被外部 mutable 子类修改，是 Cocoa 编程的基础安全准则",
   "antiPattern": {
     "bad": "@property (nonatomic, strong) NSString *title;",
     "why": "如果外部传入 NSMutableString 并修改，strong 引用会看到变化",
@@ -102,7 +121,10 @@ description: Objective-C 业界最佳实践参考。涵盖命名前缀、属性
   },
   "reasoning": {
     "whyStandard": "Apple Memory Management Guide 和 Google ObjC Style Guide 都要求对值类型集合用 copy",
-    "sources": ["Apple Memory Management Programming Guide", "Google Objective-C Style Guide"],
+    "sources": [
+      "Apple Memory Management Programming Guide",
+      "Google Objective-C Style Guide"
+    ],
     "confidence": 0.95
   }
 }
@@ -423,3 +445,4 @@ if ([NSThread isMainThread]) {
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考
+- **autosnippet-reference-dart**: Dart (Flutter) 业界最佳实践参考