Initialize or optimize claude.md for Android projects. Detect real project structure from Gradle and source folders, merge existing rules such as claude.md and common.mdc, and generate a concise low-token AI guidance file that prioritizes reusing existing architecture, utilities, and coding patterns. Optionally generate minimal verified checklist docs for APIs, dependencies, and modules when explicitly requested. Use when creating or refining Android AI instructions, reducing context tokens, aligning AI behavior with an existing codebase, auditing Android project metadata, or adapting to legacy and mixed Java/Kotlin Android projects.
From android-dev-toolsnpx claudepluginhub adzcsx2/android-claude-skills --plugin android-dev-toolsThis skill uses the workspace's default tool permissions.
README.mdreferences/checklist-templates/api.mdreferences/checklist-templates/dependencies.mdreferences/checklist-templates/modules.mdSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
中文环境要求
- 面向用户的回复、注释、提示信息必须使用中文
- AI 内部分析可以使用英文
- 所有生成文件必须使用 UTF-8 编码
- 对外输出优先简洁、明确、可执行,避免冗长项目介绍
为 Android 项目生成或优化 claude.md,使 AI 工具能够:
/init-android
最终生成或更新的 claude.md 必须满足以下目标:
确认当前目录是 Android 项目。至少满足以下条件之一:
如果不是 Android 项目,直接退出并说明原因。
优先读取并分析已有规则和文档,禁止直接按模板覆盖:
目标不是复制这些文档,而是抽取其中对 AI 最关键的高频约束、真实事实和复用入口。
以下信息必须只从真实来源提取:
如果文档与代码冲突,以代码和构建配置为准;若两者都不明确,再保留谨慎描述。
必须检测而不是臆测:
生成规则时必须写明: 修改代码时优先跟随目标文件和同目录已有绑定模式,不因为偏好擅自迁移。
优先识别这些复用入口:
检查项目真实结构,而不是套预设模板:
不要因为检测到 ViewModel、LiveData、StateFlow 就自动断言项目是完整 MVVM。
默认行为是“优化已有 claude.md”,不是“全量重写”。
只有在以下情况才接近重写:
生成结果必须符合:
生成的 claude.md 应优先包含这些部分:
每一部分都应短、硬、可执行。
生成的 claude.md 必须显式包含并优先前置以下四段,不能只在其他章节中隐含表达:
至少要明确写出:
至少要明确写出:
如果项目使用 .kts 或存在等价文件,可以同时列出。
至少要明确写出:
至少要优先检查并写入:
这些规则优先级高于命名规范、示例代码和通用 Android 最佳实践。
如果 claude.md 包含“相关文档”或“文档索引”部分,必须遵循以下格式规则:
正确示例:
错误示例:
生成 claude.md 时必须尽量固化这些规则:
如果项目中存在明确的资源、工具、常量、存储、日志规范,必须前置写入 claude.md,例如:
注意:这些规则必须来自真实项目实现或已有规范,不能凭空推荐。
不要让命名规范、网络请求示例、技术栈介绍抢在这些强约束之前占据主要篇幅。
默认不生成 docs/checklist/*。
只有在以下情况才生成:
如果生成 checklist,必须遵循:
生成或更新 claude.md 和 *.mdc 后,必须将其添加到项目根目录的 .gitignore。
如果生成了 docs/checklist/ 下的文档(api.md、dependencies.md、modules.md),也必须一并添加到 .gitignore。
这些文件是给 AI 工具看的,不属于项目源码,不应提交到版本控制。
需要添加到 .gitignore 的条目:
# AI guidance files (generated, do not commit)
claude.md
/*.mdc
docs/checklist/api.md
docs/checklist/dependencies.md
docs/checklist/modules.md
执行方式:
对用户的总结说明要包含:
如果输出 claude.md,还必须检查一遍:
.、缺失的 []() 或损坏的列表格式禁止以下做法:
高质量结果应满足: