免费在 GitHub 公开

android-ui-guidelines

Jetpack ComposeでUIを実装する時に参照するコーディングガイドライン。「Android UI」「Compose」「Jetpack」「画面実装」「UIコンポーネント」「レイアウト」と言われたら使う。Android/Kotlin UI実装のベストプラクティス、アンチパターン、実装パターンを提供する。

中文简介正在准备中。当前显示原文说明。

xtone/ai_development_tools

查看安装方法

包含的文件（2）

SKILL.md2.6 KB
REFERENCE.md25.7 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Android UIコーディングガイドライン

Jetpack ComposeによるUI実装のベストプラクティスを提供するスキルです。

このスキルが提供するもの

基本原則: 宣言的UI、単一方向データフロー、状態ホイスティング
Composable設計: 命名規則、Modifier、コンポーネント分割
State管理: UiState設計、ViewModel連携、Side Effects
実装パターン: リスト、フォーム、ナビゲーション、エラー、ローディング
パフォーマンス最適化: Recomposition防止、LazyList最適化
アンチパターン: 避けるべき実装パターン
テスタビリティ: テスト可能な設計

クイックリファレンス

Composable関数の基本形

@Composable
fun MyComponent(
    // 1. 必須パラメータ
    data: Data,
    onClick: () -> Unit,
    // 2. オプショナルパラメータ
    enabled: Boolean = true,
    // 3. Modifier（常にデフォルト値）
    modifier: Modifier = Modifier
) {
    // 渡されたmodifierを最上位要素に適用
    Box(modifier = modifier) {
        // 実装
    }
}

UiState設計

sealed interface ScreenUiState {
    data object Loading : ScreenUiState
    data class Success(val data: Data) : ScreenUiState
    data class Error(val message: String) : ScreenUiState
}

LazyColumnの基本

LazyColumn {
    items(
        items = items,
        key = { it.id }  // 必ずkeyを指定
    ) { item ->
        ItemCard(item = item)
    }
}

詳細ガイドライン

詳細な実装パターンとガイドラインは REFERENCE.md を参照してください。

チェックリスト

実装前

再利用可能なコンポーネントか確認
状態ホイスティングを適用できるか確認
Modifierパラメータを追加したか

実装中

keyをLazyListに指定したか
重い処理をrememberでキャッシュしたか
副作用をLaunchedEffect等で適切に処理しているか

実装後

@Previewが動作するか
不要なRecompositionがないか
テストコードを書いたか

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

android-api-client

免费

Retrofit + OkHttpを使用したAPIクライアント実装のベストプラクティスを提供する。「API実装」「APIクライアント」「Retrofit」「OkHttp」「ネットワーク」と言われたら使う。

中文简介正在准备中。当前显示原文说明。