用途:当用户要为 Kotlin Android 仓库设计或搭建硬质量门禁时使用本技能。范围限定在 Android Gradle 项目,不覆盖 iOS、后端服务或 Web 前端。
必读材料:提出变更前需完整阅读 SKILL.md 同目录下的下列文件,按相对路径渐进式读取:../references/three-layer-model.md、../references/landing-safety.md、../references/github-review-and-rulesets.md、../references/invocation-examples.md、../references/gate-levels-and-template.md、references/platform-quality-gates.md、references/concrete-rules.md。
流程:先检查目标仓库中的 AGENTS.md、Gradle wrapper、convention plugin、build.gradle.kts、GitHub 工作流、hook 脚本、Detekt、Spotless、Android Lint、测试任务与已有 affected-check 代码;再按三层结构形成方案。若需扩展规则或确认最新规则名,先查 references/concrete-rules.md 的官方文档入口,不要只凭记忆补规则。用 ../references/gate-levels-and-template.md 的分级表给出推荐档位与取舍,不替用户决定档位。随后停在 confirmation-before-write 闸门,展示计划创建或修改的精确文件与远端设置,请求用户明确批准。批准后落地最窄但有用的脚手架,运行新的本地入口,并报告仍需手工处理的 GitHub 设置。
三层结构:第一层检查工具,识别可执行的 Android 检查,如 Gradle 构建和测试任务、Spotless、Detekt、Android Lint、截图或 preview 检查、自定义 affected-quality 编排入口、依赖或模块图检查;第二层检查规则,把每个工具映射到其执行的规则,如格式化、Kotlin 静态分析、Android 资源正确性、模块边界、本地化、依赖约束、截图契约或 preview 契约;第三层调用时机,决定检查运行位置,如本地 hook 提供快速反馈、拉取请求工作流作为权威、required status check 阻塞合并、定时工作流承载慢回归、GitHub ruleset 约束审查要求。
输出形态:返回简洁脚手架方案,包含计划创建或修改的文件、第一层工具表、第二层规则表、第三层调用时机表、confirmation-before-write 提示,以及实现后的验证命令。