svharness 0.8.0

package/templates/android-compose/skeleton/agent-env/rules/harness-hilt-injection.mdc

@@ -0,0 +1,47 @@
+---
+description: Hilt 依赖注入约束，确保 ViewModel 和 UseCase 的正确注入方式
+alwaysApply: true
+---
+
+# Hilt 依赖注入约束
+
+## ViewModel 注入
+
+### ViewModel 必须使用 @HiltViewModel + @Inject constructor
+- 正例：`@HiltViewModel class MyViewModel @Inject constructor(private val useCase: MyUseCase) : BaseViewModel<...>()`
+- 反例：手动创建 `ViewModelProvider.Factory` 来实例化可由 Hilt 管理的 ViewModel
+- 检测：grep ViewModel 类声明，缺少 `@HiltViewModel` 或 `@Inject constructor`
+
+### Compose 容器层必须使用 hiltViewModel() 获取 ViewModel
+- 正例：`val viewModel: MyViewModel = hiltViewModel()`
+- 反例：`viewModel(factory = MyViewModel.Factory)` — 手动 Factory（除非非 Activity 场景）
+- 检测：grep `viewModel(` 后跟 `factory =` 且非非 Activity 场景
+
+### 禁止为传 UseCase 创建包装接口
+- 正例：ViewModel 构造函数直接注入 `UseCase` 接口
+- 反例：创建 `FeatureDependencies` / `XxxDependencies` 包装接口来传 UseCase
+- 检测：grep `Dependencies` 接口/类名出现于 feature 模块
+
+## Application 配置
+
+### Application 必须使用 @HiltAndroidApp 且 Manifest 配置 android:name
+- 正例：`@HiltAndroidApp class MyApp : Application()` + Manifest `<application android:name=".MyApp">`
+- 反例：Application 未标注 `@HiltAndroidApp` 或 Manifest 缺少 `android:name`
+- 检测：grep Application 类缺少 `@HiltAndroidApp`，或 Manifest `<application>` 缺少 `android:name`
+
+### Activity 必须使用 @AndroidEntryPoint
+- 正例：`@AndroidEntryPoint class MainActivity : ComponentActivity()`
+- 反例：Activity 未标注 `@AndroidEntryPoint`
+- 检测：grep 继承 `ComponentActivity` / `AppCompatActivity` 的类缺少 `@AndroidEntryPoint`
+
+## 依赖方向
+
+### 禁止从 Activity 向 Composable 层层透传 UseCase
+- 正例：Compose 通过 `hiltViewModel()` 获取 ViewModel，只传 UI 回调和页面参数
+- 反例：`MyScreen(useCase = myUseCase)` — 透传 UseCase 到 Composable
+- 检测：grep Composable 函数参数中出现 `UseCase` 类型
+
+### Repository 接口定义在 Domain 层，实现在 Foundation 层
+- 正例：Domain 模块定义 `interface XxxRepository`，Foundation 模块提供 `XxxRepositoryImpl`
+- 反例：Repository 接口和实现都在 Foundation 层 — 违反依赖倒置
+- 检测：grep foundation 模块中定义的 Repository 接口（非 impl 类）

package/templates/android-compose/skeleton/agent-env/rules/harness-mvi-layering.mdc

@@ -0,0 +1,58 @@
+---
+description: MVI 平台化架构分层铁律，约束层级依赖与数据流方向
+alwaysApply: true
+---
+
+# MVI 分层铁律
+
+## 层级依赖规则
+
+### 依赖方向严格向内（向下），禁止反向依赖
+- Feature → Domain → Foundation → 架构层（MVI Core）
+- 正例：Feature 依赖 Domain，Domain 依赖 Foundation
+- 反例：Foundation 依赖 Domain、Domain 依赖 Feature — 反向依赖
+- 检测：grep 各模块 `build.gradle*` 的 `implementation` / `api` 声明，Foundation 不应出现 Domain/Feature 依赖
+
+### Feature 层禁止直接依赖 Foundation 层
+- 正例：Feature → Domain UseCase → Foundation Repository
+- 反例：Feature 直接调用 Repository / Room / Retrofit
+- 检测：grep feature 模块源码中出现 `Repository` / `Dao` / `ApiService` 直接引用
+
+### Domain 层禁止持有 View/Context 引用
+- 正例：UseCase 只注入 Repository 接口
+- 反例：UseCase 构造函数接收 `Context` 或 `View`
+- 检测：grep domain 模块源码中 `import android.view` / `import android.content.Context`
+
+## 模块规则
+
+### Foundation 必须独立仓库
+- 正例：foundation-repo 独立 Git 仓库，发布为 AAR/Maven 坐标
+- 反例：foundation 与 domain/feature 共仓
+- 检测：验证 foundation 目录是否与 domain/feature 在同一 Git 仓库
+
+### Domain 与 Feature 必须是不同 Gradle module
+- 正例：`include(":domain")` 和 `include(":feature")` 分开声明
+- 反例：domain 和 feature 在同一个 module 内
+- 检测：grep `settings.gradle*` 确认 domain/feature 为独立 module
+
+### 跨仓依赖通过 AAR/Maven 坐标，禁止跨仓 project 引用
+- 正例：`implementation("com.xxx:foundation:1.0.0")`
+- 反例：`implementation(project(":foundation"))` — 跨仓不允许
+- 检测：grep 跨仓模块的 `build.gradle*` 出现 `project(":")` 引用其他仓库模块
+
+## MVI 协议规则
+
+### Reducer 是纯函数，只做 state.copy()
+- 正例：`is Event.Loaded -> state.copy(isLoading = false, data = event.data)`
+- 反例：`is Event.Loaded -> { repository.cache(event.data); state.copy(...) }` — Reducer 内有副作用
+- 检测：grep Reducer lambda 内出现 `repository.` / `useCase.` / `viewModelScope` 调用
+
+### EffectHandler 不修改 State，只发射 Effect
+- 正例：`is Event.Error -> emitEffect(Effect.ShowToast(event.message))`
+- 反例：EffectHandler 内调用 `dispatch(Event)` 或修改 `_uiState`
+- 检测：grep EffectHandler lambda 内出现 `dispatch(` / `state.copy(`
+
+### State 为不可变 data class，更新只用 .copy()
+- 正例：`data class UiState(val items: List<Item> = emptyList())`
+- 反例：`data class UiState(var items: MutableList<Item>)` — var + MutableList 可变
+- 检测：grep State data class 中出现 `var` 属性或 `MutableList` / `MutableMap` 类型

package/templates/android-compose/skeleton/agent-env/skills/harness-android-architecture/SKILL.md

@@ -0,0 +1,260 @@
+---
+name: harness-android-architecture
+description: 设计或审查基于 MVI 的 Android 平台化架构时使用。覆盖四层职责、依赖规则、UDF 数据流、ViewModel/UseCase/Repository 接线模式和实现检查清单。刚性约束由 rules 加载，本技能聚焦实现指引与模板代码。
+---
+
+# MVI 平台化架构 — 实现指引
+
+## 概述
+
+本项目采用 **MVI + 平台化分层** 架构，遵循严格**单向数据流（UDF）**。层间依赖严格向内（向下），禁止反向依赖。
+
+> **刚性约束已由 rules 加载，本技能不再重复。** 详见：
+> - `harness-mvi-layering` — 层级依赖、模块规则、MVI 协议约束
+> - `harness-hilt-injection` — Hilt 注入约束
+> - `harness-coroutines-scope` — 协程作用域约束
+
+---
+
+## 分层模型
+
+```
+Feature 层（Compose UI / ViewModel）
+        │  发送 Intent，收集 State/Effect
+        ▼
+Domain 层（UseCase）
+        │  业务逻辑，通过 Registrable Callback 回传结果
+        ▼
+Foundation 层（Repository / Room / Retrofit）
+        │  纯技术能力，不含业务状态
+        ▼
+架构层（MVI Core）
+           定义 MVI 协议，不含业务逻辑
+```
+
+| 层级 | 职责 | 禁止事项 |
+|------|------|---------|
+| **架构层** | 定义 MVI 协议，提供 BaseViewModel/MviStore | 禁止业务 if-else，禁止持有视图引用 |
+| **基础层** | 网络、持久化、日志等纯技术能力 | 禁止持有业务状态 |
+| **领域层** | UseCase 封装业务逻辑，Registrable 回调异步结果 | 禁止直接依赖 Feature 层，禁止持有 View/Context |
+| **特性层** | Compose UI 渲染 State，发送 Intent，收集 Effect | 禁止直接调用 Foundation 层 |
+
+仓库/模块规则详见 [references/gradle-module-patterns.md](references/gradle-module-patterns.md)。
+
+---
+
+## UDF 数据流
+
+```
+View ──Intent──> ViewModel.process()
+                      │
+                      ▼
+               handleIntent() --> UseCase 调用
+                                       │ Callback
+                                       ▼
+                               dispatch(Event)
+                                       │
+                      ┌────────────────┴────────────────┐
+                      ▼                                  ▼
+                   Reducer                         EffectHandler
+                      │                                  │
+                   新 State                            Effect
+                      │                                  │
+                      ▼                                  ▼
+              StateFlow (持久)                    SharedFlow (一次性)
+                      │                                  │
+              collectAsState()                  LaunchedEffect 收集
+```
+
+详细数据流图解见 [references/udf-data-flow.md](references/udf-data-flow.md)。
+
+---
+
+## 各层实现模板
+
+### 1. 特性层 — ViewModel + Compose UI
+
+```kotlin
+@HiltViewModel
+class BluetoothViewModel @Inject constructor(
+    private val cases: BluetoothUseCase
+) : BaseViewModel<
+    BluetoothContract.State,
+    BluetoothContract.Event,
+    BluetoothContract.Effect,
+    BluetoothContract.Intent,
+    BluetoothContract.Callback>(useCase = cases) {
+
+    override val initialState = BluetoothContract.State()
+
+    override val useCaseCallback = object : BluetoothContract.Callback {
+        override fun onDeviceConnected(device: BluetoothDevice) {
+            dispatch(BluetoothContract.Event.Connected(device))
+        }
+        override fun onOperationFailed(reason: String) {
+            dispatch(BluetoothContract.Event.OperationFailed(reason))
+        }
+        // ... 其他回调
+    }
+
+    override val reducer = Reducer<BluetoothContract.State, BluetoothContract.Event> { state, event ->
+        when (event) {
+            is Event.Connected -> state.copy(isLoading = false, connectedDevice = event.device)
+            is Event.OperationFailed -> state.copy(isLoading = false)
+            else -> state
+        }
+    }
+
+    override val effectHandler = EffectHandler<BluetoothContract.Event, BluetoothContract.Effect> { event, emitEffect ->
+        when (event) {
+            is Event.OperationFailed -> emitEffect(Effect.ShowToast(event.reason))
+            else -> { /* 无副作用 */ }
+        }
+    }
+
+    override fun handleIntent(intent: BluetoothContract.Intent) {
+        when (intent) {
+            is Intent.ConnectToDevice -> {
+                dispatch(Event.ConnectionStarted)
+                cases.connect(intent.deviceAddress)
+            }
+            is Intent.StartScan -> cases.startScan()
+        }
+    }
+
+    init { startUseCaseListening() }
+}
+```
+
+Compose 容器层 / 纯 UI 层分离：
+
+```kotlin
+// 容器层：持有 ViewModel，处理 Effect
+@Composable
+fun BluetoothScreen(viewModel: BluetoothViewModel = hiltViewModel()) {
+    val state by viewModel.state.collectAsStateWithLifecycle()
+    LaunchedEffect(Unit) {
+        viewModel.effect.collect { effect ->
+            when (effect) {
+                is Effect.ShowToast -> Toast.makeText(LocalContext.current, effect.message, Toast.LENGTH_SHORT).show()
+            }
+        }
+    }
+    BluetoothContent(
+        state = state,
+        onIntent = { viewModel.process(it) }
+    )
+}
+
+// 纯 UI 层：无 ViewModel 依赖
+@Composable
+fun BluetoothContent(
+    state: BluetoothContract.State,
+    onIntent: (BluetoothContract.Intent) -> Unit
+) { /* 纯渲染逻辑 */ }
+```
+
+### 2. 领域层 — UseCase
+
+```kotlin
+interface BluetoothUseCase : Registrable<BluetoothContract.Callback> {
+    fun connect(deviceAddress: String)
+    fun startScan()
+    fun stopScan()
+}
+
+class BluetoothUseCaseImpl @Inject constructor(
+    private val repository: BluetoothRepository
+) : BluetoothUseCase {
+    private var callback: BluetoothContract.Callback? = null
+
+    override fun register(callback: BluetoothContract.Callback) {
+        this.callback = callback
+        startObserving()
+    }
+    override fun unRegister() { callback = null }
+
+    override fun connect(deviceAddress: String) {
+        repository.connect(deviceAddress) { result ->
+            result.fold(
+                onSuccess = { callback?.onDeviceConnected(it) },
+                onFailure = { callback?.onOperationFailed(it.message ?: "连接失败") }
+            )
+        }
+    }
+}
+```
+
+### 3. 基础层 — Repository
+
+```kotlin
+// 接口定义在 Domain 层，此处只放实现
+class BluetoothRepositoryImpl @Inject constructor(
+    private val bluetoothDao: BluetoothDao,
+    private val bluetoothApi: BluetoothApiService
+) : BluetoothRepository {
+    override fun connect(deviceAddress: String, onResult: (Result<BluetoothDevice>) -> Unit) {
+        // 实现连接逻辑
+    }
+}
+```
+
+Room / Retrofit / 数据映射模板详见 [references/implementation-checklist.md](references/implementation-checklist.md) 的基础层部分。
+
+---
+
+## 多 UseCase 组合
+
+ViewModel 可注入多个 UseCase，各自独立注册/注销：
+
+```kotlin
+@HiltViewModel
+class DashboardViewModel @Inject constructor(
+    private val bluetoothUseCase: BluetoothUseCase,
+    private val settingsUseCase: SettingsUseCase
+) : BaseViewModel<...>(useCase = bluetoothUseCase) {
+    init {
+        startUseCaseListening()
+        settingsUseCase.register(settingsCallback)
+    }
+    override fun onCleared() {
+        super.onCleared()
+        settingsUseCase.unRegister()
+    }
+}
+```
+
+---
+
+## 非 Activity 场景
+
+只有无法使用 `@AndroidEntryPoint` + `hiltViewModel()` 的宿主（Service / 自定义 Window），才使用手动 ViewModelStore：
+
+```kotlin
+class CustomWindow @Inject constructor(
+    private val viewModelFactory: BluetoothViewModel.Factory
+) {
+    private val viewModelStore = ViewModelStore()
+    private val viewModel: BluetoothViewModel by lazy {
+        ViewModelProvider(viewModelStore, viewModelFactory)[BluetoothViewModel::class.java]
+    }
+    fun onDestroy() { viewModelStore.clear() }
+}
+```
+
+---
+
+## 实现检查清单
+
+完整清单见 [references/implementation-checklist.md](references/implementation-checklist.md)。
+
+---
+
+## 必须遵守的约束规则
+
+> rules 引用路径：`../rules/<rule-name>.mdc`
+
+- harness-mvi-layering
+- harness-hilt-injection
+- harness-coroutines-scope
+- harness-compose-mandatory

package/templates/android-compose/skeleton/agent-env/skills/harness-android-architecture/references/gradle-module-patterns.md

@@ -0,0 +1,66 @@
+# 仓库与模块模式
+
+## 仓库拓扑（两种合法形态）
+
+### 形态 A：三仓分离
+
+```
+┌─────────────┐   ┌──────────────┐   ┌──────────────┐
+│ foundation-repo │   │  domain-repo    │   │ feature-repo  │
+│ :foundation     │◄──│  :domain        │◄──│ :feature      │
+└─────────────┘   └──────────────┘   └──────────────┘
+   独立仓库            独立仓库           独立仓库
+ 发布为 AAR/Maven    依赖 foundation AAR   依赖 domain AAR
+```
+
+### 形态 B：domain + feature 同仓（foundation 仍独立）
+
+```
+┌─────────────┐   ┌──────────────────────────┐
+│ foundation-repo │   │        app-repo              │
+│ :foundation     │◄──│  :domain      :feature       │
+└─────────────┘   │  （业务逻辑）──►（UI/ViewModel）│
+   独立仓库            └──────────────────────────┘
+ 发布为 AAR/Maven      同仓不同 module，project(":domain") 依赖
+```
+
+## Gradle 依赖声明
+
+```kotlin
+// :feature 模块的 build.gradle.kts
+dependencies {
+    // 同仓场景
+    implementation(project(":domain"))
+    // 跨仓场景
+    // implementation("com.xxx:domain:<version>")
+    // 不直接依赖 foundation（通过 domain 传递）
+}
+
+// :domain 模块的 build.gradle.kts
+dependencies {
+    // foundation 始终通过 AAR 引入
+    implementation("com.xxx:foundation:<version>")
+}
+```
+
+## 目录结构约定
+
+```
+foundation-repo/
+└── :foundation
+    ├── data/          ← RepositoryImpl、DAO、ApiService
+    └── di/            ← Hilt Module（DatabaseModule、RepositoryModule）
+
+domain-repo/（或 app-repo/:domain）
+└── :domain
+    ├── contract/      ← State/Event/Effect/Intent/Callback 定义
+    ├── usecase/       ← UseCase 接口与实现
+    └── di/            ← Hilt Module（DomainModule）
+
+app-repo/:feature
+└── :feature
+    ├── ui/            ← Composable 函数（Screen + Content）
+    ├── viewmodel/     ← ViewModel
+    ├── navigation/    ← Navigation Graph
+    └── di/            ← 如需 Feature 级 Hilt Module
+```

package/templates/android-compose/skeleton/agent-env/skills/harness-android-architecture/references/implementation-checklist.md

@@ -0,0 +1,45 @@
+# MVI 实现检查清单
+
+## 特性层（Feature）
+
+- [ ] ViewModel 使用 `@HiltViewModel` + `@Inject constructor(...)` 注入 UseCase
+- [ ] 继承 `BaseViewModel`，不自行声明 `MutableStateFlow` / `MutableSharedFlow`
+- [ ] `initialState` 赋予所有字段默认值，写法统一（`= State()`）
+- [ ] `reducer` 是纯函数，只用 `state.copy()`，不含 IO / UseCase 调用
+- [ ] `effectHandler` 不修改 State，只 `emitEffect()`；无副作用事件空实现
+- [ ] `handleIntent` 中调用 UseCase 方法，需要立即反馈 Loading 时先 `dispatch(LoadingEvent)`
+- [ ] `init { startUseCaseListening() }` 必须调用
+- [ ] Compose 容器层使用 `hiltViewModel()` 获取 ViewModel
+- [ ] Activity 使用 `@AndroidEntryPoint`，Application 使用 `@HiltAndroidApp` 且 Manifest 配置 `android:name`
+- [ ] Composable 分为容器层（ViewModel）和纯 UI 层（参数）
+- [ ] Effect 用 `LaunchedEffect(Unit)` 收集
+- [ ] 用户操作只通过 `viewModel.process(Intent)` 传递
+- [ ] 非 Activity 场景手动调用 `viewModelStore.clear()`
+
+## 领域层（Domain）
+
+- [ ] domain 是独立 Gradle module，不与 feature 合并
+- [ ] foundation 通过 AAR 引入：`implementation("com.xxx:foundation:<version>")`
+- [ ] 不依赖 feature 模块
+- [ ] UseCase 接口继承 `Registrable<Callback>`
+- [ ] `register()` 保存 callback 引用并启动监听；`unRegister()` 置 null
+- [ ] 只通过 Callback 接口上报结果，不直接调用 ViewModel
+- [ ] UseCase 不持有 View / Context 引用
+- [ ] 多 UseCase 场景：每个独立注册/注销，`onCleared()` 全部注销
+- [ ] Repository 接口定义在 Domain 层，实现在 Foundation 层
+
+## 基础层（Foundation）
+
+- [ ] Foundation 在独立仓库，以 AAR/Maven 坐标发布
+- [ ] DAO 方法返回 `Flow<T>` 实现响应式数据
+- [ ] 网络调用使用 `suspend` 函数，错误用 `Result` 包裹
+- [ ] Repository 不持有业务状态，不实现 MVI 协议（State/Intent/Event/Effect）
+- [ ] Entity / DTO 与 Domain Model 严格分离，转换在 Repository 层完成
+- [ ] Foundation 层不被 Feature 层直接依赖
+
+## Hilt 模块
+
+- [ ] DatabaseModule：`@Provides @Singleton` 提供 Room Database 和 DAO
+- [ ] RepositoryModule：`@Binds @Singleton` 绑定 Repository 接口到实现类
+- [ ] DomainModule：`@Binds @Singleton` 绑定 UseCase 接口到实现类
+- [ ] CoroutineModule：`@Provides` 提供注入的 Dispatcher（IO / Default / Main）

