这是一套面向开源贡献的流程型技能,目标是让维护者更容易接纳你的贡献。维护者多为资源有限的志愿者或小团队,因此每一步都应减少摩擦,例如清晰复现步骤、补充测试、规范提交信息、避免在评审后强推历史。
适用场景包括:在公开仓库提交缺陷报告或功能请求;准备拉取请求;项目缺少贡献指南时采用默认姿态;提交前自查 PR;以及为自己的项目建立开源惯例。
技能按阶段组织:阶段 0a 维护者惯例(README、LICENSE、CONTRIBUTING.md、issue/PR 模板、提交约定、DCO、发布流程);阶段 0 开始前(阅读贡献指南、检索已有 issue/PR、讨论大改动的礼节);阶段 1 提交问题(缺陷与功能模板、AI 代理披露、先提 issue 的工作流);阶段 2 拉取请求(分支约定、范围评估、研读现有实现、提交信息、PR 模板、文档与 CI);阶段 3 提交之后(监控 CI、回应评审、处理过期或关闭的 PR);阶段 3.5 范围反馈后的跟进;阶段 4 发布流程(版本号、打标签、GitHub Releases 与标签、发布工作流)。无贡献指南时参考默认姿态文档。
代理专用规则要求:代表人类提交 issue 时须在正文底部注明“Filed by {{AGENT_NAME}} (AI agent on behalf of {{HUMAN_NAME}})”以保持透明。快速参考步骤包括:cat CONTRIBUTING.md 或 .github/CONTRIBUTING.md;gh issue list --search "topic" --state all;先提 issue 再编码;git checkout -b fix/description;git commit -s -m "fix: description";本地运行 make test、npm test 或 pytest;git push -u origin HEAD;完整填写 PR 模板,复杂正文用 --body-file;gh pr checks --watch 监控 CI;评审后不再强推;合并后 git checkout main && git pull && git tag vX.Y.Z && git push origin main --tags;gh release create vX.Y.Z --title "vX.Y.Z — Title" --notes-file /tmp/notes.md。
不适用情形:你是项目唯一维护者且无外部协作者;对自己代码做单行修改;组织内部已有既定流程的贡献;已熟知指南的例行操作;安全问题应遵循项目的安全披露政策而非本技能。资料未提供收费、平台限制或效果承诺等信息。