贡献流程类
- create-pr — 指导创建 Git 分支、提交代码、推送并通过
gh命令开 PR,包括处理 PR 模板格式和 Codex 分支命名规范。 - backport-pr — 将已合并到
canary的 PR cherry-pick 回旧版本 release 分支(如next-16-2),完成 backport PR 的完整流程。 - gh-stack — 使用
gh-stackCLI 插件管理”堆叠式 PR”(stacked diffs),适合需要多个相互依赖 PR 的增量代码评审工作流。 - pr-status-triage — 通过
scripts/pr-status.js分诊 CI 失败和 PR 评审意见,按优先级排查(构建 > lint > 类型 > 测试),并支持本地复现 CI 环境变量配置。
底层架构与调试类
- flags — 端到端添加或修改 Next.js 实验性 feature flag,涉及
config-shared.ts、config-schema.ts、define-env-plugin.ts等文件的完整链路。 - dce-edge — Edge Runtime 下的 DCE(死代码消除)安全写法,指导如何用
if/else分支保护node:stream等 Node 专属 import,以及define-env.ts中强制 flag 为 false 的时机。 - react-vendoring — React vendor 包的边界管理,涵盖
entry-base.ts的 react-server 层边界规范、vendored React 通道、Turbopack remap 和类型声明等。 - runtime-debug — 诊断 runtime bundle 和模块解析回归问题,包括通过
__NEXT_SHOW_IGNORE_LISTED获取完整堆栈、nft.json trace 检查、webpack stats diff 等调试手段。 - v8-jit — 为 Next.js server 内部热路径代码(如
app-render、routing)提供 V8 JIT 优化建议,涵盖 hidden class、内联缓存、megamorphic deopt 等性能模式(不对外暴露为斜杠命令)。 - next-rspack — 维护
@next/rspack-core和@next/rspack-binding包,涵盖升级@rspack/core、Rust toolchain 版本管理和本地联调方式。
文档写作类
- update-docs — 根据代码变更识别需要同步更新的文档文件,输出受影响的
.mdx文件列表,适合 PR review 时检查文档完整性。 - write-api-reference — 生成符合 Next.js 规范的 API 参考文档页(含 frontmatter、用法示例、参数说明),以独立 fork 子 Agent 模式运行。
- write-guide — 生成渐进式教学风格的技术指南,适合将 feature skill 或 API 文档转换为 step-by-step 教程,同样以 fork 子 Agent 模式运行。
- insight-error-page — 编写或审核开发 overlay 中的错误说明页(
errors/<slug>.mdx),包含 FixOption 卡片、“Copy AI prompt”按钮和术语规范校验。 - router-act — 指导如何用
createRouterAct和LinkAccordion编写端到端测试,精确控制 prefetch 等内部请求的时序,避免测试 flaky(不对外暴露为斜杠命令)。
Meta skills
authoring-skills 则是一个”元 skill”,专门讲解如何编写上面这些 skill 本身,不对外暴露。