android-cli-docs-skills

Android CLI：文档与 Skills

何时用本 skill

• 需要 android docs（检索、拉取正文）、理解 kb:// 链接。
• 需要 android skills（列出、向工程或本机安装 skill 包）。
• 需要区分 Cursor 里的 .md skill 与 终端里的 android 命令。

前置条件

• 终端能执行 android（若提示找不到命令：新开终端，或在 PowerShell 中刷新 PATH： $env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [System.Environment]::GetEnvironmentVariable('Path','User')）。
• 具体子命令参数以本机为准：先执行 android docs -h、android docs fetch -h、android skills -h。

android docs（索引与 kb）

1. 首次搜索常会看到索引构建日志（例如 Index created with ... items），属正常。
2. android docs search <关键词> 返回条目；其中的 URL: kb://... 为 CLI 知识库 URI，不能在浏览器中直接打开。
3. 查看正文：用 android docs fetch（参数格式以 android docs fetch -h 为准），把 kb:// 整段作为 fetch 的目标传入。
4. 与 Context7 / 官网：第三方库 API、通用框架文档可用 Context7 或官网；CLI 索引里独有的 kb 条目必须通过 android docs fetch 拉取后再用于回答或贴入对话。

android skills（终端 skill 包）

• android skills list：查看可用技能包列表。
• 安装到当前仓库（供本仓库使用，需在项目根执行）： android skills add --skill=<名称> --project=.
• 安装位置：通常会在工程目录生成/更新与 Android CLI skill 相关的文件；若希望 所有 Cursor 工程共用同一套 Cursor Agent 可读的 SKILL.md，可将对应目录同步或放置到 %USERPROFILE%\.cursor\skills\<skill-name>\（与 项目内 .cursor/skills/ 并存时，在对话中说明「本机全局 vs 本仓库」即可）。
• 与 Cursor：android skills add 提供的是 可被拷贝或同步到 Cursor skills 目录的素材；Agent 是否加载取决于 Cursor 的 skill 发现规则及 SKILL.md 中 description 的匹配，不是 android 命令自动替 Cursor 注册。

与本仓库其他 skill 的配合

• ANR / bugreport / traces：优先使用本仓库 skill parsing-android-anr，而非本页流程。
• Perfetto 采集（adb shell perfetto、.pbtxt、adb pull）：使用 android-perfetto-capture。若要核对 TraceConfig / 平台对 perfetto 的说明，请仍通过本页的 android docs search 与 android docs fetch kb://... 拉取正文后再引用。

输出约定（Agent）

• 若用户只给出 kb://：应先 fetch 再总结；未 fetch 到正文时不得编造文档细节。
• 若检索结果与意图不符：建议用户 收窄关键词或改用 developer.android.com 浏览器检索。