Skip to content

thun-res/vlink / .agents/skills/pr

整理 VLink 当前 dev 分支的全部改动,必要时按模块和功能调用 /commit 创建本地提交,安全推送 dev,并向 master 创建或更新 GitHub PR.所有 云端人工填写内容使用简体中文.用户要求"提交 PR"、"创建 PR"、 "dev 合并到 master"或"填写 PR 标题和内容"时使用.

创建 dev 到 master 的 PR

本 skill 只处理 thun-res/vlink 的 dev → master PR,不切换分支、 不 force-push、不合并 PR.先读仓库根 AGENTS.md、 .agents/skills/commit/SKILL.md、.agents/CI-AND-PR.md、 .github/PULL_REQUEST_TEMPLATE.md 与 doc/15-contributing.md §15.9/§15.11/§15.12.

这是维护者的长期集成分支提交入口,不替代贡献文档中普通功能分支到 master 的 PR 流程。

本 skill 写入 GitHub 的 PR 标题、正文及其他人工填写内容必须使用 简体中文。type/scope、代码标识、路径、分支、命令和原始错误信息 保持原文;模板固有标题不视为填写内容。

1. 检查本地状态

  1. 用 gh auth status 和 gh repo view --json nameWithOwner 确认账号可用 且仓库为 thun-res/vlink;不要打印可能含凭据的 remote URL.
  2. 当前分支必须严格为 dev;detached HEAD 或其他分支直接停止,不得为了 省事携带工作树改动切分支.
  3. 存在 staged、unstaged 或 untracked 改动时,完整执行 /commit 的 分组、message 和逐组提交流程.提交后重新检查工作树;除 ignored 文件外 仍有改动时不得创建 PR.
  4. 执行 git fetch origin master dev,确认:
    • origin/master 是当前 HEAD 的祖先;
    • origin/dev 也是当前 HEAD 的祖先.

任一条件不满足都停止并说明分叉关系;不得自动 merge、rebase、reset 或 force-push.

2. 分析 PR 内容

以 origin/master...HEAD 为唯一 PR diff,同时读取 origin/master..HEAD 的 commit 列表:

  • 按模块和功能归纳重要变化,不逐文件复述.
  • 明确用户可见行为、重要缺陷修复、性能变化、兼容影响和必要的同步项.
  • 区分实际执行的验证与未执行项;不得根据 commit message 推断测试通过.
  • 检查 diff 是否混入构建产物、缓存、敏感信息或与本 PR 无关的改动.
  • diff 为空时停止;改动明显包含多个互不相关主题且无法形成可评审 PR 时 停止并报告,不得用宽泛标题掩盖.

3. 生成中文云端内容

标题沿用最重要改动的 Conventional Commit 形式: type(scope): 中文动宾短语.其中 type/scope 保留英文标识,其余使用 简体中文;不加句号、不使用"更新"、"调整"、"若干修复"等空泛表述, 总长不超过 72 字符.

正文严格沿用 .github/PULL_REQUEST_TEMPLATE.md 的五节,内容使用中文:

  1. Summary / 概述:3–6 条,按模块/功能说明做了什么以及为什么.
  2. Type of change / 变更类型:只勾选实际类型.
  3. Related issues / 关联 Issue:只写已知 Closes/Refs;没有则写 "无",不猜 issue 编号.
  4. How was this tested? / 如何测试:逐条列出实际执行的命令、平台和 结果;未构建或未测试必须如实写明.
  5. Checklist / 检查项:只有证据确认通过的项目写 [x],其余保持 [ ] 并在下方简述原因,不得为了 PR 好看虚假勾选.

正文保持紧凑,重要内容不能遗漏,也不粘贴完整 commit/file 清单.

4. 推送并创建或更新 PR

  1. 用 git push origin dev:dev 正常推送;禁止 --force 和 --force-with-lease.
  2. 查询 head=dev、base=master 的 open PR:
    • 不存在时,用 gh pr create --repo thun-res/vlink --head dev --base master --title ... --body-file ... 创建.
    • 恰有一个时,核对它确属当前分支后用 gh pr edit 更新标题和正文, 不创建重复 PR.
    • 存在多个匹配项或 PR base/head 异常时停止.
  3. 正文临时文件用 mktemp 创建,命令结束后删除;不得在仓库内留下草稿.
  4. 创建/更新后用 gh pr view 核对 URL、title、base/head、状态和正文, 并确认所有人工填写内容均为简体中文;不自动添加 reviewer、label、 assignee,不自动 merge.

显式调用本 skill 已授权本次正常 push 和创建/更新 PR,无需重复确认; 任何 force、历史改写、换 base 或合并操作仍必须另行确认.

5. 完成后报告

返回 PR 编号、URL、中文标题、base/head、包含的 commit 摘要和已触发的 CI.同时列出未执行验证与剩余工作树改动;确认未 force-push、未合并 PR.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall