تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

swiftfindrefs

بواسطة michaelversus

iOS & macOS Development
1.6kالتنزيلات وفق ما يذكره clawskills.sh
1النجوم
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

Use swiftfindrefs (IndexStoreDB) to list every Swift source.

الوصف

ما الذي تفعله هذه المهارة

swiftfindrefs queries Xcode's IndexStore (DerivedData) to return every Swift source file that references a given symbol. It covers classes, structs, enums, protocols, functions, and variables across modules. Output is one absolute file path per line, deduplicated and safe to pipe.

grep and IDE search operate on text and miss references that the compiler resolved through type inference or module re-exports, while IndexStoreDB reflects what was actually compiled.

متى تستخدمها

  • Finding all callers of a function before renaming it
  • Auditing files affected by moving a type to a new module
  • Adding missing imports only to files that reference a relocated symbol
  • Confirming a symbol is unused before deleting it
  • Scoping a cross-module refactor to exactly the files that matter

مثال على سير العمل

الإدخال

User asks: find all Swift files referencing UserSession before renaming it

الوكيل
  1. 1

    Run swiftfindrefs --projectName MyApp --symbolName UserSession --symbolType class

  2. 2

    Collect the list of absolute file paths from stdout

  3. 3

    Open only those files to review call sites

  4. 4

    Rename UserSession in each returned file

  5. 5

    Verify no other files were changed

الإخراج

A deduplicated list of absolute paths to every .swift file referencing UserSession, ready for targeted edits

المتطلبات

  • Xcode installed on macOS (project must be built at least once to populate DerivedData)
  • swiftfindrefs CLI installed via Homebrew: brew tap michaelversus/SwiftFindRefs https://github.com/michaelversus/SwiftFindRefs.git && brew install swiftfindrefs

التثبيت

clawhub install michaelversus/swiftfindrefs

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط