apple-swift

Apple Swift 参考

涵盖 Swift 官方文档中标准库、并发、协议/泛型和 Observation 的技能。 根据用户的任务，阅读相应的 README.md，再从中找到具体文件。

来源：developer.apple.com JSON（获取于 2026-10-16，iOS/macOS 27.0 SDK，Swift 6.4 时代）。可用性值为各 JSON 的 introducedAt，原样写入。 补充设计文档：swift-evolution 固定在提交 f006bf3cf2594bdd4a972f9126f93bd1743ed524（https://github.com/swiftlang/swift-evolution/tree/f006bf3cf2594bdd4a972f9126f93bd1743ed524，无发布标签）。仅用于用法示例和状态，不作为签名的来源。

目录结构

skills/apple-swift/
  SKILL.md
  references/
    standard-library/
      README.md
      int.md
      double.md
      float.md
      bool.md
      string.md
      character.md
      substring.md
      unicode.md
      array.md
      dictionary.md
      set.md
      range.md
      contiguous-array.md
      optional.md
      result.md
      keypath.md
      span.md
      mutablespan.md
      rawspan.md
      mutablerawspan.md
      outputspan.md
      utf8span.md
      inlinearray.md
      rangeset.md
      discontiguousslice.md
    concurrency/
      README.md
      task.md
      taskgroup.md
      throwingtaskgroup.md
      withtaskgroup.md
      withthrowingtaskgroup.md
      taskpriority.md
      tasklocal.md
      actor.md
      mainactor.md
      globalactor.md
      sendable.md
      asyncsequence.md
      asyncstream.md
      asyncthrowingstream.md
      checkedcontinuation.md
      withcheckedcontinuation.md
      discardingtaskgroup.md
      throwingdiscardingtaskgroup.md
      withdiscardingtaskgroup.md
      withthrowingdiscardingtaskgroup.md
      clock.md
      duration.md
      instantprotocol.md
      continuousclock.md
      suspendingclock.md
      taskexecutor.md
      continuation.md
      withcontinuation.md
      unsafecontinuation.md
      withunsafecontinuation.md
      unsafecurrenttask.md
      executor.md
      serialexecutor.md
      executorjob.md
      unownedjob.md
      jobpriority.md
      unownedserialexecutor.md
      unownedtaskexecutor.md
      globalconcurrentexecutor.md
      withtaskexecutorpreference.md
    protocols-generics/
      README.md
      equatable.md
      hashable.md
      comparable.md
      identifiable.md
      codable.md
      encodable.md
      decodable.md
      caseiterable.md
      rawrepresentable.md
      sequence.md
      collection.md
      iteratorprotocol.md
      customstringconvertible.md
      error.md
      expressiblebyliteral.md
      generics.md
      some-any-opaque-types.md
    observation/
      README.md
      observable-protocol.md
      observable-macro.md
      observationignored.md
      observationtracked.md
      observationregistrar.md
      withobservationtracking.md
      observations.md
      observationtracking.md
      withcontinuousobservation.md
      withobservationtracking-options.md

探索步骤

根据任务查找类别，并在类别的 README.md 中确定目标页面：

1. 在下方映射表中查找与任务对应的类别
2. 参阅该类别的 references/{category}/README.md，确定目标页面
3. 阅读相应页面的 .md，查看详细信息

任务 → 类别映射

タスク	カテゴリ	参照 README
Int / Double / Float / Bool の数値型を使いたい	standard-library	references/standard-library/README.md
String / Character / Substring / Unicode を扱いたい	standard-library	references/standard-library/README.md
Array / Dictionary / Set / Range / ContiguousArray を使いたい	standard-library	references/standard-library/README.md
Optional / Result / KeyPath の API を確認したい	standard-library	references/standard-library/README.md
async / await / Task で非同期処理を書きたい	concurrency	references/concurrency/README.md
actor / MainActor / GlobalActor でデータ競合を防ぎたい	concurrency	references/concurrency/README.md
TaskGroup / withTaskGroup で並列処理を構造化したい	concurrency	references/concurrency/README.md
AsyncSequence / AsyncStream / for await in を使いたい	concurrency	references/concurrency/README.md
Sendable 準拠・コールバック API を async に橋渡ししたい	concurrency	references/concurrency/README.md
TaskLocal / TaskPriority を使いたい	concurrency	references/concurrency/README.md
DiscardingTaskGroup / withDiscardingTaskGroup で結果を破棄する子タスクを構造化したい	concurrency	references/concurrency/README.md
Clock / Duration / InstantProtocol / ContinuousClock / SuspendingClock で時間計測・スリープを扱いたい	concurrency	references/concurrency/README.md
TaskExecutor でタスクの実行先を指定したい	concurrency	references/concurrency/README.md
Continuation (noncopyable) / UnsafeContinuation / withContinuation でコールバック API を橋渡ししたい	concurrency	references/concurrency/README.md
Executor / SerialExecutor / ExecutorJob / withTaskExecutorPreference でカスタム executor を使いたい	concurrency	references/concurrency/README.md
UnsafeCurrentTask / タスクキャンセルのシールド / 優先度エスカレーション (JobPriority) を扱いたい	concurrency	references/concurrency/README.md
Span / MutableSpan / RawSpan / OutputSpan / UTF8Span で連続メモリへ安全にアクセスしたい	standard-library	references/standard-library/README.md
InlineArray / RangeSet / DiscontiguousSlice を使いたい	standard-library	references/standard-library/README.md
Equatable / Hashable / Comparable を型に準拠させたい	protocols-generics	references/protocols-generics/README.md
Codable / Encodable / Decodable で JSON シリアライズしたい	protocols-generics	references/protocols-generics/README.md
Identifiable / CaseIterable / RawRepresentable を使いたい	protocols-generics	references/protocols-generics/README.md
Sequence / Collection / IteratorProtocol を実装したい	protocols-generics	references/protocols-generics/README.md
ジェネリクス関数・型・associatedtype・where 句を書きたい	protocols-generics	references/protocols-generics/README.md
some / any opaque types・existential を使いたい	protocols-generics	references/protocols-generics/README.md
Error プロトコルでカスタムエラーを定義したい	protocols-generics	references/protocols-generics/README.md
@Observable マクロで SwiftUI / UIKit と状態を連携したい	observation	references/observation/README.md
Observable プロトコルを手動で準拠したい	observation	references/observation/README.md
@ObservationIgnored で追跡対象外プロパティを設定したい	observation	references/observation/README.md
withObservationTracking で変更通知を受け取りたい	observation	references/observation/README.md
Observations / withContinuousObservation で継続的な変更を async sequence として観測したい	observation	references/observation/README.md