SuperAPI AI 工具集

open-source-contribution

编程与开发

查看项目

更新于 10-16 07:00

技能介绍

用途

该技能定位为“开源贡献专家”,帮助开发者以符合最佳实践的方式参与开源项目:尊重维护者时间、遵循项目约定、产出高质量提交,从而降低审查负担、提高合并效率。

核心原则

  • 尊重维护者时间:清晰、完整的贡献能减少审查负担。
  • 遵循项目约定:适应每个项目的风格。
  • 清晰沟通:为未来的读者而写。
  • 从小处着手:先用小贡献建立信任。

主要能力

贡献前的准备

技能提供研究项目清单:阅读 CONTRIBUTING.md(如存在)、查阅 CODE_OF_CONDUCT.md、检查现有 issue 是否重复、理解项目目标与范围、查看近期 PR 了解约定、确认功能或修复是否被需要。

开发环境搭建步骤(以示例仓库 owner/project 为例):

# Fork the repository
gh repo fork owner/project --clone

# Set up upstream remote
git remote add upstream https://github.com/owner/project.git

# Install dependencies and verify tests pass
cargo build
cargo test

Issue 撰写模板

提供 Bug 报告模板与功能请求模板。

Bug 报告模板包含:Description(清晰简洁的 bug 描述)、Steps to Reproduce(复现步骤)、Expected Behavior(预期行为)、Actual Behavior(实际行为)、Environment(操作系统、Rust 版本、项目版本或提交哈希)、Additional Context(截图、日志、相关 issue)、Possible Solution(可选,修复思路)。

功能请求模板包含:Problem Statement(解决什么问题、谁受益)、Proposed Solution(功能如何工作)、Alternatives Considered(考虑过的其他方案)、Additional Context(原型图、其他项目示例等)、Willingness to Contribute(是否愿意实现该功能)。

拉取请求最佳实践

分支命名示例:

feature/add-caching-layer
fix/handle-empty-input
docs/update-readme
refactor/simplify-parser

提交信息格式为 type: subject,示例:

feat: add support for custom delimiters

Add the ability to specify custom delimiters when parsing CSV files.
This is useful for tab-separated values and other formats.

Closes #123

类型包括:feat(新功能)、fix(缺陷修复)、docs(仅文档)、style(格式、缺失分号等)、refactor(既不修 bug 也不加功能的代码改动)、test(补充缺失测试)、chore(维护任务)。

PR 描述模板包含:Summary(改动简述)、Motivation(为何需要此改动)、Changes(改动列表)、Testing(如何测试)、Checklist(本地测试通过、代码符合项目风格、文档已更新、CHANGELOG 已更新如需要、提交信息符合约定)、Related Issues(关联并关闭的 issue 编号)。

PR 规模分级建议:XS(<10 行,分钟级审查)、S(10-100 行,<1 小时)、M(100-500 行,小时级)、L(500-1000 行,天级)、XL(>1000 行,建议拆分)。最佳实践是尽可能将 PR 保持在 300 行以内。

代码质量检查清单:提交前需运行 cargo fmt、cargo clippy 无警告、cargo test 通过、新代码有测试、文档已更新、未包含无关改动、提交历史干净。

回应代码审查

应做:感谢审查者时间、处理所有评论(解决或讨论)、需要时请求澄清、及时做出要求的修改、讨论聚焦于代码。

不应做:把反馈当作针对个人、无证据地争辩、忽略评论、审查期间 force-push(造成困惑)、添加无关改动。

回应示例:

# Acknowledging feedback
> Consider using `match` instead of `if let` here

Good point! Updated in abc1234.

# Asking for clarification
> This could be simplified

Could you elaborate? I'm not sure if you mean [option A] or [option B].

# Respectfully disagreeing
> Remove this error check

I'd prefer to keep this because [reason]. The error can occur when [scenario]. Happy to discuss further if you disagree.

维护 Fork

# Sync with upstream
git fetch upstream
git checkout main
git merge upstream/main
git push origin main

# Rebase feature branch
git checkout feature/my-feature
git rebase main

初次贡献建议

从文档入手(修正拼写、改进示例);添加测试(提升现有代码覆盖率);修复标记为 “good first issue” 的问题;审查其他 PR 以学习项目标准;在开始大工作前先在 issue 中提问。

适用场景

  • 首次参与开源项目、不知从何下手的开发者。
  • 希望提交高质量 PR、提高合并率的贡献者。
  • 需要撰写规范 Bug 报告或功能请求的用户。
  • 希望改善与维护者协作沟通方式的团队或个人。

限制与约束

技能明确列出约束:不要在未运行测试的情况下提交 PR;不要忽略项目约定;不要提交未完成的工作而不标记为草稿;不要期望立即得到审查;尊重维护者的决定。

成功指标包括:PR 无需大幅修改即被合并、获得维护者正面反馈、后续贡献受到欢迎、全程沟通清晰。

暂未提供

该资料未说明收费方式、价格、支持的平台范围、具体的安装步骤(除上述仓库环境搭建示例外)以及除 Rust/Cargo 示例外的其他语言适配信息。