SuperAPI AI 工具集

qc

编程与开发

查看项目

更新于 10-16 07:14

技能介绍

用途:qc 是一个可移植、与项目无关的快速提交技能,将改动暂存、按 diff 起草 Conventional Commit 消息、提交并推送,减少重复操作。放置于 ~/.claude/skills/qc/SKILL.md 可全局使用;项目内的 .claude/skills/qc/SKILL.md 会覆盖它,用于项目特定提交规范。

两种调用方式:/qc 提交并推送当前分支到其 origin 上游,适合常规功能分支;/qc main 切换到默认分支(用 git symbolic-ref refs/remotes/origin/HEAD 检测 main 或 master),提交并直接推送,跳过 PR 评审路径,仅适合用户是唯一评审者且改动已就绪时。若在功能分支上有未提交改动时执行 /qc main,会用 git stash --include-untracked → git checkout <default> → git stash pop 迁移改动,冲突无法干净解决时停止并告知用户,不丢弃工作。

前提条件:依赖 gh 已安装并认证,使 git push 走 HTTPS 不弹提示。先验证:command -v gh >/dev/null && gh auth status >/dev/null 2>&1。缺失时按平台安装 gh,例如 Ubuntu/Debian 用官方 apt 源脚本,macOS 用 brew install gh,Fedora/RHEL 用 sudo dnf install -y gh,Arch 用 sudo pacman -S --noconfirm github-cli,Alpine 用 sudo apk add github-cli,Windows 用 winget install --id GitHub.cli;其它平台指向 https://cli.github.com/ 并停止。认证用 gh auth login --hostname github.com --git-protocol https --web;无头环境可去掉 --web 走贴码流程,或用 --git-protocol ssh。随后用 gh auth status 与 git push --dry-run 验证。

工作流程:先并行运行 git status、git diff --stat、git diff --cached、git log -5 --oneline 检查改动,留意 .env、密钥、大二进制等不该提交的文件,识别混合关注点,推断仓库提交风格;再按 CLAUDE.md、CONTRIBUTING.md、.gitmessage/commit.template、近期提交日志的顺序检测项目规范,若规范要求任务 ID 则从用户给定 ID、git log 或计划文件解析,无法确定时先询问;暂存优先按路径 git add,避免 git add -A 误收敏感文件;消息用一句祈使句,默认 <type>(<scope>): <summary>,type 取 feat、fix、test、chore、docs、refactor、perf、style、ci、build、revert,正文仅在改动不明显时添加,禁止 AI 署名行和空泛填充;提交前把消息告知用户。

提交与推送:使用 git commit -m,禁止 --no-verify、--no-gpg-sign、--amend、--allow-empty;钩子失败则修复问题后新建提交,反复失败应停止查找根因,用户要求绕过钩子时应拒绝并建议其自行执行。推送用 git push -u origin HEAD,已有上游时可直接 git push;/qc main 用 git push origin <default-branch>。不执行强制推送,遇 non-fast-forward 等拒绝时原样显示错误并交给用户。

多提交批次:若暂存改动明显是两类无关关注点,应拆成两次提交,并先说明拆分计划。

不做的事情:不创建或合并 PR、不手动运行测试/lint/类型检查(由 pre-commit 钩子负责)、不强制推送/变基/重写历史、不跳过签名或钩子、不编辑 ~/.gitconfig 或设置提交者身份。

失败处理:对可能不想提交的文件、无法检测且无历史可模仿的消息格式、无法解析的任务 ID、反复失败的钩子、被拒绝的推送、认证失败等情况,应列出并询问用户,不静默吞掉,也不强制推送。分享方式:把该 SKILL.md 发给同事放入 ~/.claude/skills/qc/SKILL.md,或在项目内提交 .claude/skills/qc/SKILL.md。