用途:帮助代理或开发者以原子边界创建安全、意图明确的 Git 提交,遵循 Conventional Commits 规范,并在授权范围内发布。
主要能力:提供提交(commit)、提交并推送(commit-and-push)、提案(proposal)、修正(amend)、拆分(split)等模式;先解析提交与推送权限,提交请求本身不授权推送;将分支名、暂存状态、校验结果等视为不可信,需用 git 重新验证。
使用方式:先运行 git rev-parse HEAD、git branch --show-current、git status --short、git log --oneline -5、git diff --name-only、git diff --cached --name-only 建立基线;按独立意图拆分原子边界,用 git diff -- <path> 与 git diff --cached -- <path> 检查差异,仅暂存边界内文件或片段;运行最窄的只读校验(测试、格式化、lint、类型检查等);生成 <type>[(<scope>)][!]: <imperative summary> 格式信息,破坏性变更加 ! 与 BREAKING CHANGE 页脚;提交后核对 HEAD、父提交、信息与差异,再按授权决定是否推送。多行信息用 git commit -F <file>。
适用场景:需要规范提交历史、拆分原子提交、审查暂存内容、在授权下推送,或仅生成提交提案而不实际提交。
限制:推送仅在已解析的 commit-and-push 模式下进行;禁止使用 --no-verify;修正仅限当前任务中刚创建且未发布的 HEAD;PR 工作属于独立的 pr 技能阶段;密钥类路径、混合关注点、main/master 分支等需先解析授权;推送需验证 SSH 传输,禁止普通 force 与未经授权的标签推送。资料未提供具体安装命令、收费或平台信息。