用途：为 AI 智能体或脚本提供可解析、跨 Git 版本与用户配置稳定的 Git 命令写法，核心原则是使用 --porcelain 等机器可读输出。
主要能力：状态查询支持 git status --porcelain=v2 --branch、--porcelain、--short --branch，并给出 v2 格式字段与状态码说明；差异查询支持 --stat、--numstat、--name-status、--name-only，以及暂存区、指定提交、分支间比较；日志支持 --format 自定义占位符（如 %H、%s、%an）与按作者、日期、路径、合并提交过滤；分支与远程支持 git branch -vv、--format、--show-current、git remote -v、git remote get-url origin，以及用 git rev-list --left-right --count 查看领先/落后。
使用方式：在当前仓库直接运行 git 命令；跨仓库时用 -C 指定路径，例如 git -C "$repo" status --porcelain。提交信息可用 heredoc 写法，注意引号定界符内反引号、$ 与反斜杠已是字面量，不要再转义。推送支持 git push origin HEAD、git push -u origin HEAD 及 main:feature-branch 等写法。上下文表达式中建议用 2>/dev/null 抑制错误，而非 || 回退。
适用场景：需要确定性输出供解析器或下游工具消费时；读取分支跟踪信息、统计改动行数、提取提交字段时。与 GitHub API 相关的 JSON 查询应改用 gh-cli-agentic；提交暂存规范与信息结构参考 git-commit-workflow；分支与 PR 设计参考 git-branch-pr-workflow；从提交历史挖掘文档参考 git-derive-docs。
限制：资料未提供安装方式、收费、平台支持与效果数据；部分命令（如 --amend、restore 丢弃改动）需谨慎使用。