一份 AGENTS.md，让 Android AI 代码规范率从 30% 飙升到 95%

一、从一个所有 Android 开发者都在踩的坑说起

现在用 Cursor、Trae 或 Copilot 写 Android 代码。你一定遇到过这种高血压场景：

项目明明全用 Jetpack Compose 梭哈了AI 却突然给你手写了一个 findViewById；或者在 Kotlin 协程里它顺手写了个 Thread.sleep 甚至疯狂用 !， 强解空指针。

AIs 的编程能力很强，但它不知道你团队的规矩。

"这段代码我根本不敢提交！"

二、主要机理：AI 接收上下文的决策链路

graph TD
A --> B{检查根目录}
B -->|无 AGENTS.md| C
C --> D
D --> E
B -->|存在 AGENTS.md| F
F --> G
G --> H
style E fill:#ffcccc,stroke:#f58c8c,stroke-width:2px
style H fill:#ccffcc,stroke:#8cff8c,stroke-width:2px
style A fill:#f9f9f9,stroke:#ddd,stroke-width:1px
style B fill:#e6e6e6,stroke:#ccc,stroke-width:1px
style C fill:#dcdcdc,stroke:#aaa,stroke-width:1px
style D fill:#d3d3d3,stroke:#bbb,stroke-width:1px
style F fill:#ebebeb,stroke:#ddd,stroke-width:1px
style G fill:#f2f2f2,stroke:#eee,stroke-width:1px
label E "危险：需要人工完全重构"
label H "安全：可直接提交"
label C "⚠️ 公共训练集数据可能包含过时技术"
label G "🔒 自定义约束将优先级提至最高"

三、没有 AGENTS.md vs 有 AGENTS.md

"一样的需求输入。不同输出质量"

// ❗️ 人工修正点: // - 加入Loading状态处理 // - 添加错误边界判断

▲ % ▲ % ▲ %

// ❗️ 人工修正点: // - 加入缓存策略选项

▲ % ▲ %

- UI布局采用XML方式实现 - 颜色资源未使用MaterialTheme.colorScheme程序调色板 - 动态数据更新未考虑Recomposition效率