| name | git-commit |
| description | 按单一行为拆分、验证并创建中文 Conventional Commit；用户要求提交、创建 commit 或使用 $git-commit 时使用。 |
严格 Git 提交
这是 AcePocket 项目级提交规则，优先于用户级同名技能。只在用户明确要求提交时执行；普通开发、修复或审查不自动 commit、push 或打 tag。
提交边界
一个提交只表达一个可独立描述、验证和回滚的意图。判断只看三件事：是否同一意图、是否能独立回滚、是否能用同一组验证命令验证。
必须拆分：
- 独立功能或互不相关的 Bug。
- 功能与无关重构、格式化、文档、CI 或构建改动。
- 普通改动与安全修复、版本号或发版改动。
- 无法由同一操作解释的生成文件。
保持同一提交：
- 实现及其直接回归测试。
- Bug 根因修复及必要的调用方适配。
- 同一功能所需的模型、repo、provider、页面和路由。
- 依赖升级及其必需的 API 迁移和锁文件。
- 重命名及必要的引用更新。
同一文件混有多个逻辑改动时，优先 git add -p。如果 hunk 无法安全拆分，不重写用户代码制造边界，不整文件强行提交；报告原因并等待用户选择合并、整理或暂缓。
发现多个清晰逻辑组时，展示每组的 type、说明、文件和验证，然后按组提交。只有边界不清晰或会改变用户改动时才暂停询问，不要求用户为明确的拆分重复确认。
提交信息
格式：
<type>[optional scope][!]: <中文说明>
允许的 type：feat、fix、refactor、perf、test、docs、build、ci、style、chore、revert。
- type 和 scope 使用英文小写，说明、正文和 footer 使用中文。
- 标题不超过 72 个字符，使用祈使式，不加句号。
- 破坏性变更使用
!，并在正文说明迁移影响；也可使用 BREAKING CHANGE: footer。
- 不添加模型签名、自动生成声明或无意义正文。
执行流程
- 读取
git status --porcelain=v1、git diff、git diff --staged、git diff --check 和最近提交。
- 保留用户已有暂存内容；暂存区非空时不把未暂存内容静默混入。
- 按逻辑组用显式路径暂存；同文件多组才用
git add -p，不要默认 git add -A。
- 提交前重新检查
git diff --staged --check、staged diff 和敏感文件。
- 运行适合风险的门禁，全部通过后执行一次或按组执行
git commit。
- 提交后检查新 HEAD、剩余工作区和提交统计；明确告知未 push。
禁止：git reset --hard、git checkout --、git clean、未授权的 git restore、修改 Git 配置、--no-verify、对用户提交 amend、强推、删除 tag 或自动发布。
敏感信息门禁
拒绝提交以下路径或等价内容：.env、.env.*、android/key.properties、*.jks、*.keystore、*.p12、*.pfx、*.pem、*.key、id_rsa*、id_ed25519*。同时检查 staged diff 中的 API token、密码、私钥、GitHub token、签名密码和真实生产凭据。命中后停止，不删除文件，也不输出秘密原文。
验证门禁
所有提交至少运行：
git diff --check
git diff --staged --check
按变更风险追加：
- Dart 行为：
flutter analyze 和受影响测试。
- core、路由、存储、分页、跨模块或高风险共享逻辑：完整
flutter test。
- 安全、加密、证书或签名：完整测试及对应专项测试。
pubspec.yaml 或依赖：flutter pub get、flutter analyze、完整测试。- Android Manifest 或 Gradle：
cd android && ./gradlew :app:processReleaseManifest。
- Android 发布链路：追加
flutter build apk --release --target-platform android-arm64。
- 仅文档或纯格式化：Git 门禁即可。
必需门禁失败时不得提交。Git hook 失败后修复问题并创建新提交，不跳过 hook、不 amend。
