数据迁移
- 作者仓库星标 977
- 叉子 74
- 许可证 MIT
- 作者更新于 2026年6月15日 03:09
- 作者仓库 Axiom
- 领域
- 通用
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 94 / 100 · 已通过审计
- 作者 / 版本 / 许可
- @CharlesWiltgen · MIT
- Token 消耗评级
- 中等消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明（默认跨平台）
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。
需要注意： 未限定 allowed-tools，默认拥有全部工具权限。
---
name: axiom-data
description: Use when working with ANY data persistence, database, storage, CloudKit, migration, or serializa…
category: 通用
runtime: 无特殊运行时
---
# axiom-data 输出预览
## PART A: 任务判断
- 适用问题：通用任务拆解、检查和交付。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“When to Use / Quick Reference / Automated Scanning”读取原文规则，不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于通用任务拆解、检查和交付，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“When to Use / Quick Reference / Automated Scanning”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件；主要在本地完成；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。原文出现了 `/axiom`、`/skill` 这类斜杠命令；如果你的 Agent 支持命令触发，优先用命令开场，再补充目标和边界。
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是：读取文件、写入/修改文件。
先用一个小任务确认它会围绕“When to Use / Quick Reference / Automated Scanning”工作；涉及文件或命令时，先看 diff、日志、预览或测试结果。
检查最终产物是否包含明确结果、必要证据和下一步动作；如果输出泛泛而谈，就补充输入、边界和验收标准后重跑。
---
name: axiom-data
description: Use when working with ANY data persistence, database, storage, CloudKit, migration, or serializa…
category: 通用
source: CharlesWiltgen/Axiom
---
# axiom-data
## 什么时候使用
- axiom-data 是一个通用扩展技能，按 SKILL 适合处理通用任务拆解、检查、交付和复盘，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要…
- 面向通用任务拆解、检查和交付，优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「When to Use / Quick Reference / Automated Scanning」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件；主要在本地完成；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。
skill "axiom-data" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> When to Use / Quick Reference / Automated Scanning
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
}Data & Persistence
You MUST use this skill for ANY data persistence, database, storage, CloudKit, or serialization work.
When to Use
Use this skill 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
- Keychain / secure credential storage
- Encryption, signing, key management (CryptoKit)
Quick Reference
| Symptom / Task | Reference |
|---|---|
SwiftData @Model, @Query, ModelContext, sectioned queries / ResultsObserver / @Attribute(.codable) / dynamic compound predicates (OS27) |
See skills/swiftdata.md |
| SwiftData schema migration, VersionedSchema | See skills/swiftdata-migration.md |
| SwiftData migration crashes, data loss | See skills/swiftdata-migration-diag.md |
| Migrating from Realm to SwiftData | See skills/realm-migration-ref.md |
| SwiftData vs SQLiteData decision | See skills/sqlitedata-migration.md |
| GRDB queries, ValueObservation, DatabaseMigrator | See skills/grdb.md |
| GRDB performance, indexes, EXPLAIN QUERY PLAN, cursors | See skills/grdb-performance.md |
| Full-text search (FTS5) in GRDB or SQLiteData | See skills/sqlite-fts-ref.md |
| Storing or querying JSON inside a SQLite column (JSON1, JSONB) | See skills/sql-json-ref.md |
| GRDB shared across app + widget/extension (App Group) | See skills/grdb-app-groups.md |
| SQLiteData @Table, CRUD, SyncEngine | See skills/sqlitedata.md |
| SQLiteData advanced patterns, CTEs, views | See skills/sqlitedata-ref.md |
| Core Data stack, relationships, concurrency | See skills/core-data.md |
| Core Data migration crashes, thread errors | See skills/core-data-diag.md |
| ANY schema migration safety | See skills/database-migration.md |
| Codable, JSON encoding/decoding | See skills/codable.md |
| Cloud sync architecture, offline-first | See skills/cloud-sync.md |
| CloudKit, CKSyncEngine, CKRecord | See skills/cloudkit-ref.md |
| iCloud Drive, ubiquitous containers | See skills/icloud-drive-ref.md |
| Cloud sync errors, conflict resolution | See skills/cloud-sync-diag.md |
| Storage strategy, where to store data | See skills/storage.md |
| Storage issues, files disappeared | See skills/storage-diag.md |
| Storage management, disk pressure | See skills/storage-management-ref.md |
| Keychain / secure credential storage | See axiom-security (skills/keychain.md) |
| Keychain errors (errSecDuplicateItem) | See axiom-security (skills/keychain-diag.md) |
| Keychain API reference | See axiom-security (skills/keychain-ref.md) |
| Encryption / signing / key management | See axiom-security (skills/cryptokit.md) |
| CryptoKit API reference | See axiom-security (skills/cryptokit-ref.md) |
| File protection, NSFileProtection | See axiom-security (skills/file-protection-ref.md) |
| tvOS data persistence (no local storage) | See axiom-swift (skills/tvos.md) |
| tvOS + CloudKit SyncEngine | See skills/sqlitedata.md |
Automated Scanning
Core Data audit → Launch core-data-auditor agent or /axiom:audit core-data (safety violations, architectural gaps — migration options, thread-confinement, N+1 queries, merge policies, context isolation)
Codable audit → Launch codable-auditor agent or /axiom:audit codable (safety violations, semantic gaps — try? swallowing errors, JSONSerialization, date handling, silent field drops, wrapper-hidden fallbacks, cross-file strategy drift, enum future-case crashes)
iCloud audit → Launch icloud-auditor agent or /axiom:audit icloud (entitlement checks, file coordination, incomplete CKError matrix coverage, missing account-change observation, polling vs CKSubscriptions, SwiftData + CloudKit unsupported features, compound risks like uncoordinated I/O across extensions)
Storage audit → Launch storage-auditor agent or /axiom:audit storage (wrong file locations, missing backup exclusions, sensitive data on disk vs Keychain, missing App Group containers, unbounded cache growth, orphan files, compound risks like user data in tmp/ + critical content)
Database schema audit → Launch database-schema-auditor agent or /axiom:audit database-schema (unsafe ALTER TABLE, DROP operations, missing idempotency, FK constraints declared but not enforced, incomplete upgrade paths, compound risks like INSERT OR REPLACE on FK-referenced tables)
GRDB performance audit → Launch grdb-performance-auditor agent or /axiom:audit grdb-performance (raw SQL string interpolation, missing FK indexes in raw SQL, missing PRAGMA optimize for raw-GRDB apps, journal mode mismatch for app-group DBs, missing observesSuspensionNotifications for shared DBs, prefix-redundant indexes in raw SQL, legacy Record subclass)
SwiftData audit → Launch swiftdata-auditor agent or /axiom:audit swiftdata (struct models, missing schema registration, array relationships without defaults, background context misuse, N+1 patterns, stale predicates, CloudKit conformance gaps, compound risks like struct model + array relationship)
Decision Tree
- SwiftData? →
skills/swiftdata.md,skills/swiftdata-migration.md - Core Data? →
skills/core-data.md,skills/core-data-diag.md - GRDB? →
skills/grdb.md3a. GRDB perf, slow query, schema design for perf? →skills/grdb-performance.md3b. FTS5 (full-text search, any layer)? →skills/sqlite-fts-ref.md3c. DB shared across app + extension/widget/Live Activity? →skills/grdb-app-groups.md - SQLiteData? →
skills/sqlitedata.md,skills/sqlitedata-ref.md - ANY schema migration? →
skills/database-migration.md(ALWAYS — prevents data loss) - Realm migration? →
skills/realm-migration-ref.md - SwiftData vs SQLiteData? →
skills/sqlitedata-migration.md - Cloud sync architecture? →
skills/cloud-sync.md - CloudKit? →
skills/cloudkit-ref.md - iCloud Drive? →
skills/icloud-drive-ref.md - Cloud sync errors? →
skills/cloud-sync-diag.md - Codable/JSON serialization? →
skills/codable.md - File storage strategy? →
skills/storage.md,skills/storage-diag.md,skills/storage-management-ref.md - File protection? → See axiom-security (skills/file-protection-ref.md)
- Keychain / storing tokens, passwords, secrets securely? → See axiom-security (skills/keychain.md), See axiom-security (skills/keychain-diag.md), See axiom-security (skills/keychain-ref.md)
- SecItem errors (errSecDuplicateItem, errSecItemNotFound, errSecInteractionNotAllowed)? → See axiom-security (skills/keychain-diag.md)
- Encryption, signing, Secure Enclave, CryptoKit? → See axiom-security (skills/cryptokit.md), See axiom-security (skills/cryptokit-ref.md)
- Quantum-secure cryptography, HPKE, ML-KEM? → See axiom-security (skills/cryptokit.md)
- Want Core Data safety scan? → core-data-auditor (Agent)
- Want Codable anti-pattern scan? → codable-auditor (Agent)
- Want iCloud sync audit? → icloud-auditor (Agent)
- Want storage location audit? → storage-auditor (Agent)
- Want database schema/migration safety scan? → database-schema-auditor (Agent) 23a. Want GRDB performance/app-group scan? → grdb-performance-auditor (Agent)
- Want SwiftData code audit? → swiftdata-auditor (Agent)
- tvOS data persistence? → See axiom-swift (skills/tvos.md) (CRITICAL: no persistent local storage) +
skills/sqlitedata.md(CloudKit SyncEngine) - SwiftData @MainActor / background context threading? →
/skill axiom-concurrency - Structured data generation with Foundation Models? →
/skill axiom-ai
Sync patterns
- HealthKit anchored/observer queries as a generalizable change-tracking pattern → See axiom-health (skills/sync-and-background.md)
Anti-Rationalization
| Thought | Reality |
|---|---|
| "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. |
| "I'll use local storage on tvOS" | tvOS has NO persistent local storage. System deletes Caches at any time. See axiom-swift (skills/tvos.md) for the iCloud-first pattern. |
| "UserDefaults is fine for this token" | UserDefaults is unencrypted, backed up to iCloud, and visible to MDM profiles. One audit catches it. keychain stores tokens securely. |
| "I'll encrypt it myself with CommonCrypto" | CryptoKit replaced CommonCrypto's buffer-management nightmares with one-line APIs. cryptokit prevents misuse. |
Critical Pattern: Migrations
ALWAYS read skills/database-migration.md when adding/modifying database columns.
This prevents:
- "FOREIGN KEY constraint failed" errors
- "no such column" crashes
- Data loss from unsafe migrations
Example Invocations
User: "I need to add a column to my SwiftData model"
→ Read: skills/database-migration.md (critical - prevents data loss)
User: "How do I query SwiftData with complex filters?"
→ Read: skills/swiftdata.md
User: "CloudKit sync isn't working"
→ Read: skills/cloud-sync-diag.md
User: "Should I use SwiftData or SQLiteData?"
→ Read: skills/sqlitedata-migration.md
User: "Check my Core Data code for safety issues"
→ Launch: core-data-auditor agent
User: "Scan for Codable anti-patterns before release"
→ Launch: codable-auditor agent
User: "Audit my iCloud sync implementation"
→ Launch: icloud-auditor agent
User: "Check if my files are stored in the right locations"
→ Launch: storage-auditor agent
User: "Audit my database migrations for safety"
→ Launch: database-schema-auditor agent
User: "How do I make my GRDB queries faster?"
→ Read: skills/grdb-performance.md
User: "Add search to my GRDB-backed app" / "Add search to SQLiteData app"
→ Read: skills/sqlite-fts-ref.md
User: "My widget needs to read the same database as the app"
→ Read: skills/grdb-app-groups.md
User: "My widget shows stale data from the database"
→ Read: skills/grdb-app-groups.md
User: "Audit my GRDB code for performance issues"
→ Launch: grdb-performance-auditor agent
User: "Check my SwiftData models for issues"
→ Launch: swiftdata-auditor agent
User: "How do I persist data on tvOS?"
→ Invoke: See axiom-swift (skills/tvos.md) + Read: skills/sqlitedata.md
User: "My tvOS app loses data between launches" → Invoke: See axiom-swift (skills/tvos.md)
User: "How do I store an auth token securely?" → Invoke: See axiom-security (skills/keychain.md)
User: "errSecDuplicateItem but I checked and the item doesn't exist" → Invoke: See axiom-security (skills/keychain-diag.md)
User: "How do I encrypt data with AES in Swift?" → Invoke: See axiom-security (skills/cryptokit.md)
User: "I need to sign data with the Secure Enclave" → Invoke: See axiom-security (skills/cryptokit.md)
User: "What's ML-KEM and should I use it?" → Invoke: See axiom-security (skills/cryptokit.md)
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核