创建 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.