axiom-swift
Use when reviewing Swift code for modern idioms, working with noncopyable types, implementing drag and drop, adding debug deep links, or building for tvOS.
CharlesWiltgen · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add CharlesWiltgen/Axiom --skill axiom-swift技能说明
name: axiom-swift description: Use when reviewing Swift code for modern idioms, working with noncopyable types, implementing drag and drop, adding debug deep links, or building for tvOS. license: MIT
Swift Language & Platform
You MUST use this skill for ANY Swift idiom review, ownership/noncopyable types, Transferable/drag-and-drop, debug deep links, or tvOS development.
Not on Claude Code? Where this router says "Launch
some-auditoragent", read that auditor's file in this suite and follow it inline — the same procedure, needing only file search and read.Available here:
skills/swift-simplifier.md.Agents that need Bash — builds, tests, simulators, crash symbolication — stay Claude Code-only; there is no inline equivalent for those.
Quick Reference
| Symptom / Task | Reference |
|---|---|
| Outdated Swift patterns (Date(), CGFloat, DateFormatter) | See skills/swift-modern.md |
| Foundation modernization (FormatStyle, URL.documentsDirectory) | See skills/swift-modern.md |
| Common Claude hallucinations in Swift code | See skills/swift-modern.md |
Swift 6.4 idioms — anyAppleOS, weak let, ~Sendable (OS27) | See skills/swift-modern.md |
| Noncopyable types (~Copyable) | See skills/ownership-conventions.md |
| borrowing/consuming parameter ownership | See skills/ownership-conventions.md |
InlineArray, Span, value generics; Swift 6.4 borrow/mutate accessors (OS27) | See skills/ownership-conventions.md |
| Reducing ARC overhead | See skills/ownership-conventions.md |
| Drag and drop (.draggable, .dropDestination) | See skills/transferable-ref.md |
| Copy/paste (.copyable, PasteButton) | See skills/transferable-ref.md |
| ShareLink, content sharing | See skills/transferable-ref.md |
| Custom UTType declarations | See skills/transferable-ref.md |
| TransferRepresentation choices | See skills/transferable-ref.md |
| Debug-only deep links for simulator testing | See skills/deep-link-debugging.md |
| Navigate to specific screens for screenshots | See skills/deep-link-debugging.md |
| tvOS Focus Engine, Siri Remote input | See skills/tvos.md |
| tvOS storage constraints (no Documents dir) | See skills/tvos.md |
| tvOS text input, AVPlayer tuning | See skills/tvos.md |
| TVUIKit components | See skills/tvos.md |
| Simplify Swift for clarity (behavior-preserving cleanups) | swift-simplifier agent — /axiom:audit swift-simplify |
Decision Tree
digraph swift {
start [label="Swift task" shape=ellipse];
what [label="What do you need?" shape=diamond];
start -> what;
what -> "skills/swift-modern.md" [label="modern idioms,\noutdated patterns,\nFoundation APIs"];
what -> "skills/ownership-conventions.md" [label="~Copyable, borrowing,\nconsuming, InlineArray,\nSpan, ARC reduction"];
what -> "skills/transferable-ref.md" [label="drag & drop, copy/paste,\nShareLink, UTTypes,\nTransferable conformance"];
what -> "skills/deep-link-debugging.md" [label="debug deep links,\nsimulator navigation,\nscreenshot automation"];
what -> "skills/tvos.md" [label="tvOS app,\nFocus Engine,\nSiri Remote, storage"];
}
- Outdated Swift patterns / modern API replacements / Claude hallucinations? ->
skills/swift-modern.md - ~Copyable / borrowing / consuming / InlineArray / Span? ->
skills/ownership-conventions.md - Drag and drop / copy/paste / ShareLink / Transferable / UTTypes? ->
skills/transferable-ref.md - Debug deep links / simulator navigation / screenshot automation? ->
skills/deep-link-debugging.md - tvOS development / Focus Engine / Siri Remote / storage / AVPlayer? ->
skills/tvos.md - Swift concurrency (async/await, actors, Sendable) ->
/skill axiom-concurrency - Swift performance (COW, ARC, generics optimization) -> See axiom-performance (skills/swift-performance.md)
- Codable patterns (JSON, CodingKeys, enum serialization) -> See axiom-data (skills/codable.md)
- Simplify Swift for clarity (guard/optional cleanups, if/switch expressions, boilerplate)? ->
swift-simplifieragent (/axiom:audit swift-simplify)
Conflict Resolution
swift vs concurrency: When Swift 6 concurrency errors appear:
- Use concurrency, NOT swift -- Concurrency errors are actor isolation / Sendable issues.
skills/swift-modern.mdcovers concurrency posture (defaults), but detailed patterns live in axiom-concurrency.
swift vs performance: When optimizing Swift code:
- Use swift for ownership if the question is borrowing/consuming/~Copyable/InlineArray/Span ->
skills/ownership-conventions.md - Use performance if the question is COW, ARC profiling, generic specialization, or Instruments workflows -> axiom-performance
swift vs swiftui: When implementing drag and drop or copy/paste:
- Use swift for Transferable conformance, representation choices, UTType declarations ->
skills/transferable-ref.md - Use swiftui for view-level modifiers (.draggable, .dropDestination styling, animations)
swift vs integration: When sharing content:
- ShareLink + Transferable -> use swift (
skills/transferable-ref.md) - UIActivityViewController customization, share extensions -> use integration
swift vs axiom-build: When tvOS build fails:
- Environment/Xcode issues -> use axiom-build first
- tvOS platform-specific code issues (Focus Engine, storage, no WebView) -> use swift (
skills/tvos.md)
Critical Patterns
Modern Swift Idioms (skills/swift-modern.md):
- 12+ outdated patterns Claude defaults to (Date(), CGFloat, DateFormatter, DispatchQueue.main.async)
- Foundation modernization (FormatStyle, URL.documentsDirectory, .replacing())
- SwiftUI convenience APIs Claude misses (ContentUnavailableView.search, LabeledContent)
- Swift 6.4 concurrency posture defaults
- 12 co