用途:为仓库提供标准化的 commit + push + PR 流程,确保提交前检查已运行、提交信息一致、推送与强推行为可控。适用于遵循该仓库约定的项目。
主要能力与约定:不得直接提交到 main,需从 main 创建功能分支并走 PR;PR/issue 标题用英文,PR 正文与评论默认简体中文(请求以 [EN] 开头时除外);避免使用 GitHub CLI 的 --body 加转义换行,优先用 --body-file 或 stdin,防止出现字面 \n;技能针对 Windows PowerShell 5.1+ 编写,Bash 示例为可选。
使用方式:分支阶段执行 git fetch origin --prune、git switch main、git pull --ff-only、git switch -c docs/example-change。提交前确认当前改动范围所需检查已运行并记录确切命令,仅暂存目标文件(推荐 git add -p),用文件写提交信息以避免多 -m 格式问题;标题格式为 prefix: subject 或 prefix(scope): subject,仅英文,建议不超过 50 字符(硬换行不超过 72),无句末句号;非平凡改动需正文,标题后空一行,72 列换行,含风险与验证说明。推送仅在检查通过后进行,新分支优先 git push -u origin <branch>,避免强推;若需重写历史(如凭据泄露清理)须明确确认,并预期分支规则会阻止强推,除非临时调整;若使用 git-filter-repo,它可能自动移除 origin,推送前需重新添加。推送前检查清单:已执行检查并记录确切命令、提交标题与正文符合仓库规则、用户明确批准推送(尤其是 --force)。PR 默认创建草稿。
创建 PR 的四种方式:A 用 GitHub CLI(gh --version、gh auth status,再以 --body-file - 创建草稿 PR);B 浏览器方式,推送分支后打开 https://github.com/<owner>/<repo>/pull/new/<branch>;C 用 GitHub API(PowerShell,编码安全),通过环境变量 token 发送 UTF-8 字节请求;D 无 gh 且无 GITHUB_TOKEN 时,用 git credential fill 复用 git 已有凭据。用 PowerShell 经 GitHub API 编辑 PR 正文时,将 JSON 序列化为无 BOM 的 UTF-8 字节以可靠保留中文;避免打印 token 或 Authorization 头。
限制:资料未提供该技能的具体安装命令、依赖版本、收费方式与平台支持范围,暂未提供。