SuperAPI AI 工具集

commit-work

通用与其它

查看项目

更新于 10-15 23:33

技能介绍

用途:commit-work 用于在用户要求暂存改动、创建 Git 提交、把工作拆分为多个逻辑提交或撰写提交信息时,按规范流程完成提交。

主要能力:读取仓库说明,检查当前分支、git status、未暂存与已暂存 diff;识别用户授权范围,保留无关、既有、被忽略和未跟踪的改动;选择最少的逻辑提交,把不相关关注点分开,同时把不可分离的实现与针对性测试放在一起;从仓库说明和近期提交推断信息约定,仅在仓库要求或用户要求时使用 Conventional Commits;按明确路径暂存,混合文件用补丁暂存,避免 git add .、git add -A 和 git commit -am,除非确认整个工作区都在范围内;审查 git diff --cached、git diff --cached --stat 和 git diff --cached --check,检查无关改动、调试输出、凭据、生成文件和误删;对暂存行为运行最小有意义的验证并记录真实结果;根据暂存结果撰写提交信息,主题具体且用祈使句,必要时在正文说明原因或用户可见影响,仅在真实且符合仓库惯例时添加 issue、co-author、sign-off 或 breaking-change 尾注;不绕过钩子提交,用 git show --stat --oneline --decorate HEAD 核对主题与范围,再对下一个边界重复,最后用 git status -sb 和提交列表核对。

使用方式:在 Codex 技能环境中调用该技能,按上述流程操作。撰写或审查提交信息时读取 references/commit-message-template.md;仅当仓库使用 Conventional Commits 时读取 references/conventional-commit-types.md。

适用场景:需要把工作区改动整理成清晰、可审查的 Git 提交时。

限制与安全:直接要求提交只授权暂存和提交预期范围,不授权推送;未经明确授权,不得丢弃、重置、amend、rebase 或包含无关用户改动;不得仅为让提交通过而使用 --no-verify;未观察到输出前不得声称检查已运行或通过。交付物为报告每个提交的哈希与主题、范围、运行的检查以及剩余工作区改动。