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.
- package/LICENSE +21 -0
- package/README.md +130 -2
- package/android-ui-minimal/SKILL.md +98 -0
- package/android-ui-minimal/references/anti-slop-checklist.md +61 -0
- package/android-ui-minimal/references/clarifying-questions.md +55 -0
- package/android-ui-minimal/references/color-and-contrast.md +104 -0
- package/android-ui-minimal/references/compose-patterns.md +120 -0
- package/android-ui-minimal/references/reconstruction-workflow.md +74 -0
- package/android-ui-minimal/references/typography-spacing.md +93 -0
- package/android-ui-minimal/scripts/contrast.py +68 -0
- package/android-ui-minimal/scripts/gen_tokens.py +165 -0
- package/android-ui-minimal/scripts/lint_ui.py +189 -0
- package/android-ui-security-review/SKILL.md +93 -0
- package/android-ui-security-review/references/checklist.md +95 -0
- package/android-ui-security-review/references/components-intents.md +74 -0
- package/android-ui-security-review/references/compose-risks.md +86 -0
- package/android-ui-security-review/references/input-and-state.md +77 -0
- package/android-ui-security-review/references/network-storage.md +87 -0
- package/android-ui-security-review/references/report-template.md +71 -0
- package/android-ui-security-review/references/sensitive-data-ui.md +73 -0
- package/android-ui-security-review/references/webview.md +105 -0
- package/android-ui-security-review/scripts/scan.py +411 -0
- package/bin/android-skills.js +47 -0
- package/install.py +337 -0
- package/opencode/commands/ui-minimal.md +9 -0
- package/opencode/commands/ui-security.md +9 -0
- 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.
|