Back to Details

axiom-ios-data

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

iOS Data & Persistence Router

iOS 数据与持久化路由

You MUST use this skill for ANY data persistence, database, axiom-storage, CloudKit, or serialization work.
任何涉及数据持久化、数据库、axiom-storage、CloudKit或序列化的工作，都必须使用此技能。

When to Use

适用场景

Use this router when working with:
  • Databases (SwiftData, Core Data, GRDB, SQLiteData)
  • Schema migrations
  • CloudKit sync
  • File storage (iCloud Drive, local storage)
  • Data serialization (Codable, JSON)
  • Storage strategy decisions
在处理以下内容时使用此路由：
  • 数据库（SwiftData、Core Data、GRDB、SQLiteData）
  • 架构迁移
  • CloudKit同步
  • 文件存储（iCloud Drive、本地存储）
  • 数据序列化（Codable、JSON）
  • 存储策略决策

Routing Logic

路由逻辑

SwiftData

SwiftData

Working with SwiftData → 
/skill axiom-swiftdata
Schema migration → 
/skill axiom-swiftdata-migration
Migration issues → 
/skill axiom-swiftdata-migration-diag
Migrating from Realm → 
/skill axiom-realm-migration-ref
SwiftData vs SQLiteData → 
/skill axiom-sqlitedata-migration
使用SwiftData进行开发 → 
/skill axiom-swiftdata
架构迁移 → 
/skill axiom-swiftdata-migration
迁移问题排查 → 
/skill axiom-swiftdata-migration-diag
从Realm迁移 → 
/skill axiom-realm-migration-ref
SwiftData 对比 SQLiteData → 
/skill axiom-sqlitedata-migration

Other Databases

其他数据库

GRDB queries → 
/skill axiom-grdb
SQLiteData → 
/skill axiom-sqlitedata
Advanced SQLiteData → 
/skill axiom-sqlitedata-ref
Core Data patterns → 
/skill axiom-core-data
Core Data issues → 
/skill axiom-core-data-diag
GRDB 查询 → 
/skill axiom-grdb
SQLiteData → 
/skill axiom-sqlitedata
高级SQLiteData → 
/skill axiom-sqlitedata-ref
Core Data 模式 → 
/skill axiom-core-data
Core Data 问题排查 → 
/skill axiom-core-data-diag

Migrations

迁移

Database migration safety → 
/skill axiom-database-migration
(critical - prevents data loss)
数据库迁移安全性 → 
/skill axiom-database-migration
（至关重要 - 防止数据丢失）

Serialization

序列化

Codable issues → 
/skill axiom-codable
Codable 问题 → 
/skill axiom-codable

Cloud Storage

云存储

Cloud sync patterns → 
/skill axiom-cloud-sync
CloudKit → 
/skill axiom-cloudkit-ref
iCloud Drive → 
/skill axiom-icloud-drive-ref
Cloud sync errors → 
/skill axiom-cloud-sync-diag
云同步模式 → 
/skill axiom-cloud-sync
CloudKit → 
/skill axiom-cloudkit-ref
iCloud Drive → 
/skill axiom-icloud-drive-ref
云同步错误排查 → 
/skill axiom-cloud-sync-diag

File Storage

文件存储

Storage strategy → 
/skill axiom-storage
Storage issues → 
/skill axiom-storage-diag
Storage management → 
/skill axiom-storage-management-ref
File protection → 
/skill axiom-file-protection-ref
存储策略 → 
/skill axiom-storage
存储问题排查 → 
/skill axiom-storage-diag
存储管理 → 
/skill axiom-storage-management-ref
文件保护 → 
/skill axiom-file-protection-ref

Decision Tree

决策树

  1. SwiftData? → swiftdata, swiftdata-migration
  2. Core Data? → core-data, core-data-diag
  3. GRDB? → grdb
  4. SQLiteData? → sqlitedata, sqlitedata-ref
  5. ANY schema migration? → database-migration (ALWAYS — prevents data loss)
  6. Realm migration? → realm-migration-ref
  7. SwiftData vs SQLiteData? → sqlitedata-migration
  8. Cloud sync architecture? → cloud-sync
  9. CloudKit? → cloudkit-ref
  10. iCloud Drive? → icloud-drive-ref
  11. Cloud sync errors? → cloud-sync-diag
  12. Codable/JSON serialization? → codable
  13. File storage strategy? → storage, storage-diag, storage-management-ref
  14. File protection? → file-protection-ref
  1. 是否使用SwiftData？→ swiftdata, swiftdata-migration
  2. 是否使用Core Data？→ core-data, core-data-diag
  3. 是否使用GRDB？→ grdb
  4. 是否使用SQLiteData？→ sqlitedata, sqlitedata-ref
  5. 是否涉及任何架构迁移？→ database-migration（必须使用 — 防止数据丢失）
  6. 是否是Realm迁移？→ realm-migration-ref
  7. 需要对比SwiftData与SQLiteData？→ sqlitedata-migration
  8. 云同步架构相关？→ cloud-sync
  9. 是否使用CloudKit？→ cloudkit-ref
  10. 是否使用iCloud Drive？→ icloud-drive-ref
  11. 云同步出错？→ cloud-sync-diag
  12. Codable/JSON序列化相关？→ codable
  13. 文件存储策略相关？→ storage, storage-diag, storage-management-ref
  14. 文件保护相关？→ file-protection-ref

Anti-Rationalization

常见误区纠正

ThoughtReality
"Just adding a column, no migration needed"Schema changes without migration crash users. database-migration prevents data loss.
"I'll handle the migration manually"Manual migrations miss edge cases. database-migration covers rollback and testing.
"Simple query, I don't need the skill"Query patterns prevent N+1 and thread-safety issues. The skill has copy-paste solutions.
"CloudKit sync is straightforward"CloudKit has 15+ failure modes. cloud-sync-diag diagnoses them systematically.
"I know Codable well enough"Codable has silent data loss traps (try? swallows errors). codable skill prevents production bugs.
错误想法实际情况
"只是添加一个字段，不需要迁移"未进行迁移的架构变更会导致用户应用崩溃。database-migration技能可防止数据丢失。
"我会手动处理迁移"手动迁移会遗漏边缘场景。database-migration技能涵盖回滚和测试环节。
"只是简单查询，不需要用这个技能"规范的查询模式可避免N+1查询和线程安全问题。该技能提供可直接复制使用的解决方案。
"CloudKit同步很简单"CloudKit有15种以上的失败模式。cloud-sync-diag技能可系统排查这些问题。
"我对Codable已经很熟悉了"Codable存在静默数据丢失的陷阱（比如try?会掩盖错误）。codable技能可避免生产环境中的bug。

Critical Pattern: Migrations

关键模式：迁移

ALWAYS invoke 
/skill axiom-database-migration
when adding/modifying database columns.
This prevents:
  • "FOREIGN KEY constraint failed" errors
  • "no such column" crashes
  • Data loss from unsafe migrations
在添加或修改数据库字段时，必须调用 
/skill axiom-database-migration
。
这可防止：
  • "FOREIGN KEY constraint failed"（外键约束失败）错误
  • "no such column"（无此列）崩溃
  • 不安全迁移导致的数据丢失

Example Invocations

调用示例

User: "I need to add a column to my SwiftData model" → Invoke: 
/skill axiom-database-migration
(critical - prevents data loss)
User: "How do I query SwiftData with complex filters?" → Invoke: 
/skill axiom-swiftdata
User: "CloudKit sync isn't working" → Invoke: 
/skill axiom-cloud-sync-diag
User: "Should I use SwiftData or SQLiteData?" → Invoke: 
/skill axiom-sqlitedata-migration
用户："我需要在SwiftData模型中添加一个字段" → 调用：
/skill axiom-database-migration
（至关重要 - 防止数据丢失）
用户："如何使用复杂过滤器查询SwiftData？" → 调用：
/skill axiom-swiftdata
用户："CloudKit同步无法正常工作" → 调用：
/skill axiom-cloud-sync-diag
用户："我应该用SwiftData还是SQLiteData？" → 调用：
/skill axiom-sqlitedata-migration