thun-res/vlink / .agents/skills/pr
pr
Verified整理 VLink 当前 dev 分支的全部改动,必要时按模块和功能调用 /commit 创建本地提交,安全推送 dev,并向 master 创建或更新 GitHub PR.所有 云端人工填写内容使用简体中文.用户要求"提交 PR"、"创建 PR"、 "dev 合并到 master"或"填写 PR 标题和内容"时使用.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
| agents/openai.yaml | config | 235 B |
SKILL.md
View on GitHub---
name: pr
description: >-
整理 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |