API翻译
- 作者仓库星标 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
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- Shell 执行
- 网络行为
- 允许外网请求
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: axiom-integration
description: Use when integrating ANY iOS system feature - Siri, Shortcuts, widgets, IAP, localization, priva…
category: 通用
runtime: 无特殊运行时
---
# axiom-integration 输出预览
## PART A: 任务判断
- 适用问题:通用任务拆解、检查和交付。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“Quick Reference / Decision Tree / Cross-Domain Routing”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于通用任务拆解、检查和交付,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“Quick Reference / Decision Tree / Cross-Domain Routing”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、执行终端命令、会按任务需要访问外部网络、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件、执行终端命令;会按任务需要访问外部网络;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 原文没有稳定的斜杠命令要求。安装验证后通常全局生效,直接在对话里点名这个 Skill 并描述任务即可。
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件、执行终端命令。
先用一个小任务确认它会围绕“Quick Reference / Decision Tree / Cross-Domain Routing”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: axiom-integration
description: Use when integrating ANY iOS system feature - Siri, Shortcuts, widgets, IAP, localization, priva…
category: 通用
source: CharlesWiltgen/Axiom
---
# axiom-integration
## 什么时候使用
- 为 iOS 系统能力接入梳理框架、权限与审核细节 覆盖 Siri、Shortcuts、WidgetKit、StoreKit 等常见场景 实现时指向专项参考,帮助 Agent 选对 API 与流程 适合 Claude Code、Curso…
- 面向通用任务拆解、检查和交付,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「Quick Reference / Decision Tree / Cross-Domain Routing」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件、执行终端命令;会按任务需要访问外部网络;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "axiom-integration" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> Quick Reference / Decision Tree / Cross-Domain Routing
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件、执行终端命令 | 会按任务需要访问外部网络
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} iOS System Integration
You MUST use this skill for ANY iOS system integration including Siri, Shortcuts, widgets, in-app purchases, background tasks, push notifications, and more.
Quick Reference
| Symptom / Task | Reference |
|---|---|
| Siri, App Intents, entity queries | See skills/app-intents-ref.md |
| App Shortcuts, phrases, Spotlight | See skills/app-shortcuts-ref.md |
| App discoverability strategy | See skills/app-discoverability.md |
| Core Spotlight indexing | See skills/core-spotlight-ref.md |
| LLM search over app content, SpotlightSearchTool | See skills/core-spotlight-ref.md |
| Widgets, Control Center controls | See skills/extensions-widgets.md |
| Widget API reference | See skills/extensions-widgets-ref.md |
| Live Activities, Dynamic Island, push-to-start, broadcast | See skills/live-activities.md |
| Live Activities / ActivityKit API reference | See skills/live-activities-ref.md |
| Apple Pay (physical goods, services, donations) | Use axiom-payments instead |
| In-app purchases, subscriptions | See skills/in-app-purchases.md |
| StoreKit 2 API reference | See skills/storekit-ref.md |
| Commitment billing plans, subscription bundles/suites, group/volume subscriptions, retention offers, offer codes | See skills/storekit-ref.md |
| In-game content (Unity plug-ins, asset packs + IAP) | See skills/in-app-purchases.md, skills/background-assets.md |
| Calendar events, reminders (EventKit) | See skills/eventkit.md |
| EventKit API reference | See skills/eventkit-ref.md |
| Contacts, contact picker | See skills/contacts.md |
| Contacts API reference | See skills/contacts-ref.md |
| Localization, String Catalogs | See skills/localization.md |
| Apple terminology matching, glossary, pseudolocalization, TMS | See skills/localization-research-ref.md |
| Privacy manifests, permissions UX | See skills/privacy-ux.md |
| Bluetooth/Wi-Fi accessory pairing (AccessorySetupKit, iOS 18+) | See skills/accessorysetupkit.md |
| AccessorySetupKit API (descriptor fields, events, auth-settings flow) | See skills/accessorysetupkit-ref.md |
| Measure distance/direction to a paired accessory (Bluetooth Channel Sounding, iOS 27) | See skills/accessorysetupkit-ref.md (Part 7) |
| Weather data, forecasts, attribution (WeatherKit) | See skills/weatherkit.md |
| VoIP calls, CallKit, VoIP push, caller ID/blocking | See skills/callkit-livecommunicationkit.md |
| CallKit / LiveCommunicationKit / IdentityLookup API reference | See skills/callkit-livecommunicationkit-ref.md |
| AlarmKit (iOS 26+) | See skills/alarmkit-ref.md |
| Timer patterns, scheduling | See skills/timer-patterns.md |
| Timer API reference | See skills/timer-patterns-ref.md |
| Background tasks, BGTaskScheduler | See skills/background-processing.md |
| Background task debugging | See skills/background-processing-diag.md |
| Background task API reference | See skills/background-processing-ref.md |
| Background Assets (large content delivery, FM adapter shipping, Apple-hosted vs server-hosted) | See skills/background-assets.md |
| Background Assets API reference (incl. localized asset packs, Steam conversion) | See skills/background-assets-ref.md |
| On-Demand Resources migration (deprecated in 27) | See skills/background-assets.md |
| Push notifications, APNs | See skills/push-notifications.md |
| Push notification debugging | See skills/push-notifications-diag.md |
| Push notification API reference | See skills/push-notifications-ref.md |
Decision Tree
digraph integration {
start [label="Integration task" shape=ellipse];
what [label="Which system feature?" shape=diamond];
start -> what;
what -> "skills/app-intents-ref.md" [label="Siri / App Intents"];
what -> "skills/app-shortcuts-ref.md" [label="Shortcuts / phrases"];
what -> "skills/app-discoverability.md" [label="discoverability\nstrategy"];
what -> "skills/extensions-widgets.md" [label="widgets /\nControl Center"];
what -> "skills/live-activities.md" [label="Live Activities /\nDynamic Island"];
what -> "skills/in-app-purchases.md" [label="IAP / subscriptions"];
what -> "skills/eventkit.md" [label="calendar / reminders"];
what -> "skills/contacts.md" [label="contacts"];
what -> "skills/localization.md" [label="localization"];
what -> "skills/privacy-ux.md" [label="privacy / permissions"];
what -> "skills/accessorysetupkit.md" [label="accessory pairing\n(Bluetooth/Wi-Fi)"];
what -> "skills/weatherkit.md" [label="weather / forecasts"];
what -> "skills/callkit-livecommunicationkit.md" [label="VoIP calls /\ncaller ID"];
what -> "skills/alarmkit-ref.md" [label="alarms (iOS 26+)"];
what -> "skills/timer-patterns.md" [label="timers"];
what -> "skills/background-processing.md" [label="background tasks"];
what -> "skills/background-assets.md" [label="large asset delivery /\nFM adapter shipping"];
what -> "skills/push-notifications.md" [label="push notifications"];
}
- Siri / App Intents / entity queries? →
skills/app-intents-ref.md - App Shortcuts / phrases? →
skills/app-shortcuts-ref.md - App discoverability / Spotlight strategy? →
skills/app-discoverability.md,skills/core-spotlight-ref.md3a. LLM search over your app's index (SpotlightSearchTool, LanguageModelSession tool-calling)? →skills/core-spotlight-ref.md - Widgets / Control Center controls? →
skills/extensions-widgets.md,skills/extensions-widgets-ref.md4a. Live Activities / Dynamic Island / push-to-start / broadcast? →skills/live-activities.md,skills/live-activities-ref.md - In-app purchases / StoreKit? →
skills/in-app-purchases.md,skills/storekit-ref.md5a. Subscription billing plans (12-month commitment), bundles/suites, group/volume purchasing, retention offers, offer-code redemption? →skills/storekit-ref.md - Calendar / reminders / EventKit? →
skills/eventkit.md,skills/eventkit-ref.md - Contacts / contact picker? →
skills/contacts.md,skills/contacts-ref.md - Localization mechanics (String Catalogs, plurals, RTL)? →
skills/localization.md8a. Localization research (Apple terminology, glossary, pseudolocalization, TMS)? →skills/localization-research-ref.md - Privacy / permissions? →
skills/privacy-ux.md - Alarms (iOS 26+)? →
skills/alarmkit-ref.md10a. Bluetooth/Wi-Fi accessory pairing (iOS 18+)? →skills/accessorysetupkit.md10b. Weather data / forecasts / attribution (WeatherKit)? →skills/weatherkit.md10c. VoIP calls / CallKit / VoIP push / caller ID / blocking? →skills/callkit-livecommunicationkit.md - Timers? →
skills/timer-patterns.md,skills/timer-patterns-ref.md - Background tasks / BGTaskScheduler? →
skills/background-processing.md,skills/background-processing-diag.md,skills/background-processing-ref.md12a. Large asset delivery (game packs, localized asset packs, ML models, Foundation Models adapters, ODR migration)? →skills/background-assets.md,skills/background-assets-ref.md - Push notifications? →
skills/push-notifications.md,skills/push-notifications-diag.md,skills/push-notifications-ref.md - Want IAP audit? → Launch
iap-auditoragent - Want full IAP implementation? → Launch
iap-implementationagent - Camera / photos / audio / haptics / ShazamKit? → Use
axiom-mediainstead
Cross-Domain Routing
Widget + data sync (widget not showing updated data):
- Widget timeline not refreshing → stay here (extensions-widgets)
- SwiftData/Core Data not shared with extension → also invoke axiom-data (App Groups)
App Intents + security (lock-screen intent risk, prompt injection via Siri):
- Intent/schema API surface → stay here (app-intents-ref)
- Threat modeling, authenticationPolicy gating, schema risk metadata → also invoke axiom-security (skills/agentic-security.md)
Live Activity + push notification:
- ActivityKit push token / broadcast setup → stay here (live-activities)
- Push delivery failures → also invoke axiom-networking (networking-diag)
- Entitlements/certificates → also invoke axiom-build
VoIP push + CallKit (VoIP app killed / pushes stopped arriving):
- VoIP push must report a call to CallKit → stay here (callkit-livecommunicationkit, Part 1)
- PushKit token vs APNs delivery → stay here (push-notifications for the APNs contrast)
- Call audio silent/misrouted → also invoke axiom-media (AVAudioSession category)
Push + background processing (silent push not triggering background work):
- Push payload and delivery → stay here (push-notifications-diag)
- BGTaskScheduler execution → stay here (background-processing)
In-game content (StoreKit + Background Assets, Unity plug-ins):
- Asset packs, IAP mechanics, payment sheet, mock server → stay here (background-assets, in-app-purchases)
- Game input, rendering, game-side performance → also invoke axiom-games / axiom-graphics
Calendar/Contacts + data sync:
- EventKit/Contacts data issues → stay here
- Shared data with widget via App Groups → also invoke axiom-data
watchOS surfaces
- Complications + Smart Stack widgets → See axiom-watchos (skills/smart-stack-and-complications.md)
- Live Activities on Apple Watch → See axiom-watchos (skills/controls-and-live-activities.md)
Conflict Resolution
integration vs axiom-build: When system features fail with entitlement/certificate errors:
- Use axiom-build for signing and provisioning issues
- Use integration for API usage and permission patterns
integration vs axiom-data: When widgets or extensions can't access shared data:
- App Groups and shared containers → axiom-data
- Specifically: GRDB/SQLite database shared with widget/extension/Live Activity → See axiom-data (skills/grdb-app-groups.md)
- Widget timeline, Live Activity updates → integration
integration vs axiom-media: When media features overlap with system features:
- Camera/photo/audio/haptics code → axiom-media
- Privacy manifests for camera/microphone → stay here (privacy-ux)
- Background audio mode → stay here (background-processing)
Anti-Rationalization
| Thought | Reality |
|---|---|
| "App Intents are just a protocol conformance" | App Intents have parameter validation, entity queries, and background execution. |
| "Widgets are simple, I've done them before" | Widgets have timeline, interactivity, and Live Activity patterns that evolve yearly. |
| "Localization is just String Catalogs" | Xcode 26 has type-safe localization, generated symbols, and #bundle macro. |
| "Push notifications are just a payload and a token" | Token lifecycle, Focus levels, service extension gotchas cause 80% of push bugs. |
| "I'll just bundle the assets, it's simpler" | Bundling ≥10 MB inflates first-install size and pays the cost every update. Background Assets ships with App Store install-progress integration; FM adapters can't be bundled at all. See skills/background-assets.md. |
| "I'll use URLSession for the asset download" | URLSession doesn't integrate with App Store install progress, charging-aware scheduling, or per-app quota — and can't reach Apple-hosted asset packs at all. Background Assets is the supported channel. |
| "On-Demand Resources still works fine" | The entire NSBundleResourceRequest family is deprecated in the 27 SDKs ("Use Background Assets instead"). Migrate ODR tags to asset packs. See skills/background-assets.md. |
| "Just request full Calendar access" | Most apps only need to add events — EventKitUI does that with zero permissions. |
| "I'll request Bluetooth permission and scan for the accessory" | AccessorySetupKit (iOS 18+) pairs in one tap with no broad Bluetooth prompt and grants scoped BT+Wi-Fi access. See skills/accessorysetupkit.md. |
| "I'll process the VoIP push, then report the call when ready" | iOS terminates your app and stops delivering VoIP pushes if a push doesn't report a call before completion. Report first, fetch after. See skills/callkit-livecommunicationkit.md. |
| "I'll activate the audio session when the call connects" | CallKit owns the audio session — activate only in provider(_:didActivate:) or audio is silent/misrouted. See skills/callkit-livecommunicationkit.md. |
| "I'll use CNContactStore directly for picking" | CNContactPickerViewController needs no authorization and shows all contacts. |
Example Invocations
User: "How do I add Siri support?"
→ Read: skills/app-intents-ref.md
User: "My widget isn't updating"
→ Read: skills/extensions-widgets.md
User: "My Live Activity won't update" / "How do I add a Dynamic Island?" / "Broadcast scores to thousands of Live Activities"
→ Read: skills/live-activities.md
User: "Implement in-app purchases with StoreKit 2"
→ Read: skills/in-app-purchases.md
User: "Offer a monthly plan with a 12-month commitment" / "Sell subscription seats to teams"
→ Read: skills/storekit-ref.md
User: "Deliver level packs only in the player's language" / "Convert my Steam depots to asset packs"
→ Read: skills/background-assets-ref.md
User: "Let the on-device model answer questions about my app's content"
→ Read: skills/core-spotlight-ref.md
User: "How do I implement push notifications?"
→ Read: skills/push-notifications.md
User: "Push notifications work in dev but not production"
→ Read: skills/push-notifications-diag.md
User: "My background task never runs"
→ Read: skills/background-processing-diag.md
User: "How do I add an event to the user's calendar?"
→ Read: skills/eventkit.md
User: "How do I let users pick a contact?"
→ Read: skills/contacts.md
User: "How do I pair a Bluetooth accessory without the permission prompt?"
→ Read: skills/accessorysetupkit.md
User: "How do I show the weather forecast with WeatherKit?" / "Why was my weather app rejected?"
→ Read: skills/weatherkit.md
User: "My VoIP app gets killed" / "How do I handle CallKit incoming calls?" / "How do I block spam callers?"
→ Read: skills/callkit-livecommunicationkit.md
User: "Review my in-app purchase implementation"
→ Launch: iap-auditor agent
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核