package/templates/android-compose/skeleton/agent-env/skills/harness-android-architecture/references/udf-data-flow.md

@@ -0,0 +1,80 @@
+# UDF 数据流详解
+
+## 完整数据流图
+
+```
+[用户操作]
+    │
+    ▼
+Composable.onClick / onValueChange
+    │
+    ▼
+viewModel.process(Intent)          ← 统一入口
+    │
+    ▼
+ViewModel.handleIntent(intent)
+    │
+    ├── 需要 UseCase？
+    │       │
+    │       ▼
+    │   UseCase.语义方法()           ← 如 cases.connect(addr)
+    │       │
+    │       ▼
+    │   Repository / 数据源
+    │       │
+    │       ▼
+    │   UseCase Callback 回调        ← callback?.onDeviceConnected(device)
+    │       │
+    │       ▼
+    │   ViewModel useCaseCallback     ← dispatch(Event.Connected(device))
+    │       │
+    │       ▼
+    │   ┌─── MviStore.dispatch(Event)
+    │   │
+    │   ├── Reducer                  ← 纯函数：state.copy(...)
+    │   │       │
+    │   │       ▼
+    │   │   新 State → StateFlow     ← 持久状态，UI collectAsState
+    │   │
+    │   └── EffectHandler            ← 只发射 Effect，不修改 State
+    │           │
+    │           ▼
+    │       Effect → SharedFlow      ← 一次性消费，LaunchedEffect 收集
+    │
+    └── 无需 UseCase（纯 UI 逻辑）
+            │
+            ▼
+        直接 dispatch(Event)          ← 如 dispatch(Event.Loading)
+```
+
+## 关键规则
+
+| 环节 | 规则 |
+|------|------|
+| Intent | 所有用户操作统一通过 `viewModel.process(Intent)`，禁止直接调用 ViewModel 方法 |
+| handleIntent | 只做 Intent → UseCase 调用映射，可立即 dispatch 加载状态 |
+| UseCase Callback | 只调用 `dispatch(Event)`，不做 State 修改 |
+| Reducer | 纯函数，只 `state.copy()`，禁止 IO / UseCase 调用 |
+| EffectHandler | 只 `emitEffect()`，不修改 State，无副作用事件空实现 |
+| State | 不可变 `data class`，所有字段 `val`，更新只用 `.copy()` |
+| Effect | 一次性消费，`SharedFlow(replay = 0)`，用 `LaunchedEffect(Unit)` 收集 |
+
+## 反向数据流（发送信号到 MCU / 外设）
+
+```
+UI 用户操作
+    │
+    ▼
+viewModel.process(Intent.SetEnabled(true))
+    │
+    ▼
+handleIntent → UseCase.setEnabled(true)
+    │
+    ▼
+Repository.sendSignal(...)
+    │
+    ▼
+MCU / 外设
+```
+
+反向流不经过 Reducer / EffectHandler，除非需要更新本地状态（如 Loading）。

package/templates/android-compose/skeleton/agent-env/skills/harness-android-cli/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: harness-android-cli
+description: 使用 `android` 命令行工具编排 Android 开发任务，包括项目创建、部署、SDK 管理和环境诊断。
+---
+
+# Android CLI 专家
+
+本技能提供使用 `android` CLI 工具的说明。该工具包含用于创建项目、运行应用、与设备交互以及管理 CLI 环境的各种命令。
+
+## SDK 管理
+
+- `android sdk install <package>[@<version>]...`：安装指定的包
+- `android sdk update [<pkg-name>]`：将指定的包或所有包更新到最新版本
+- `android sdk remove <pkg-name>`：从本地 SDK 中移除一个包
+- `android sdk list --all`：列出已安装和可用的 SDK 包
+
+## 项目创建
+
+`android create empty-activity --name="My App" --output=./my-app`
+
+## 与设备交互
+
+详见 [references/interact.md](references/interact.md)
+
+## 运行旅程测试
+
+详见 [references/journeys.md](references/journeys.md)
+
+## 文档搜索
+
+`android docs` 命令在 Android 知识库中搜索权威、高质量的 Android 开发者文档。始终使用此工具获取有关 Android 概念的最新信息。
+
+## 运行 APK
+
+使用 `android run` 命令运行 Android 应用。
+
+## 管理模拟器
+
+使用 `android emulator` 命令管理 Android 虚拟设备（AVD）
+
+## 截图
+
+使用 `android screenshot` 命令捕获已连接 Android 设备的当前屏幕图像并输出到文件。
+
+## 管理技能
+
+使用 `android skills` 命令管理 Android 的 antigravity agent 技能。
+
+## 检查 UI 布局
+
+使用 `android layout` 命令检查 Android 应用的 UI 布局。它以 JSON 格式返回 Android 应用的布局树。
+
+## 更新 CLI
+
+使用 `android update` 命令更新 Android CLI。
+
+## 命令速查
+
+| 命令 | 用途 |
+|------|------|
+| `android create` | 创建新的 Android 项目 |
+| `android describe` | 分析 Android 项目生成描述性元数据 |
+| `android docs` | 搜索/获取 Android 文档 |
+| `android emulator` | 管理虚拟设备 |
+| `android info` | 打印环境信息 |
+| `android init` | 初始化 CLI 环境 |
+| `android layout` | 返回应用的布局树 |
+| `android run` | 部署 Android 应用 |
+| `android sdk` | 下载和列出 SDK 包 |
+| `android skills` | 管理技能 |
+| `android update` | 更新 CLI |
+
+---
+
+## 必须遵守的约束规则
+
+> rules 引用路径：`../rules/<rule-name>.mdc`
+
+无（本技能为 CLI 工具操作，不涉及代码生成）