Android Crash/ANR/結構化日誌的「實作層」 — Firebase Crashlytics 33.x、Custom Signals/OnFatalException、Android 14 ANR Watchdog（含 foreground threshold）、Memory Warning、Timber、Play Console + Firebase 警報聯動，產出可定位的事件流

2026-04-279

data-layer-mastery

BryantChi/Android-Skills

Android 資料層 — Room 2.7+ Migration / Paging 3 / FTS、Retrofit + OkHttp 統一錯誤處理、Offline-First SSOT、Sync Manager + WorkManager、Protobuf DataStore、Room vs SQLDelight 決策矩陣，產出可離線可同步的資料層

2026-04-279

deep-performance-tuning

BryantChi/Android-Skills

Android 效能定位與優化（數據驅動） — Macrobenchmark / Baseline Profiles / Startup Profiles、Perfetto trace、JankStats 量化門檻、Memory Profiler / Native Profiler / Flame Graph、R8 優化、Play Console App Quality Insights，產出可進 CI gate 的效能基線

2026-04-279

dependency-injection-mastery

BryantChi/Android-Skills

Hilt 2.52+ 進階用法 — Assisted Injection、Custom Components/Scopes、Multi-binding、EntryPoint 跨模組安全、KSP2 取代 kapt、@UninstallModules 測試策略，產出可測試的多模組 DI 架構

2026-04-279

kotlin-multiplatform

BryantChi/Android-Skills

KMP 跨平台架構（2026-04） — 共享邊界決策、Kotlin 2.1 + Ktor 3.x + SQLDelight 2.x、iOS Interop（SPM、Shared ViewModel）、Compose Multiplatform 策略、平台 Dispatcher 差異、Serialization 選型、Room→SQLDelight 遷移路徑

2026-04-279

id	android_skill_index
name	Android Skill Index
description	Android 17 個技能的導航中樞 — 依場景路由到 2-3 個技能組合，含 Skill Dependency Graph、易混淆 skill 邊界對照表、2026-04 重構說明
type	skill

Android Skill Index

導航中樞：當不確定該載入哪些技能時，從這裡開始。本檔案不含具體實作，只負責指路。

Instructions

先簡述目標與現況（新專案 / 舊專案 / 效能 / 發布）。
從 §「Scenario Router」找到最接近的場景。
一次載入 2-3 個 技能，不要全部塞給 AI。
任務結束前回到 §「Skill Dependency Graph」確認沒漏。

When to Use

不確定該載入哪些 skill
跨多個領域的任務需要組合
想依情境快速建立流程

When NOT to Use

已經確定要用某個 skill → 直接載入它，不用先過本 skill
純單一明確問題（例如 "Detekt 規則怎麼寫"） → 直接 @coding_style_conventions

Example Prompts

「我有舊專案要現代化，請推薦技能組合」
「效能很差，要先用哪些 skill 排查？」
「準備上 Play Store production，哪些 skill 要過？」

Workflow

在 Scenario Router 找場景。
依順序載入對應 skill 並執行。
完成後對照 Skill Dependency Graph 與 Boundary Table 確認無漏。

Minimal Template

目標: <例：上線新支付>
現況: <例：targetSdk 33、無 Macrobenchmark>
情境: <Scenario E + Scenario M>
建議技能: platform_modernization_2026, deep_performance_tuning, release_automation
驗收: 各 skill 的 Quick Checklist

Quick Reference

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 前需重新審視。

Scenario Router

🚀 場景 A：從零建立新專案

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

🔧 場景 B：舊專案加新功能模組

1. legacy_rapid_expansion       → Islanding + Bridge
2. ui_ux_engineering            → XmlBridgeTheme 過渡
3. navigation_patterns          → Compose Navigation 接 Wrapper Activity
4. testing_legacy_strategies    → 邊界 characterization tests

🔄 場景 C：舊專案全面現代化

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      → 遷移後回歸量測

