斯威夫特公理
- 作者仓库星标 0
- 许可证 MIT
- 作者更新于 2026年8月24日 18:29
- 作者仓库 Axiom
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @CharlesWiltgen · 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.**
<!-- AXIOM_AUDITOR_INLINE_BEGIN — rewritten for Codex by scripts/build-codex.ts; do not hand-edit -->
> **Auditors are skills here.** Where this router says "Launch `some-auditor` agent", invoke the
> matching Codex skill instead — same procedure, no Claude Code agent required.
>
> Available: `axiom-swift-simplifier`.
>
> The ones that shell out — builds, tests, simulators, crash symbolication — need shell access to run.
<!-- AXIOM_AUDITOR_INLINE_END -->
## 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-swift-simplifier` |
## Decision Tree
```dot
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"];
}
```
1. Outdated Swift patterns / modern API replacements / Claude hallucinations? -> `skills/swift-modern.md`
2. ~Copyable / borrowing / consuming / InlineArray / Span? -> `skills/ownership-conventions.md`
3. Drag and drop / copy/paste / ShareLink / Transferable / UTTypes? -> `skills/transferable-ref.md`
4. Debug deep links / simulator navigation / screenshot automation? -> `skills/deep-link-debugging.md`
5. tvOS development / Focus Engine / Siri Remote / storage / AVPlayer? -> `skills/tvos.md`
6. Swift concurrency (async/await, actors, Sendable) -> `/skill axiom-concurrency`
7. Swift performance (COW, ARC, generics optimization) -> See axiom-performance (skills/swift-performance.md)
8. Codable patterns (JSON, CodingKeys, enum serialization) -> See axiom-data (skills/codable.md)
9. Simplify Swift for clarity (guard/optional cleanups, if/switch expressions, boilerplate)? -> `swift-simplifier` agent (`axiom-swift-simplifier`)
## 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.md` covers 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 common Claude hallucinations with corrections
**Ownership & Noncopyable Types** (`skills/ownership-conventions.md`):
- borrowing/consuming parameter modifiers with 7 patterns
- ~Copyable types: FileHandle pattern, limitations table, common compiler errors
- InlineArray: fixed-size stack-allocated arrays with value generics
- Span family: safe contiguous memory access replacing UnsafeBufferPointer
- Decision tree for when ownership modifiers help vs when to skip
**Transferable & Sharing** (`skills/transferable-ref.md`):
- Decision tree: CodableRepresentation vs DataRepresentation vs FileRepresentation vs ProxyRepresentation
- Drag and drop, copy/paste, ShareLink with complete SwiftUI API
- Custom UTType declarations (Swift + Info.plist, both required)
- 7 common errors with fixes (representation ordering, missing Info.plist, hit testing)
- UIKit bridging via NSItemProvider
**Debug Deep Links** (`skills/deep-link-debugging.md`):
- Debug-only URL scheme for simulator navigation
- NavigationPath integration for robust routing
- State configuration links (error states, empty states)
- Integration with /axiom:screenshot and simulator-tester agent
- 60-75% faster iteration with visual verification
**tvOS Development** (`skills/tvos.md`):
- Dual focus system (UIKit Focus Engine + SwiftUI @FocusState)
- Siri Remote input (two generations, three input layers)
- Storage constraints (no Documents directory, iCloud required)
- No WebView (JavaScriptCore only, no DOM)
- AVPlayer tuning, Menu button state machine
- TVUIKit components
## Anti-Rationalization
| Thought | Reality |
|---------|---------|
| "Date() is fine, everyone uses it" | `Date.now` has been the modern pattern since Swift 5.6. `skills/swift-modern.md` lists 12+ patterns Claude gets wrong. |
| "I don't need ownership modifiers" | For most code, correct. But ~Copyable types *require* them, and large value types in hot paths benefit measurably. |
| "Transferable is just Codable for drag and drop" | Transferable has 4 representation types, ordering rules, and Info.plist requirements. Getting it wrong causes silent cross-app failures. |
| "I'll just use the same code as iOS for tvOS" | tvOS has no Documents directory, no WebView, a dual focus system, and two generations of remote hardware. It compiles fine and fails at runtime. |
| "Debug deep links are overkill" | Manual navigation costs 2-3 minutes per iteration. Deep links cut it to 45 seconds. Over a debugging session, that's hours saved. |
| "CGFloat is what SwiftUI uses" | Swift 5.5+ has implicit Double-CGFloat bridging. Use Double everywhere except optionals, inout, and ObjC-bridged APIs. |
| "I'll add the Info.plist entry later" | Custom UTTypes work in-app without Info.plist but silently fail cross-app. This is the #1 "works in dev, fails in prod" Transferable issue. |
| "FormatStyle is too verbose" | `val.formatted(.number.precision(.fractionLength(2)))` is type-safe and localized. `String(format:)` is neither. |
## Example Invocations
User: "Is this Swift code using modern patterns?"
-> Read: `skills/swift-modern.md`
User: "How do I use borrowing and consuming?"
-> Read: `skills/ownership-conventions.md`
User: "How do I make my model draggable?"
-> Read: `skills/transferable-ref.md`
User: "How do I implement ShareLink with a custom preview?"
-> Read: `skills/transferable-ref.md`
User: "I need debug deep links for simulator testing"
-> Read: `skills/deep-link-debugging.md`
User: "I'm building a tvOS app and focus navigation doesn't work"
-> Read: `skills/tvos.md`
User: "What is InlineArray and when should I use it?"
-> Read: `skills/ownership-conventions.md`
User: "My drag and drop works in-app but not across apps"
-> Read: `skills/transferable-ref.md`
User: "tvOS keeps losing my saved data"
-> Read: `skills/tvos.md`
User: "How do I optimize large struct passing?"
-> Read: `skills/ownership-conventions.md`
User: "I need to fix my async/await code"
-> See `/skill axiom-concurrency`
User: "Check my code for Swift 6 concurrency issues"
-> See `/skill axiom-concurrency`
章节与文件索引
按说明文件中的顺序排列。
快速参考
决策树
冲突解决
关键模式
反合理化
文件/命令 -> some-auditor · axiom-swift-simplifier · skills/swift-modern.md · anyAppleOS · weak let · ~Sendable · OS27 · skills/ownership-conventions.md
内容校验值 -> 51eabdd08bf4
当前原文的自动摘译,尚未人工审校。
快速参考
症状/任务 · 参考过时的 Swift 模式(Date()、CGFloat、DateFormatter) · 参见
skills/swift-modern.md基础现代化(FormatStyle、URL.documentsDirectory) · 参见skills/swift-modern.mdSwift 代码中常见的 Claude 幻觉 · 参见skills/swift-modern.mdSwift 6.4 习惯用法 —anyAppleOS,weak let、~Sendable(OS27) · 参见skills/swift-modern.md决策树
过时的 Swift 模式/现代 API 替代品/Claude 幻觉? ->
skills/swift-modern.md~可复制/借用/消费/InlineArray/Span? ->skills/ownership-conventions.md拖放/复制/粘贴/ShareLink/Transferable/UTTypes? ->skills/transferable-ref.md调试深层链接/模拟器导航/屏幕截图自动化? ->skills/deep-link-debugging.mdtvOS 开发/焦点引擎/Siri Remote/存储/AVPlayer? ->skills/tvos.md冲突解决
swift vs 并发:当 Swift 6 出现并发错误时:使用并发,而不是 swift ——并发错误是 actor 隔离/可发送问题。
skills/swift-modern.md涵盖了并发姿势(默认),但详细的模式存在于公理并发中。 swift 与性能:优化 Swift 代码时:如果问题是借用/消费/~Copyable/InlineArray/Span ->skills/ownership-conventions.md,请使用 swift 获取所有权关键模式
现代 Swift 习语 (
skills/swift-modern.md):12 种以上过时的模式 Claude 默认为 (Date()、CGFloat、DateFormatter、DispatchQueue.main.async) 基础现代化 (FormatStyle、URL.documentsDirectory、.replacing()) SwiftUI 便利 API Claude 未命中 (ContentUnavailableView.search、LabeledContent) Swift 6.4 并发状态默认值反合理化
想法 · 现实 “Date() 很好,每个人都使用它” ·
Date.now自 Swift 5.6 以来一直是现代模式。skills/swift-modern.md列出了 Claude 错误的 12 种以上模式。 “我不需要所有权修饰符” · 对于大多数代码,正确。但是~可复制类型需要它们,并且热路径中的大值类型会受益匪浅。 “Transferable 只是可编码用于拖放” · Transferable 有 4 种表示类型、排序规则和 Info.plist 要求。出错会导致无声的跨应用程序故障。