SuperAPI AI 工具集

committing-android-changes

写作与研究

查看项目

更新于 10-15 17:27

技能介绍

用途:为 Bitwarden Android 仓库提供统一的 Git 提交规范与工作流,适用于提交代码、撰写提交信息或准备变更提交的场景。

提交信息格式:首行为 [PM-XXXXX] <type>: <imperative summary>,可附可选正文说明原因而非内容。规则包括:始终包含与 Jira 工单匹配的 [PM-XXXXX] 前缀;在前缀后加入约定式提交类型关键字;使用祈使语气(如 Add feature,而非 Added/Adds);首行摘要不超过 72 字符;正文解释“为什么”而非“做什么”。完整类型关键字表与选择指引需调用 labeling-android-changes 技能。示例:[PM-12345] feat: Add biometric unlock timeout configuration。

后续提交:分支上仅首个提交需要完整格式(工单前缀、类型关键字、正文);后续提交(回应评审、中间改动或本地迭代)可用简短描述性摘要,无需前缀或正文。

提交前检查清单:完整质量门禁需调用 perform-android-preflight-checklist 技能。至少应在暂存与提交前:运行受影响模块测试(正确命令见 build-test-verify 技能);对改动模块执行 ./gradlew detekt 检查 lint;用 git diff --staged 审查已暂存改动,确认无意外修改;确认未暂存任何密钥(API key、token、密码或 .env 文件);确认未暂存生成文件(构建产物、.idea/ 改动或生成代码)。

不应提交的内容:含真实 token 的 .env 或 user.properties;凭据文件或签名密钥库;构建产物(build/、.apk、.aab);IDE 专属文件(.idea/ 改动、*.iml);大型二进制文件。

暂存最佳实践:按文件名逐个暂存,而非 git add -A 或 git add .;每个文件路径单独一行以便阅读,例如 git add \ 后接各文件路径;审查每个待暂存文件以避免误含敏感数据;使用 git status(不加 -uall 标志)查看工作区状态。

限制:资料未提供该技能的具体安装方式、平台支持范围或收费信息。