用途:帮助用户从“想在 Superset 中修复或构建某项功能”出发,走完整个开源贡献流程,最终产出一个符合仓库规则、可合并的 PR。若当前检出的仓库中存在 CONTRIBUTING.md、DEVELOPMENT.md 或 AGENTS.md,则这些文件具有权威性,应优先阅读并遵循,其优先级高于本技能摘要。
范围界定:缺陷修复、文档和小改进可直接提交 PR,无需先开 issue;新功能或较大改动应先通过 https://github.com/superset-sh/superset/issues/new/choose 提交 issue,就实现方案达成一致后再动手;普通问题应到 Superset Discord 讨论,而不是开 issue。
环境搭建:先执行 gh auth status,然后复刻并克隆仓库:gh repo fork superset-sh/superset --clone(也可为已有克隆添加 fork 远程)。推荐把克隆作为项目加入 Superset 应用,并为每次改动创建独立工作区,使贡献在受管 worktree 中进行。在新工作区/worktree 中运行一次 ./.superset/setup.local.sh(配置每个工作区的端口、应用标识、本地服务及预置开发账号,无需外部凭据),随后运行 bun run dev。仅使用 Bun,不要使用 npm/yarn/pnpm。阅读根目录 AGENTS.md 并遵循它。
达到可合并状态:从 main 分支创建分支;一个 PR 只包含一项改动,无关发现另开第二个 PR。推送前依次运行 bun run lint:fix,确认 bun run lint 无报错退出(CI 对警告也会失败),再运行 bun run typecheck 和 bun run test。PR 标题必须采用约定式提交格式(如 feat(desktop): ...、fix(web): ...);PR 以 squash 方式合并,标题即提交主题。需附上可运行证明:任何用户可见改动提供截图或录屏,修复类给出前后对比。开发桌面应用暴露 CDP 以便清晰截图,详见 CONTRIBUTING.md 中的“Capturing screenshots via CDP”。勾选“Allow edits from maintainers”,非琐碎改动需关联对应 issue。
提交:使用 gh pr create 向 superset-sh/superset 的 main 分支提交 PR,如实填写 PR 模板(运行了什么、点击了什么、测试覆盖了什么),并将 PR URL 回报给用户。
适用场景:适用于希望参与 Superset 开源项目、需要标准化本地开发与提交流程的开发者。限制:资料未说明该技能的安装方式、收费情况或支持的平台范围,暂未提供。