准备拉取请求(PR)的辅助技能,参数为可选的 issue 编号($ARGUMENTS),未提供时继续执行、不强制要求 issue。
用途:在创建 PR 前完成分支、提交、变更记录和 PR 描述等前置工作。
主要步骤:
- 运行 git status 与 git branch 了解当前状态。
- 无分支名且位于 main 分支时,依据代码改动创建分支;若在 worktree 中,则基于 worktree 分支创建分支且不改名;其他情况在当前分支继续。
- 运行 git log 与 git diff main...HEAD 审阅相对主分支的全部改动。
- 按 changeset 规范在 .changeset/ 目录手动新增文件,摘要采用约定式提交风格并匹配 PR 标题。版本规则:patch 对应缺陷修复、小幅增强、UI 微调、性能优化、重构、i18n 新增、单个配置开关等;minor 对应用户可感知的独立新功能、新 AI 提供方支持、重大 UI 改版、面向用户的新配置系统等;major 极少使用,须获用户明确批准,适用于配置格式不兼容、移除既有功能、API/存储破坏性变更、根本性迁移。
- 暂存并提交所有未提交改动;不要提交 docs/ 下的 PR 描述 Markdown(仅本地复制粘贴用),若被误暂存需从索引移除并保留本地文件。
- 推送分支,必要时运行 git push -u origin <branch-name>。
- 在 docs/ 新建 Markdown 文件,按 .github/PULL_REQUEST_TEMPLATE.md 模板撰写完整 PR 描述;提供了 issue 编号则用 Closes #<issue-number> 写入;未提供时仅在易于识别时才搜索相关 issue,否则留空而不阻塞流程。该文件保持未提交状态。
提交约定类型:feat、fix、docs、style、refactor、test、chore、build、ci、perf、revert、i18n、ai;格式为 type(scope): description。
参考:PR 模板 .github/PULL_REQUEST_TEMPLATE.md;项目指南 CLAUDE.md。
限制:无其他平台或收费等信息,暂未提供。