القائمة
Android 17 個技能的導航中樞 — 依場景路由到 2-3 個技能組合，含 Skill Dependency Graph、易混淆 skill 邊界對照表、2026-04 重構說明
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Kotlin 程式碼規範 — 命名、Detekt 1.25+ / Ktlint 1.4+ 配置、Compose Stability/Compiler Metrics、SuppressLint 多模組策略、KDoc 與 Code Review Checklist，產出可在 CI 強制的風格基線
Android Crash/ANR/結構化日誌的「實作層」 — Firebase Crashlytics 33.x、Custom Signals/OnFatalException、Android 14 ANR Watchdog（含 foreground threshold）、Memory Warning、Timber、Play Console + Firebase 警報聯動，產出可定位的事件流
Android 資料層 — Room 2.7+ Migration / Paging 3 / FTS、Retrofit + OkHttp 統一錯誤處理、Offline-First SSOT、Sync Manager + WorkManager、Protobuf DataStore、Room vs SQLDelight 決策矩陣，產出可離線可同步的資料層
Android 效能定位與優化（數據驅動） — Macrobenchmark / Baseline Profiles / Startup Profiles、Perfetto trace、JankStats 量化門檻、Memory Profiler / Native Profiler / Flame Graph、R8 優化、Play Console App Quality Insights，產出可進 CI gate 的效能基線
Hilt 2.52+ 進階用法 — Assisted Injection、Custom Components/Scopes、Multi-binding、EntryPoint 跨模組安全、KSP2 取代 kapt、@UninstallModules 測試策略，產出可測試的多模組 DI 架構
KMP 跨平台架構（2026-04） — 共享邊界決策、Kotlin 2.1 + Ktor 3.x + SQLDelight 2.x、iOS Interop（SPM、Shared ViewModel）、Compose Multiplatform 策略、平台 Dispatcher 差異、Serialization 選型、Room→SQLDelight 遷移路徑
| id | android_skill_index |
| name | Android Skill Index |
| description | Android 17 個技能的導航中樞 — 依場景路由到 2-3 個技能組合，含 Skill Dependency Graph、易混淆 skill 邊界對照表、2026-04 重構說明 |
| type | skill |
導航中樞：當不確定該載入哪些技能時，從這裡開始。本檔案不含具體實作，只負責指路。
@coding_style_conventions目標: <例：上線新支付>
現況: <例：targetSdk 33、無 Macrobenchmark>
情境: <Scenario E + Scenario M>
建議技能: platform_modernization_2026, deep_performance_tuning, release_automation
驗收: 各 skill 的 Quick Checklist
17 個 skill（含本 index 共 17；外部視角為 16 + index = 17）：
| Skill | 一句話 | 主要場景 |
|---|---|---|
platform_modernization_2026 ⏰ | 年度平台升級（KSP2/Gradle 9/AGP 8.7+/targetSdk 35/Edge-to-Edge） | M |
project_bootstrapping | 新專案/新模組骨架、Convention Plugins | A |
coding_style_conventions | Detekt 1.25+、Ktlint 1.4+、Compose Stability、Code Review | A, C, G |
dependency_injection_mastery | Hilt 2.52+ 進階、Custom Components、KSP2 | A, C, F |
data_layer_mastery | Room 2.7+、Retrofit、Offline-First、Sync Manager | A, D, F |
navigation_patterns | Compose Navigation 3.x、Deep Links、Predictive Back | A, B |
ui_ux_engineering | Material 3 Expressive、Edge-to-Edge、Adaptive、a11y | A, B, D |
kotlin_multiplatform | KMP 2.1、Ktor 3、SQLDelight 2、iOS Interop、CMP | F |
tech_stack_migration | View→Compose、RxJava→Flow、Dagger→Hilt、kapt→KSP2 | C |
legacy_rapid_expansion | 舊架構 Islanding 策略快速建新功能 | B, K |
testing_legacy_strategies | Characterization、Robolectric、Roborazzi、Coverage 量化 | C, F, G |
crash_monitoring | Crashlytics 33.x、ANR Watchdog、Timber、警報聯動（實作層） | D, E, I |
observability_strategy | SLI/SLO 設計、告警閾值矩陣、feedback loop（設計層） | I, O |
deep_performance_tuning | Macrobenchmark、Baseline/Startup Profiles、Perfetto、R8 | D, E, H |
release_automation | CI Gates、Configuration Cache 9、Fastlane、Play Integrity、Cert Pinning | E, G, H |
supply_chain_security | OSV-Scanner、SBOM、SLSA、Sigstore、Signing & Secrets、License | E, J, N |
⏰ = 年度更新 skill；2027-04 前需重新審視。
1. project_bootstrapping → 骨架 + Convention Plugins
2. coding_style_conventions → Detekt/Ktlint + Compose Stability
3. dependency_injection_mastery → Hilt module 設計
4. ui_ux_engineering → Design System (M3 Expressive)
5. data_layer_mastery → Room + Retrofit + Sync
6. navigation_patterns → Compose Navigation 3
1. legacy_rapid_expansion → Islanding + Bridge
2. ui_ux_engineering → XmlBridgeTheme 過渡
3. navigation_patterns → Compose Navigation 接 Wrapper Activity
4. testing_legacy_strategies → 邊界 characterization tests
1. testing_legacy_strategies → Characterization Tests + Visual Regression
2. coding_style_conventions → Baseline 規範 + Compose Stability
3. tech_stack_migration → 技術棧遷移（唯一權威）
4. dependency_injection_mastery → Hilt 共存與收斂
5. deep_performance_tuning → 遷移後回歸量測
1. observability_strategy → 先確認指標與基準
2. deep_performance_tuning → Perfetto + Macrobenchmark 定位
3. ui_ux_engineering → Compose Stability 修法
4. data_layer_mastery → DAO/網路熱區優化
1. release_automation → CI Gates + Fastlane + Staged Rollout
2. supply_chain_security → SBOM + SCA + Signing
3. deep_performance_tuning → Macrobenchmark gate
4. crash_monitoring → Crashlytics + Velocity Alert
5. observability_strategy → SLO 與 rollout halt 條件
1. kotlin_multiplatform → 共享邊界決策 + Setup
2. data_layer_mastery → Room vs SQLDelight 決策
3. dependency_injection_mastery → 跨平台 DI 接合
4. testing_legacy_strategies → commonTest 安全網
1. coding_style_conventions → Detekt/Ktlint/Lint 規則
2. release_automation → CI workflow + Quality Gates
3. testing_legacy_strategies → 覆蓋率 gate
4. supply_chain_security → OSV-Scanner / SBOM CI
1. deep_performance_tuning → Macrobench + Baseline/Startup Profiles
2. project_bootstrapping → 預設 benchmark 模組
3. release_automation → CI 退化 > 5% 阻擋
1. observability_strategy → SLI/SLO/告警閾值
2. crash_monitoring → Crashlytics/ANR 實作
3. deep_performance_tuning → 效能信號接入
1. supply_chain_security → 依賴/SBOM/SLSA/Sigstore
2. release_automation → CI gate + 簽章流程
3. coding_style_conventions → SuppressLint 與 baseline 治理
1. tech_stack_migration → ComposeView/AndroidView/Fragment
2. ui_ux_engineering → Material 3 + a11y
3. legacy_rapid_expansion → 島內新代碼策略
1. project_bootstrapping → 模組與 Convention Plugins
2. dependency_injection_mastery → 模組邊界與 EntryPoint
3. navigation_patterns → 跨模組 Navigator API
1. platform_modernization_2026 → KSP2 / Gradle 9 / AGP 8.7+ / targetSdk 35
2. project_bootstrapping → 重整 Convention Plugin
3. tech_stack_migration → 過時 API 替換
4. deep_performance_tuning → 升級後 Baseline Profile 重生
1. supply_chain_security → SBOM / SLSA / Sigstore / OSV
2. release_automation → CI 串接 + 簽章 OIDC
3. observability_strategy → 簽章/掃描事件納入告警
1. observability_strategy → SLI/SLO/event schema/feedback loop
2. crash_monitoring → 實作層接入
3. deep_performance_tuning → 效能 metric 上報
4. release_automation → SLO 違反自動 halt rollout
┌─────────────────────────────────────┐
│ coding_style_conventions │ ← 所有技能的基礎
└──────────────────┬──────────────────┘
│
┌───────────────────┬──────────┼──────────┬───────────────────┐
▼ ▼ ▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────┐ ┌──────────────┐ ┌──────────────┐
│ project_ │ │ legacy_ │ │ tech_│ │ deep_perfor- │ │ platform_ │
│ bootstrapping│ │ rapid_ │ │ stack│ │ mance_tuning │ │ modernizati- │
│ │ │ expansion │ │ _mig │ │ │ │ on_2026 ⏰ │
└──────┬───────┘ └──────┬───────┘ └──┬───┘ └──────┬───────┘ └──────┬───────┘
│ │ │ │ │
┌───┴────────┬────────┴───┐ ┌────┴───┐ ┌────┴───┐ ┌──┴─┐
▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼
┌──────┐ ┌──────────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────────┐
│ ui_ux│ │dependency│ │data_ │ │testi-│ │crash_│ │relea-│ │navigation│
│ _eng │ │_injectio-│ │layer_│ │ng_ │ │monit-│ │se_ │ │_patterns │
│ │ │n_mastery │ │maste-│ │legacy│ │oring │ │autom-│ │ │
│ │ │ │ │ry │ │ │ │ │ │ation │ │ │
└──┬───┘ └──────────┘ └──┬───┘ └──────┘ └──┬───┘ └──┬───┘ └──────────┘
│ │ │ │
│ ▼ ▼ ▼
│ ┌──────────┐ ┌──────────────┐
│ │ kotlin_ │ │observability_│
│ │ multipla-│ │ strategy │ ← 設計層
│ │ tform │ └──────┬───────┘
│ └──────────┘ │
│ ▼
└──────────────────────────────────► 指向 crash_monitoring
+ deep_performance_tuning
（實作層）
┌──────────────────────┐
│ supply_chain_security │ ← 含 Signing/Secrets
└──────────────────────┘
│
▼
接到 release_automation 與 CI
當你不確定某個任務該載哪個 skill，先看這張表：
| 易混淆 | 領域分工 |
|---|---|
observability_strategy ↔ crash_monitoring | strategy 設計 SLI/SLO/告警閾值/event schema；monitoring 實作 Crashlytics SDK / ANR Watchdog / Timber。談「該量什麼、警報多嚴」→ strategy；談「怎麼裝、怎麼接、怎麼讓 dashboard 收到」→ monitoring。 |
release_automation ↔ supply_chain_security | release_automation = CI workflow / Build Speed / Fastlane / Play Console / 應用層執行時安全（Cert Pinning / NSC / Root）。supply_chain_security = 依賴掃描 / SBOM / SLSA / Sigstore / Signing & Secrets / License。Secrets/Signing 在 supply_chain。 |
testing_legacy_strategies ↔ legacy_rapid_expansion | testing 為「給舊代碼補測試」；rapid_expansion 為「在舊代碼旁建新功能孤島」。先 testing 再 rapid_expansion。 |
data_layer_mastery ↔ kotlin_multiplatform | Android-only 用 Room → data_layer；KMP 跨 iOS 用 SQLDelight → kmp（data_layer 提供決策矩陣指向 kmp）。 |
dependency_injection_mastery ↔ tech_stack_migration | Hilt 遷移步驟（從 Dagger 2）→ tech_stack_migration（唯一權威）；Hilt 已就位後的進階用法 → di_mastery。 |
project_bootstrapping ↔ platform_modernization_2026 | bootstrapping 處理「新專案/新模組」骨架；platform_modernization 處理「升級既有專案到新平台版本」。新專案會直接套後者的版本基準。 |
coding_style_conventions ↔ release_automation | conventions 提供 規則檔（detekt.yml / .editorconfig / lint baseline）；release_automation 把它接進 CI gate。 |
coding_style_conventions ↔ ui_ux_engineering | conventions 處理 Compose 命名/順序/Stability config；ui_ux 處理 Compose Theme/Token/Component/Pattern。 |
navigation_patterns ↔ ui_ux_engineering | navigation 處理路由邏輯與 Predictive Back 行為；ui_ux 處理 Predictive Back 動畫視覺 與 Adaptive layout 視覺。 |
| 變更 | 從 | 到 | 影響 |
|---|---|---|---|
| 改名 + 重新定位 | observability_first | observability_strategy | 舊引用 @observability_first 需改 |
| 改名 + 收斂職責 | devops_and_security | release_automation | 舊引用 @devops_and_security 需改 |
| 強化（接收 Secrets） | supply_chain_security | supply_chain_security（同名擴張） | 內容由 78 行擴至 ~250 行 |
| 新增 | — | platform_modernization_2026 ⏰ | 年度更新；2027-04 前需重審 |
整體版本基準對齊：Kotlin 2.1.x / Gradle 9.0+ / AGP 8.7+ / compileSdk 35 / Compose BOM 2025.04 / Hilt 2.52 / Navigation 3.x。
所有 SKILL.md 採標準 Markdown，含 frontmatter、章節階層、程式碼塊、checklist；任何支援 context 的 AI 工具都能讀。
| 工具 | 引用方式 |
|---|---|
| Claude Code（plugin） | Skill tool / @skill_name |
| Antigravity / Cursor / Windsurf | @skill_name |
| Aider / 其他 CLI | /add skills/<name>/SKILL.md |
| Copilot | 開啟對應 SKILL.md tab 作為 context |
| Web Chat | 複製貼上單一 skill 內容 |
詳細 18+ 工具教學請見 ANDROID_SKILLS_GUIDE.md。