android-skills 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +130 -2
  3. package/android-ui-minimal/SKILL.md +98 -0
  4. package/android-ui-minimal/references/anti-slop-checklist.md +61 -0
  5. package/android-ui-minimal/references/clarifying-questions.md +55 -0
  6. package/android-ui-minimal/references/color-and-contrast.md +104 -0
  7. package/android-ui-minimal/references/compose-patterns.md +120 -0
  8. package/android-ui-minimal/references/reconstruction-workflow.md +74 -0
  9. package/android-ui-minimal/references/typography-spacing.md +93 -0
  10. package/android-ui-minimal/scripts/contrast.py +68 -0
  11. package/android-ui-minimal/scripts/gen_tokens.py +165 -0
  12. package/android-ui-minimal/scripts/lint_ui.py +189 -0
  13. package/android-ui-security-review/SKILL.md +93 -0
  14. package/android-ui-security-review/references/checklist.md +95 -0
  15. package/android-ui-security-review/references/components-intents.md +74 -0
  16. package/android-ui-security-review/references/compose-risks.md +86 -0
  17. package/android-ui-security-review/references/input-and-state.md +77 -0
  18. package/android-ui-security-review/references/network-storage.md +87 -0
  19. package/android-ui-security-review/references/report-template.md +71 -0
  20. package/android-ui-security-review/references/sensitive-data-ui.md +73 -0
  21. package/android-ui-security-review/references/webview.md +105 -0
  22. package/android-ui-security-review/scripts/scan.py +411 -0
  23. package/bin/android-skills.js +47 -0
  24. package/install.py +337 -0
  25. package/opencode/commands/ui-minimal.md +9 -0
  26. package/opencode/commands/ui-security.md +9 -0
  27. package/package.json +43 -4
@@ -0,0 +1,93 @@
1
+ # Tipografi, spacing, radius, elevasi
2
+
3
+ ## Spacing (kelipatan 4dp)
4
+
5
+ | Token | Nilai | Pemakaian |
6
+ |---|---|---|
7
+ | `xs` | 4dp | Jarak ikon ke label, antar baris teks rapat |
8
+ | `sm` | 8dp | Jarak dalam komponen |
9
+ | `md` | 12dp | Padding vertikal baris list |
10
+ | `lg` | 16dp | Margin layar, jarak antar grup kecil |
11
+ | `xl` | 24dp | Jarak antar seksi |
12
+ | `xxl` | 32dp | Jarak seksi besar, ruang atas header |
13
+ | `touch` | 48dp | Tinggi minimum target sentuh |
14
+
15
+ Margin horizontal layar: 16dp di ponsel, 24dp di tablet kecil. Konsisten di seluruh aplikasi.
16
+
17
+ ```kotlin
18
+ object Space {
19
+ val xs = 4.dp; val sm = 8.dp; val md = 12.dp
20
+ val lg = 16.dp; val xl = 24.dp; val xxl = 32.dp
21
+ }
22
+ ```
23
+
24
+ Aturan ritme: jarak di dalam grup lebih kecil dari jarak antar grup. Jika semua jarak sama, hierarki hilang.
25
+
26
+ ## Tipografi
27
+
28
+ Pakai skala Material 3 lewat `MaterialTheme.typography`. Jangan membuat ukuran baru di layar.
29
+
30
+ | Peran | Style | Catatan |
31
+ |---|---|---|
32
+ | Judul layar | `titleLarge` | Satu per layar |
33
+ | Judul seksi | `titleMedium` | Weight medium |
34
+ | Body | `bodyLarge` / `bodyMedium` | Weight regular |
35
+ | Keterangan | `bodySmall` | `onSurfaceVariant` |
36
+ | Tombol | `labelLarge` | |
37
+
38
+ Aturan:
39
+ - Maksimal dua weight per layar (regular dan medium, atau regular dan semibold).
40
+ - Jangan memakai huruf kapital semua untuk teks panjang. Judul pendek saja, dan hindari `letterSpacing` agresif.
41
+ - Panjang baris nyaman 40-75 karakter. Di tablet batasi lebar konten (`widthIn(max = 640.dp)`).
42
+ - Tinggi baris (line height) 1.4 sampai 1.6 untuk body.
43
+ - Font: default sistem sudah baik. Satu keluarga font kustom maksimal, dimuat lewat resource font, bukan dari URL tanpa verifikasi.
44
+ - Angka tabular (`fontFeatureSettings = "tnum"`) untuk kolom angka agar sejajar.
45
+
46
+ ## Radius
47
+
48
+ Pilih satu skala dan pakai konsisten:
49
+
50
+ | Token | Nilai | Pemakaian |
51
+ |---|---|---|
52
+ | `small` | 8dp | Chip, field |
53
+ | `medium` | 12dp | Card, dialog kecil |
54
+ | `large` | 16dp | Bottom sheet |
55
+
56
+ Jangan pakai radius besar seragam (24dp+) di semua elemen. Itu cepat terbaca sebagai template.
57
+
58
+ ## Elevasi dan batas
59
+
60
+ Urutan preferensi untuk memisahkan elemen:
61
+ 1. Spasi
62
+ 2. Perbedaan tonal (`surfaceContainer`)
63
+ 3. Garis 1dp `outlineVariant`
64
+ 4. Bayangan (hanya untuk elemen yang benar-benar melayang: FAB, menu, dialog)
65
+
66
+ Tanpa bayangan berlapis, tanpa glow, tanpa border tebal berwarna.
67
+
68
+ ## Ikon
69
+
70
+ - Satu set (Material Symbols atau `Icons.Outlined`). Jangan campur gaya filled dan outlined sembarangan.
71
+ - Ukuran 24dp standar, 20dp untuk inline dengan teks.
72
+ - Ikon tanpa label hanya untuk aksi yang sangat umum (kembali, tutup, cari).
73
+
74
+ ## Daftar (list)
75
+
76
+ - Baris polos dengan divider tipis atau spasi cukup untuk daftar homogen.
77
+ - Card hanya jika tiap item berisi beberapa bagian dan perlu aksi sendiri.
78
+ - Leading visual (avatar, ikon) hanya jika mengidentifikasi item. Bukan dekorasi.
79
+ - Gunakan `key` stabil di `LazyColumn`.
80
+
81
+ ## Form
82
+
83
+ - Label selalu terlihat (bukan hanya placeholder).
84
+ - Pesan error di bawah field, jelas, dengan teks.
85
+ - Satu tombol utama. Aksi sekunder berupa tombol teks.
86
+ - Atur `KeyboardOptions` sesuai isi (email, angka, password) dan `imeAction`.
87
+
88
+ ## Empty, loading, error
89
+
90
+ Tiga state ini wajib ada untuk setiap layar berdata:
91
+ - Empty: satu kalimat penjelas + satu aksi jika relevan. Tanpa ilustrasi dekoratif.
92
+ - Loading: indikator sederhana atau skeleton netral. Jangan blokir seluruh layar jika sebagian data sudah ada.
93
+ - Error: apa yang gagal dan apa yang bisa dilakukan (coba lagi).
@@ -0,0 +1,68 @@
1
+ #!/usr/bin/env python3
2
+ """Kalkulator kontras WCAG 2.2.
3
+
4
+ Pemakaian:
5
+ python3 contrast.py <fg> <bg> [<fg2> <bg2> ...]
6
+
7
+ Warna: #RGB, #RRGGBB, 0xFFRRGGBB, atau AARRGGBB (urutan Android).
8
+ Jika fg punya alpha, dicampur di atas bg sebelum dihitung.
9
+ Kode keluar 1 jika ada pasangan yang gagal AA teks normal (4.5:1).
10
+ """
11
+ import sys
12
+
13
+
14
+ def parse(s):
15
+ h = s.strip().lstrip("#")
16
+ if h.lower().startswith("0x"):
17
+ h = h[2:]
18
+ if len(h) == 3:
19
+ h = "".join(c * 2 for c in h)
20
+ if len(h) == 6:
21
+ h = "FF" + h
22
+ if len(h) != 8:
23
+ raise ValueError(f"format warna tidak dikenal: {s}")
24
+ a = int(h[0:2], 16) / 255
25
+ return a, tuple(int(h[i:i + 2], 16) for i in (2, 4, 6))
26
+
27
+
28
+ def blend(fg, a, bg):
29
+ return tuple(round(f * a + b * (1 - a)) for f, b in zip(fg, bg))
30
+
31
+
32
+ def lin(c):
33
+ c /= 255
34
+ return c / 12.92 if c <= 0.03928 else ((c + 0.055) / 1.055) ** 2.4
35
+
36
+
37
+ def lum(rgb):
38
+ r, g, b = map(lin, rgb)
39
+ return 0.2126 * r + 0.7152 * g + 0.0722 * b
40
+
41
+
42
+ def ratio(fg, bg):
43
+ hi, lo = sorted((lum(fg), lum(bg)), reverse=True)
44
+ return (hi + 0.05) / (lo + 0.05)
45
+
46
+
47
+ def main(argv):
48
+ if len(argv) < 2 or len(argv) % 2:
49
+ print(__doc__)
50
+ return 2
51
+ failed = False
52
+ for i in range(0, len(argv), 2):
53
+ a, fg = parse(argv[i])
54
+ _, bg = parse(argv[i + 1])
55
+ eff = blend(fg, a, bg) if a < 1 else fg
56
+ r = ratio(eff, bg)
57
+ aa = r >= 4.5
58
+ large = r >= 3.0
59
+ aaa = r >= 7.0
60
+ failed |= not aa
61
+ print(f"{argv[i]:>12} on {argv[i + 1]:<12} {r:5.2f}:1 "
62
+ f"teks normal AA {'lulus' if aa else 'GAGAL'} | "
63
+ f"teks besar/komponen {'lulus' if large else 'GAGAL'} | AAA {'lulus' if aaa else 'tidak'}")
64
+ return 1 if failed else 0
65
+
66
+
67
+ if __name__ == "__main__":
68
+ sys.exit(main(sys.argv[1:]))
@@ -0,0 +1,165 @@
1
+ #!/usr/bin/env python3
2
+ """Pembuat token warna dari satu warna aksen.
3
+
4
+ Menghasilkan Color.kt dan Theme.kt (Compose, Material 3) dengan netral
5
+ terang dan gelap yang sedikit bernuansa aksen, lalu memverifikasi kontras.
6
+
7
+ Pemakaian:
8
+ python3 gen_tokens.py "#3B5BA9" [--package com.contoh.app] [--out app/src/main/java/com/contoh/app/ui/theme]
9
+
10
+ Tanpa --out, hasil dicetak ke stdout.
11
+ """
12
+ import argparse
13
+ import colorsys
14
+ import os
15
+ import sys
16
+
17
+ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
18
+ from contrast import parse, ratio # noqa: E402
19
+
20
+
21
+ def to_hls(rgb):
22
+ return colorsys.rgb_to_hls(*[x / 255 for x in rgb])
23
+
24
+
25
+ def from_hls(h, l, s):
26
+ return tuple(round(x * 255) for x in colorsys.hls_to_rgb(h, min(max(l, 0), 1), min(max(s, 0), 1)))
27
+
28
+
29
+ def kt(rgb):
30
+ return "0xFF%02X%02X%02X" % rgb
31
+
32
+
33
+ def build(accent_hex):
34
+ _, acc = parse(accent_hex)
35
+ h, l, s = to_hls(acc)
36
+ s = min(s, 0.6)
37
+
38
+ def neutral(light, sat=0.05):
39
+ return from_hls(h, light, sat)
40
+
41
+ light = {
42
+ "background": neutral(0.965), "surface": neutral(0.995, 0.02),
43
+ "surfaceVariant": neutral(0.93), "outlineVariant": neutral(0.85),
44
+ "onSurface": neutral(0.11, 0.06), "onSurfaceVariant": neutral(0.36, 0.05),
45
+ }
46
+ dark = {
47
+ "background": neutral(0.07), "surface": neutral(0.10),
48
+ "surfaceVariant": neutral(0.14), "outlineVariant": neutral(0.24),
49
+ "onSurface": neutral(0.91, 0.04), "onSurfaceVariant": neutral(0.67, 0.04),
50
+ }
51
+
52
+ pl = l
53
+ p_light = from_hls(h, pl, s)
54
+ while ratio(p_light, light["background"]) < 4.5 and pl > 0.05:
55
+ pl -= 0.02
56
+ p_light = from_hls(h, pl, s)
57
+
58
+ pd = max(l, 0.70)
59
+ p_dark = from_hls(h, pd, min(s, 0.65))
60
+ while ratio(p_dark, dark["background"]) < 4.5 and pd < 0.95:
61
+ pd += 0.02
62
+ p_dark = from_hls(h, pd, min(s, 0.65))
63
+
64
+ ink = (0x10, 0x14, 0x18)
65
+ white = (255, 255, 255)
66
+
67
+ def on(c):
68
+ return white if ratio(white, c) >= ratio(ink, c) else ink
69
+
70
+ light.update(primary=p_light, onPrimary=on(p_light), error=(0xB3, 0x26, 0x1E), onError=white)
71
+ dark.update(primary=p_dark, onPrimary=on(p_dark), error=(0xF2, 0xB8, 0xB5), onError=(0x60, 0x14, 0x10))
72
+ return light, dark
73
+
74
+
75
+ def checks(light, dark):
76
+ pairs = [("onSurface", "background"), ("onSurface", "surface"),
77
+ ("onSurfaceVariant", "background"), ("onSurfaceVariant", "surface"),
78
+ ("onPrimary", "primary"), ("primary", "background"), ("error", "background")]
79
+ rows, ok = [], True
80
+ for name, scheme in (("terang", light), ("gelap", dark)):
81
+ for fg, bg in pairs:
82
+ r = ratio(scheme[fg], scheme[bg])
83
+ need = 3.0 if fg == "primary" else 4.5
84
+ good = r >= need
85
+ ok &= good
86
+ rows.append(f"{name:6} {fg:17} / {bg:11} {r:5.2f}:1 {'ok' if good else 'GAGAL (butuh ' + str(need) + ')'}")
87
+ return rows, ok
88
+
89
+
90
+ def color_kt(pkg, light, dark):
91
+ out = [f"package {pkg}.ui.theme", "", "import androidx.compose.ui.graphics.Color", ""]
92
+ for prefix, sch in (("Light", light), ("Dark", dark)):
93
+ for k, v in sch.items():
94
+ out.append(f"internal val {prefix}{k[0].upper() + k[1:]} = Color({kt(v)})")
95
+ out.append("")
96
+ return "\n".join(out)
97
+
98
+
99
+ def scheme_kt(prefix, sch, fn):
100
+ names = ["primary", "onPrimary", "background", "surface", "surfaceVariant",
101
+ "outlineVariant", "onSurface", "onSurfaceVariant", "error", "onError"]
102
+ lines = [f"private val {prefix}Colors = {fn}("]
103
+ for n in names:
104
+ lines.append(f" {n} = {prefix}{n[0].upper() + n[1:]},")
105
+ lines.append(" onBackground = %sOnSurface," % prefix)
106
+ lines.append(" outline = %sOutlineVariant," % prefix)
107
+ lines.append(")")
108
+ return "\n".join(lines)
109
+
110
+
111
+ def theme_kt(pkg):
112
+ return f"""package {pkg}.ui.theme
113
+
114
+ import androidx.compose.foundation.isSystemInDarkTheme
115
+ import androidx.compose.material3.MaterialTheme
116
+ import androidx.compose.material3.darkColorScheme
117
+ import androidx.compose.material3.lightColorScheme
118
+ import androidx.compose.runtime.Composable
119
+
120
+ {scheme_kt("Light", None, "lightColorScheme")}
121
+
122
+ {scheme_kt("Dark", None, "darkColorScheme")}
123
+
124
+ @Composable
125
+ fun AppTheme(
126
+ darkTheme: Boolean = isSystemInDarkTheme(),
127
+ content: @Composable () -> Unit,
128
+ ) {{
129
+ MaterialTheme(
130
+ colorScheme = if (darkTheme) DarkColors else LightColors,
131
+ content = content,
132
+ )
133
+ }}
134
+ """
135
+
136
+
137
+ def main():
138
+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
139
+ ap.add_argument("accent")
140
+ ap.add_argument("--package", default="com.example.app")
141
+ ap.add_argument("--out")
142
+ a = ap.parse_args()
143
+
144
+ light, dark = build(a.accent)
145
+ rows, ok = checks(light, dark)
146
+ ck, th = color_kt(a.package, light, dark), theme_kt(a.package)
147
+
148
+ if a.out:
149
+ os.makedirs(a.out, exist_ok=True)
150
+ for name, body in (("Color.kt", ck), ("Theme.kt", th)):
151
+ with open(os.path.join(a.out, name), "w", encoding="utf-8") as fh:
152
+ fh.write(body)
153
+ print(f"Ditulis: {a.out}/Color.kt, Theme.kt")
154
+ else:
155
+ print("// ===== Color.kt =====\n" + ck + "\n// ===== Theme.kt =====\n" + th)
156
+
157
+ print("\nVerifikasi kontras:", file=sys.stderr)
158
+ print("\n".join(rows), file=sys.stderr)
159
+ if not ok:
160
+ print("\nAda pasangan yang gagal. Sesuaikan aksen atau netral.", file=sys.stderr)
161
+ sys.exit(0 if ok else 1)
162
+
163
+
164
+ if __name__ == "__main__":
165
+ main()
@@ -0,0 +1,189 @@
1
+ #!/usr/bin/env python3
2
+ """Linter gaya UI untuk proyek Android (Kotlin Compose dan XML Views).
3
+
4
+ Memeriksa pelanggaran aturan skill android-ui-minimal:
5
+ emoji, warna hardcode, gradien, ukuran font ad hoc, spacing di luar skala 4dp,
6
+ radius besar, bayangan berat, contentDescription kosong, teks hardcode.
7
+
8
+ Pemakaian:
9
+ python3 lint_ui.py <path> [--json] [--strict] [--include-tests]
10
+
11
+ Kode keluar: 1 jika ada error (atau warn dengan --strict), selain itu 0.
12
+ Tekan suatu aturan pada satu baris dengan komentar: // ui-ignore: RULE_ID
13
+ """
14
+ import argparse
15
+ import json
16
+ import os
17
+ import re
18
+ import sys
19
+
20
+ SKIP_DIRS = {"build", ".git", ".gradle", ".idea", ".cxx", "node_modules", "generated"}
21
+ THEME_FILES = {"Color.kt", "Theme.kt", "Type.kt", "Shape.kt", "Spacing.kt", "Dimens.kt",
22
+ "colors.xml", "themes.xml", "styles.xml", "dimens.xml", "strings.xml", "attrs.xml"}
23
+
24
+ EMOJI = re.compile("[\U0001F000-\U0001FAFF☀-➿⭐⭕️]")
25
+ SYMBOL = re.compile("[←-⇿•]")
26
+ IGNORE = re.compile(r"ui-ignore:\s*([A-Z_]+)")
27
+
28
+ HEX_KT = re.compile(r"Color\(\s*0x[0-9A-Fa-f]{6,8}\s*\)|Color\.parseColor\(")
29
+ NAMED = re.compile(r"\bColor\.(Red|Green|Blue|Yellow|Cyan|Magenta|Gray|LightGray|DarkGray)\b")
30
+ PURE = re.compile(r"\bColor\.(Black|White)\b|0xFF000000|0xFFFFFFFF")
31
+ GRADIENT = re.compile(r"Brush\.(linear|vertical|horizontal|radial|sweep)Gradient|<gradient")
32
+ FONT_SIZE = re.compile(r"fontSize\s*=\s*\d+(\.\d+)?\.sp")
33
+ DP = re.compile(r"(\d+(?:\.\d+)?)\.dp")
34
+ DP_CTX = re.compile(r"padding|spacedBy|\.size\(|height|width|offset|Spacer|defaultMinSize")
35
+ RADIUS = re.compile(r"RoundedCornerShape\(\s*(\d+(?:\.\d+)?)\.dp")
36
+ ELEVATION = re.compile(r"[eE]levation\s*=\s*(\d+(?:\.\d+)?)\.dp|\.shadow\(")
37
+ CD_EMPTY = re.compile(r'contentDescription\s*=\s*""')
38
+ TEXT_LIT = re.compile(r'\bText\(\s*(text\s*=\s*)?"[^"$]*[A-Za-z][^"$]*"')
39
+ ALPHA_TEXT = re.compile(r"color\s*=.*\.copy\(\s*alpha\s*=\s*0\.[0-5]")
40
+ DURATION = re.compile(r"durationMillis\s*=\s*(\d+)")
41
+ CARD = re.compile(r"\b(Elevated|Outlined)?Card\(")
42
+
43
+ X_HEX = re.compile(r"#[0-9A-Fa-f]{6,8}\b")
44
+ X_TEXTSIZE = re.compile(r'android:textSize="\d+(\.\d+)?(sp|dp)"')
45
+ X_TEXT = re.compile(r'android:text="(?!@)[^"]*[A-Za-z][^"]*"')
46
+ X_DP = re.compile(r'android:(layout_margin\w*|padding\w*)="(\d+(?:\.\d+)?)dp"')
47
+
48
+
49
+ def is_theme(path):
50
+ p = path.replace("\\", "/").lower()
51
+ return os.path.basename(path) in THEME_FILES or "/theme/" in p or "/ui/theme" in p
52
+
53
+
54
+ def off_scale(v):
55
+ f = float(v)
56
+ return f not in (0, 0.5, 1, 2) and f % 4 != 0
57
+
58
+
59
+ def lint_kotlin(path, lines, out):
60
+ theme = is_theme(path)
61
+ cards = 0
62
+ for i, line in enumerate(lines, 1):
63
+ s = line.strip()
64
+ is_comment = s.startswith("//") or s.startswith("*") or s.startswith("/*")
65
+ if not theme and not is_comment:
66
+ if HEX_KT.search(line):
67
+ out.append((path, i, "error", "HEX_COLOR", "Warna hardcode di luar tema. Pakai MaterialTheme.colorScheme."))
68
+ if NAMED.search(line):
69
+ out.append((path, i, "error", "NAMED_COLOR", "Warna bernama (Color.Red dll). Pakai token tema."))
70
+ if PURE.search(line):
71
+ out.append((path, i, "warn", "PURE_BW", "Hitam atau putih murni. Pakai token tema (onSurface, surface)."))
72
+ if FONT_SIZE.search(line):
73
+ out.append((path, i, "error", "FONT_SIZE", "fontSize ad hoc. Pakai MaterialTheme.typography."))
74
+ if ALPHA_TEXT.search(line):
75
+ out.append((path, i, "warn", "FADED_TEXT", "Teks dengan alpha rendah, kontras bisa di bawah 4.5:1."))
76
+ no_radius = RADIUS.sub("", line)
77
+ if DP_CTX.search(no_radius):
78
+ for m in DP.finditer(no_radius):
79
+ if off_scale(m.group(1)):
80
+ out.append((path, i, "warn", "DP_OFF_SCALE",
81
+ f"{m.group(1)}.dp di luar skala 4dp (4, 8, 12, 16, 24, 32, 48)."))
82
+ break
83
+ for m in RADIUS.finditer(line):
84
+ if float(m.group(1)) >= 24:
85
+ out.append((path, i, "warn", "RADIUS_LARGE", "Radius 24dp atau lebih. Pakai skala 8/12/16."))
86
+ m = ELEVATION.search(line)
87
+ if m and (m.group(0).startswith(".shadow") or float(m.group(1)) >= 8):
88
+ out.append((path, i, "warn", "HEAVY_SHADOW", "Bayangan berat. Utamakan tonal atau garis tipis."))
89
+ m = DURATION.search(line)
90
+ if m and int(m.group(1)) > 400:
91
+ out.append((path, i, "warn", "SLOW_ANIM", f"Animasi {m.group(1)} ms. Target 150-250 ms."))
92
+ if not is_comment:
93
+ if GRADIENT.search(line):
94
+ out.append((path, i, "warn", "GRADIENT", "Gradien. Hindari kecuali diminta."))
95
+ if CD_EMPTY.search(line):
96
+ out.append((path, i, "warn", "CD_EMPTY", 'contentDescription = "" . Pakai null untuk dekoratif.'))
97
+ if TEXT_LIT.search(line):
98
+ out.append((path, i, "info", "HARDCODED_TEXT", "Teks hardcode. Pindahkan ke strings.xml."))
99
+ if CARD.search(line):
100
+ cards += 1
101
+ if cards > 4:
102
+ out.append((path, 1, "info", "CARD_HEAVY", f"{cards} Card di satu file. Pertimbangkan baris polos."))
103
+
104
+
105
+ def lint_xml(path, lines, out):
106
+ p = path.replace("\\", "/")
107
+ ui_xml = "/res/layout" in p or "/res/drawable" in p
108
+ for i, line in enumerate(lines, 1):
109
+ if ui_xml:
110
+ if "tools:" in line:
111
+ continue
112
+ if X_HEX.search(line):
113
+ sev = "warn" if "/res/drawable" in p else "error"
114
+ out.append((path, i, sev, "HEX_COLOR_XML", "Warna hardcode di layout/drawable. Rujuk atribut tema."))
115
+ if X_TEXTSIZE.search(line):
116
+ out.append((path, i, "warn", "FONT_SIZE_XML", "textSize hardcode. Pakai textAppearance."))
117
+ if X_TEXT.search(line):
118
+ out.append((path, i, "info", "HARDCODED_TEXT", "Teks hardcode. Pindahkan ke strings.xml."))
119
+ for m in X_DP.finditer(line):
120
+ if off_scale(m.group(2)):
121
+ out.append((path, i, "warn", "DP_OFF_SCALE", f"{m.group(2)}dp di luar skala 4dp."))
122
+ if "<gradient" in line:
123
+ out.append((path, i, "warn", "GRADIENT", "Gradien. Hindari kecuali diminta."))
124
+
125
+
126
+ def walk(root, include_tests):
127
+ if os.path.isfile(root):
128
+ yield root
129
+ return
130
+ for d, dirs, files in os.walk(root):
131
+ dirs[:] = [x for x in dirs if x not in SKIP_DIRS
132
+ and (include_tests or x not in ("test", "androidTest"))]
133
+ for f in files:
134
+ if f.endswith((".kt", ".xml", ".java")):
135
+ yield os.path.join(d, f)
136
+
137
+
138
+ def main():
139
+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
140
+ ap.add_argument("path")
141
+ ap.add_argument("--json", action="store_true")
142
+ ap.add_argument("--strict", action="store_true", help="warn juga menggagalkan (exit 1)")
143
+ ap.add_argument("--include-tests", action="store_true")
144
+ a = ap.parse_args()
145
+
146
+ found = []
147
+ for path in walk(a.path, a.include_tests):
148
+ try:
149
+ with open(path, encoding="utf-8", errors="replace") as fh:
150
+ lines = fh.read().splitlines()
151
+ except OSError:
152
+ continue
153
+ local = []
154
+ for i, line in enumerate(lines, 1):
155
+ if EMOJI.search(line):
156
+ local.append((path, i, "error", "EMOJI", "Emoji atau simbol dekoratif. Hapus."))
157
+ elif SYMBOL.search(line):
158
+ local.append((path, i, "warn", "SYMBOL", "Karakter unicode dekoratif (panah, bullet). Pakai ikon atau teks."))
159
+ if path.endswith((".kt", ".java")):
160
+ lint_kotlin(path, lines, local)
161
+ elif path.endswith(".xml"):
162
+ lint_xml(path, lines, local)
163
+ for f in local:
164
+ ln = f[1]
165
+ ctx = " ".join(lines[max(0, ln - 2):ln])
166
+ m = IGNORE.search(ctx)
167
+ if m and m.group(1) == f[3]:
168
+ continue
169
+ found.append(f)
170
+
171
+ order = {"error": 0, "warn": 1, "info": 2}
172
+ found.sort(key=lambda f: (order[f[2]], f[0], f[1]))
173
+ counts = {k: sum(1 for f in found if f[2] == k) for k in order}
174
+
175
+ if a.json:
176
+ print(json.dumps({"counts": counts, "findings": [
177
+ {"file": f[0], "line": f[1], "severity": f[2], "rule": f[3], "message": f[4]} for f in found]},
178
+ indent=2, ensure_ascii=False))
179
+ else:
180
+ for f in found:
181
+ print(f"[{f[2].upper():5}] {f[3]:15} {f[0]}:{f[1]} {f[4]}")
182
+ print(f"\nRingkasan: {counts['error']} error, {counts['warn']} warn, {counts['info']} info")
183
+
184
+ bad = counts["error"] + (counts["warn"] if a.strict else 0)
185
+ sys.exit(1 if bad else 0)
186
+
187
+
188
+ if __name__ == "__main__":
189
+ main()
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: android-ui-security-review
3
+ description: Audit keamanan frontend/lapisan UI aplikasi Android native (Kotlin, Jetpack Compose, XML Views) termasuk WebView, exported components, deep link, intent/PendingIntent, kebocoran data layar, clipboard/log, validasi input, cleartext traffic, penyimpanan, dan secret hardcode. Gunakan saat diminta security review, vulnerability assessment, pemeriksaan sebelum rilis, atau hardening frontend. Baca-saja secara default.
4
+ license: MIT
5
+ compatibility: opencode, Claude Code, dan agent lain yang membaca SKILL.md
6
+ metadata:
7
+ platform: android
8
+ language: kotlin
9
+ version: "1.1.0"
10
+ ---
11
+
12
+ # Android UI Security Review
13
+
14
+ Skill ini untuk mencari celah yang lahir dari lapisan UI dan frontend aplikasi Android. SKILL.md hanya alur dan aturan. Katalog pemeriksaan ada di `references/`, pemindai otomatis ada di `scripts/scan.py`. Baca referensi yang relevan sebelum menyimpulkan apa pun.
15
+
16
+ ## Alur kerja
17
+
18
+ 1. **Tentukan ruang lingkup.** Folder mana, modul mana, build variant apa (debug atau release), targetSdk berapa. Jika tidak jelas, tanyakan. Jangan memeriksa di luar folder yang diberikan.
19
+ 2. **Pindai otomatis:**
20
+ ```
21
+ python3 scripts/scan.py <path-proyek> --format md --out security-report.md
22
+ ```
23
+ Opsi: `--min-severity medium`, `--format json`, `--fail-on high` (untuk CI), `--include-tests`.
24
+ 3. **Verifikasi manual setiap temuan.** Pemindai itu regex, bukan analisis aliran data. Buka file, baca konteks, tentukan apakah benar-benar dapat dieksploitasi. Tandai sebagai terkonfirmasi, mungkin, atau false positive.
25
+ 4. **Telusuri area yang tidak tertangkap pemindai** memakai `references/checklist.md`: logika deep link, alur login, layar pembayaran, penyimpanan token, share intent, FileProvider.
26
+ 5. **Laporkan** dengan `references/report-template.md`. Urutkan menurut tingkat keparahan, sertakan lokasi, dampak, dan perbaikan konkret.
27
+ 6. **Perbaiki hanya jika diminta.** Jika diminta, buat perubahan sekecil mungkin per temuan, satu temuan satu perubahan, dan jelaskan efek sampingnya.
28
+
29
+ ## Aturan keras
30
+
31
+ - **Baca-saja secara default.** Jangan mengubah file, menambah dependency, atau mengubah konfigurasi build kecuali user meminta perbaikan.
32
+ - **Jangan menulis exploit.** Jangan membuat malware, payload aktif, atau PoC yang siap dipakai menyerang aplikasi pihak lain. Jelaskan langkah reproduksi secara konseptual dan minimal (misalnya "kirim intent dengan extra X ke activity Y") untuk aplikasi milik user sendiri.
33
+ - **Hanya aplikasi milik user atau yang diizinkan.** Jika terlihat user meminta menyerang aplikasi pihak lain, berhenti dan jelaskan batasnya.
34
+ - **Jangan mencetak secret utuh.** Jika menemukan API key, token, atau kunci privat, tampilkan 4 karakter awal saja dan sarankan rotasi.
35
+ - **Jangan mengklaim "aman".** Katakan "tidak ditemukan masalah pada pemeriksaan ini" dan sebutkan apa yang tidak diperiksa.
36
+ - **Tanya jika ambigu.** Tidak jelas apakah ini aplikasi publik atau internal, memproses data sensitif atau tidak, atau target rilisnya. Konteks itu mengubah tingkat keparahan.
37
+ - **Bedakan debug dan release.** Temuan di `src/debug/` atau di balik `BuildConfig.DEBUG` diturunkan tingkatnya, tetapi tetap dicatat bila bisa bocor ke release.
38
+ - **Jujur soal batas.** Pemindai ini tidak menggantikan pentest, review arsitektur, atau analisis backend.
39
+ - **Tanpa emoji** di laporan dan kode.
40
+
41
+ ## Tingkat keparahan
42
+
43
+ | Tingkat | Arti | Contoh |
44
+ |---|---|---|
45
+ | critical | Dapat dieksploitasi langsung, dampak besar | Trust-all SSL, kunci privat di repo |
46
+ | high | Dieksploitasi dengan kondisi ringan | `addJavascriptInterface` dengan konten tak tepercaya, provider exported tanpa izin |
47
+ | medium | Butuh kondisi tertentu atau memperlemah pertahanan | Tanpa FLAG_SECURE di layar sensitif, `allowBackup` aktif |
48
+ | low | Hardening | Log stack trace, `printStackTrace()` |
49
+ | info | Titik untuk dicek manual | Parameter deep link |
50
+
51
+ Detail penilaian ada di `references/report-template.md`.
52
+
53
+ ## Cakupan pemeriksaan
54
+
55
+ 1. WebView dan konten web (`references/webview.md`)
56
+ 2. Komponen, intent, deep link, PendingIntent, FileProvider (`references/components-intents.md`)
57
+ 3. Data sensitif di layar: screenshot, recents, clipboard, autofill, keyboard, log, state tersimpan (`references/sensitive-data-ui.md`)
58
+ 4. Input dan state: injeksi, path traversal, argumen navigasi tak tepercaya (`references/input-and-state.md`)
59
+ 5. Jaringan dan penyimpanan dari sudut pandang UI (`references/network-storage.md`)
60
+ 6. Compose spesifik: `rememberSaveable`, semantics, `AndroidView`, text field (`references/compose-risks.md`)
61
+
62
+ ## Peta file
63
+
64
+ | File | Isi |
65
+ |---|---|
66
+ | `references/checklist.md` | Daftar periksa bernomor lengkap (ID dipakai oleh pemindai dan laporan) |
67
+ | `references/webview.md` | Konfigurasi WebView aman dan anti-pola |
68
+ | `references/components-intents.md` | Exported, intent filter, deep link, PendingIntent |
69
+ | `references/sensitive-data-ui.md` | Kebocoran lewat layar dan perangkat |
70
+ | `references/input-and-state.md` | Validasi input dan data dari luar |
71
+ | `references/network-storage.md` | Cleartext, trust manager, penyimpanan |
72
+ | `references/compose-risks.md` | Risiko khusus Compose |
73
+ | `references/report-template.md` | Format laporan dan penilaian keparahan |
74
+ | `scripts/scan.py` | Pemindai statis |
75
+
76
+ ## Menemukan skrip
77
+
78
+ Path skrip relatif terhadap folder skill ini. Jika tidak ditemukan dari direktori kerja, cari:
79
+
80
+ ```
81
+ find ~/.config/opencode .opencode ~/.claude .claude -path '*android-ui-security-review/scripts/scan.py' 2>/dev/null
82
+ ```
83
+
84
+ ## Menekan false positive
85
+
86
+ Tambahkan komentar pada baris yang sama atau baris sebelumnya, lengkap dengan alasan:
87
+
88
+ ```kotlin
89
+ // sec-ignore: W-JS konten lokal dari assets, tidak memuat URL eksternal
90
+ settings.javaScriptEnabled = true
91
+ ```
92
+
93
+ Jangan menekan temuan tanpa alasan tertulis.