Skip to content

Comments

docs: enhance upgrade guide with Agent Skills instructions#7141

Merged
chenjiahan merged 2 commits intomainfrom
upgrade_guide_skills_0204
Feb 4, 2026
Merged

docs: enhance upgrade guide with Agent Skills instructions#7141
chenjiahan merged 2 commits intomainfrom
upgrade_guide_skills_0204

Conversation

@chenjiahan
Copy link
Member

@chenjiahan chenjiahan commented Feb 4, 2026

Summary

Expanded the upgrade guide with detailed instructions, including using Coding Agent Skills to assist with the migration, explicit upgrade steps for @rsbuild/core and plugins, and clarified the dependency on @rspack/core v2.

Related Links

Checklist

  • Tests updated (or not required).
  • Documentation updated (or not required).

Copilot AI review requested due to automatic review settings February 4, 2026 09:15
@chatgpt-codex-connector
Copy link

chatgpt-codex-connector bot commented Feb 4, 2026

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@gemini-code-assist
Copy link
Contributor

gemini-code-assist bot commented Feb 4, 2026

Summary of Changes

Hello @chenjiahan, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly improves the Rsbuild v1 to v2 upgrade documentation by introducing new sections that guide users through the migration process. It highlights the utility of Coding Agent Skills for automated assistance, provides explicit steps for updating core Rsbuild packages and plugins, and clarifies the underlying dependency on Rspack v2. The aim is to streamline the upgrade experience and ensure users have clear, actionable instructions.

Highlights

  • Enhanced Upgrade Guide: The v1-to-v2.mdx documentation (both English and Chinese versions) has been significantly expanded to provide more comprehensive instructions for upgrading Rsbuild from version 1 to 2.
  • Agent Skills Integration: New guidance has been added on how to leverage Coding Agent Skills, specifically the rsbuild-v2-upgrade skill, to assist users with the migration process.
  • Explicit Upgrade Steps: Detailed instructions are now included for upgrading @rsbuild/core to its 2.0 Beta release and for updating all associated Rsbuild plugins to their latest versions using npx taze major.
  • Dependency Clarification: The documentation now more clearly states Rsbuild v2's dependency on @rspack/core v2 and advises on potential adjustments for custom Rspack configurations.
  • Dependency Update: The heading-case development dependency has been updated from 1.0.4 to 1.0.6 in package.json and pnpm-lock.yaml.
Changelog
  • package.json
    • Updated heading-case dev dependency from ^1.0.4 to ^1.0.6.
  • pnpm-lock.yaml
    • Updated heading-case dependency version and integrity hash to 1.0.6.
  • website/docs/en/guide/upgrade/v1-to-v2.mdx
    • Added a new section "Using Agent Skills" detailing how to use the rsbuild-v2-upgrade skill for migration.
    • Introduced a new section "Upgrade Rsbuild to v2" with instructions for updating @rsbuild/core to ^2.0.0-beta.0 and other Rsbuild plugins.
    • Restructured and updated the "Rspack v2" section for better clarity on its dependency.
  • website/docs/zh/guide/upgrade/v1-to-v2.mdx
    • Added a new section "使用 Agent Skills" (Using Agent Skills) with instructions for using the rsbuild-v2-upgrade skill.
    • Introduced a new section "升级 Rsbuild 到 v2" (Upgrade Rsbuild to v2) with steps for updating @rsbuild/core to ^2.0.0-beta.0 and other Rsbuild plugins.
    • Restructured and updated the "Rspack v2" section for better clarity on its dependency.
Activity
  • The pull request description indicates that documentation has been updated, which is confirmed by the changes to the .mdx files. No other specific review comments, approvals, or progress updates are available in the provided context.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist[bot]
gemini-code-assist bot reviewed Feb 4, 2026
View reviewed changes
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request enhances the upgrade guide by adding instructions for using Agent Skills and providing clearer steps for manual upgrades. The changes are well-structured and improve the documentation. I've suggested a couple of minor improvements to the links in the documentation for better navigation.

Copilot AI reviewed Feb 4, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Enhances the v1 → v2 upgrade documentation by adding Agent Skills guidance and more explicit dependency upgrade steps, plus a small dev-dependency bump.

Changes:

  • Added “Agent Skills” instructions and explicit Rsbuild/plugin upgrade commands in both EN/ZH upgrade guides.
  • Reorganized the Rspack v2 guidance into its own section with clarified dependency notes.
  • Bumped heading-case from ^1.0.4 to ^1.0.6 (and updated pnpm-lock.yaml accordingly).

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

File Description
website/docs/zh/guide/upgrade/v1-to-v2.mdx Adds Agent Skills + explicit v2 upgrade steps (contains a malformed GitHub link).
website/docs/en/guide/upgrade/v1-to-v2.mdx Adds Agent Skills + explicit v2 upgrade steps (suggest adding a doc link for clarity).
package.json Updates heading-case devDependency version.
pnpm-lock.yaml Locks heading-case to 1.0.6.
Files not reviewed (1)
  • pnpm-lock.yaml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

website/docs/zh/guide/upgrade/v1-to-v2.mdx Outdated
## 使用 Agent Skills

Rsbuild v2 现在依赖 [@rspack/core](https://www.npmjs.com/package/@rspack/core) v2。
如果你在使用支持 Skills 的 Coding Agent，可以安装 [rsbuild-v2-upgrade](https://github.com/rstackjs/agent-skills?rsbuild-v2-upgrade) 技能来辅助完成 v1 到 v2 的升级流程。
Copy link

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The rsbuild-v2-upgrade link URL looks malformed (https://github.com/rstackjs/agent-skills?rsbuild-v2-upgrade). As written it won’t navigate to the intended section on GitHub (it’s treated as an unknown query string). Update it to a proper URL/anchor (e.g. the README section for #rsbuild-v2-upgrade).

Suggested change
如果你在使用支持 Skills 的 Coding Agent，可以安装 [rsbuild-v2-upgrade](https://github.com/rstackjs/agent-skills?rsbuild-v2-upgrade) 技能来辅助完成 v1 到 v2 的升级流程。
如果你在使用支持 Skills 的 Coding Agent，可以安装 [rsbuild-v2-upgrade](https://github.com/rstackjs/agent-skills#rsbuild-v2-upgrade) 技能来辅助完成 v1 到 v2 的升级流程。

Copilot uses AI. Check for mistakes.
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 4, 2026 •
edited
Loading

Deploying rsbuild with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7abda02
Status: ✅  Deploy successful!
Preview URL: https://e24da269.rsbuild-v2.pages.dev
Branch Preview URL: https://upgrade-guide-skills-0204.rsbuild-v2.pages.dev

View logs

@chenjiahan chenjiahan merged commit e27fc98 into main Feb 4, 2026
6 checks passed
@chenjiahan chenjiahan deleted the upgrade_guide_skills_0204 branch February 4, 2026 09:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

+1 more reviewer

@gemini-code-assist gemini-code-assist[bot] gemini-code-assist[bot] left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

release: document

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@chenjiahan