⚡ 場景 D：效能問題排查

1. observability_strategy       → 先確認指標與基準
2. deep_performance_tuning      → Perfetto + Macrobenchmark 定位
3. ui_ux_engineering            → Compose Stability 修法
4. data_layer_mastery           → DAO/網路熱區優化

📦 場景 E：App 發布準備

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 條件

🌐 場景 F：跨平台共享邏輯

1. kotlin_multiplatform         → 共享邊界決策 + Setup
2. data_layer_mastery           → Room vs SQLDelight 決策
3. dependency_injection_mastery → 跨平台 DI 接合
4. testing_legacy_strategies    → commonTest 安全網

🧭 場景 G：CI / Quality Gates

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

📈 場景 H：Performance-by-default

1. deep_performance_tuning      → Macrobench + Baseline/Startup Profiles
2. project_bootstrapping        → 預設 benchmark 模組
3. release_automation           → CI 退化 > 5% 阻擋

🔍 場景 I：Observability-first（既有實作層）

1. observability_strategy       → SLI/SLO/告警閾值
2. crash_monitoring             → Crashlytics/ANR 實作
3. deep_performance_tuning      → 效能信號接入

🧱 場景 J：Supply Chain Compliance

1. supply_chain_security        → 依賴/SBOM/SLSA/Sigstore
2. release_automation           → CI gate + 簽章流程
3. coding_style_conventions     → SuppressLint 與 baseline 治理

🧩 場景 K：Compose-first + Legacy Interop

1. tech_stack_migration         → ComposeView/AndroidView/Fragment
2. ui_ux_engineering            → Material 3 + a11y
3. legacy_rapid_expansion       → 島內新代碼策略

🧭 場景 L：多模組擴展與導航治理

1. project_bootstrapping        → 模組與 Convention Plugins
2. dependency_injection_mastery → 模組邊界與 EntryPoint
3. navigation_patterns          → 跨模組 Navigator API

⏰ 場景 M：版本/平台升級（新）

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 重生

🛡️ 場景 N：供應鏈合規（新）

1. supply_chain_security        → SBOM / SLSA / Sigstore / OSV
2. release_automation           → CI 串接 + 簽章 OIDC
3. observability_strategy       → 簽章/掃描事件納入告警

🔭 場景 O：可觀測性建模（新）

1. observability_strategy       → SLI/SLO/event schema/feedback loop
2. crash_monitoring             → 實作層接入
3. deep_performance_tuning      → 效能 metric 上報
4. release_automation           → SLO 違反自動 halt rollout

Skill Dependency Graph

                    ┌─────────────────────────────────────┐
                    │       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 邊界對照表（易混淆組合）

當你不確定某個任務該載哪個 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 視覺。

2026-04 重構紀錄

變更	從	到	影響
改名 + 重新定位	`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。

How to Use

確認場景：從上方 Scenario Router 選最接近的。
載入 2-3 個 skill：避免一次塞太多。
走 skill 的 Workflow：每個 skill 都有固定 6 段（Instructions → When to Use → When NOT to Use → Example Prompts → Workflow → Practical Notes → Minimal Template → 領域章節 → Cross-Skill References → Quick Checklist）。
以 Quick Checklist 收尾：當作 self-review 與 PR description 模板。

AI Tool Compatibility

所有 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。

Best Practices

Context Management：依 Scenario Router 載 2-3 個，不要全塞。
Focusing：明確引用章節，例「@deep_performance_tuning 的 Macrobenchmark 章節」。
Enforce Checklists：任務結束前要求 AI 檢查對應 skill 的 Quick Checklist。

Quick Checklist（載入前自我檢查）

我已用一句話描述「目標 + 現況」
我從 Scenario Router 找到對應場景（A-O）
我只載入該場景列出的 2-3 個 skill
任務結束時對照各 skill 的 Quick Checklist 收尾
跨 skill 衝突時先看 §「Skill 邊界對照表」