SuperAPI AI 工具集

voyager-contribute

编程与开发

查看项目

更新于 10-16 01:33

技能介绍

用途:为 Voyager 项目准备并发布贡献,走 Issue、主题分支、验证、提交、拉取请求的标准工作流;在认领或实现 Issue 时使用。相关环节可交由其他技能:Issue 调查用 issue-review,Safari 加载或原生验证用 update-safari-extension,发布用 release。

预检:检查 git status --short --branch、当前分支与 diff,保留无关改动;阅读关联 Issue 及评论,新功能需维护者在 Issue 或任务中明确批准方案,分配或 /claim 仅确定负责人;非平凡改动前阅读 .github/docs/REGRESSION_NOTES.md 相关条目;只在针对 main 的单一主题分支工作,禁止提交密钥与生成的 dist_* 产物;阅读 repo-traps.md。以 gh 作为 Issue/PR 状态来源,写入前用 gh auth status 确认账号;无 GitHub CLI 时改用网页界面并在 PR 中注明。

验证:行为变更需新增或更新回归测试,无可用自动化测试要记录原因。先运行 bun run format、bun run lint,再运行 bun run verify:pr,并检查 git diff --check、git status --short;verify:pr 覆盖本地自动化与生产浏览器构建,但不证明扩展已加载或线上行为可用。涉及运行时、UI、清单、权限、打包、原生或插件的改动,需阅读 browser-testing.md 并收集实测证据。省略的命令或浏览器检查须记录原因,必要但需他人完成的覆盖要写明浏览器与负责人并保持待办。

提交与发布:仅暂存预期路径,创建 Conventional Commit,scope 小写、标题不超过 100 字符,可按需加 Fixes #<issue> 或 Closes #<issue>,保留项目标准共同作者页脚(Codex 用 Co-authored-by: Codex codex@users.noreply.github.com)。用 git show --stat --format=fuller HEAD 与 git status --short 检查,贡献路径不得有暂存或未暂存改动。获授权后只推送主题分支并对 main 开或更新草稿 PR;贡献者不得直接推送 main,强制推送需用户明确同意,该仓库采用 squash 合并。PR 中说明 Issue 或授权依据、范围、被测提交、运行命令、浏览器证据、UI 截图与待办检查;评审后改动需重跑受影响检查,交接前用 gh 核对作者、目标分支、提交集、改动文件与 CI 状态。Issue 修复落地后,用报告者语言留简短评论说明已修复、下版本可用,问题仍存在可重开。限制:未提供价格、平台支持范围与效果保证等信息。