用途:该技能用于指导如何为开源项目做出高质量贡献,核心理念是让维护者更容易吸收你的改动,减少沟通与返工成本。适用于在公共仓库提交缺陷报告或功能请求、准备拉取请求、项目缺少贡献指南时的默认姿态、提交前自查 PR,以及为自己的项目建立开源规范。
主要能力:按阶段组织流程。阶段 0a 维护者惯例,涉及 README、LICENSE、CONTRIBUTING.md、issue/PR 模板、提交约定、DCO 与发布流程;阶段 0 开始前,阅读贡献指南、检查已有 issue/PR、讨论大改动;阶段 1 提交 issue,包含缺陷/功能模板、代理披露与维护者工作流;阶段 2 拉取请求,包含分支约定、范围评估、提交信息、PR 模板、文档审计与 CI 配置;阶段 3 提交后,含 CI 监控、评审反馈与 PR 变陈旧或被关闭的处理;阶段 3.5 范围反馈后的跟进;阶段 4 发布流程,含版本号、打标签、GitHub Releases 与发布失败处理。另提供无 CONTRIBUTING.md 时的默认姿态、AI 代理专用检查清单和常见陷阱参考。
必要用法:先读 cat CONTRIBUTING.md 或 .github/CONTRIBUTING.md;用 gh issue list --search "topic" --state all 检查已有 issue;先提 issue 等待反馈再建分支 git checkout -b fix/description;提交使用 git commit -s -m "fix: description";本地运行测试如 make test、npm test 或 pytest;推送 git push -u origin HEAD;监控 CI 用 gh pr checks --watch;评审后避免 force-push。代理代表人类提交时,应在 issue 末尾注明:Filed by {{AGENT_NAME}} (AI agent on behalf of {{HUMAN_NAME}})。
限制:不适用于自己是项目唯一维护者、单人单行琐碎修改、组织内部已有既定流程,或已完全熟悉项目规范的情况。安全漏洞应遵循项目的安全披露政策。具体模板内容、各参考文档细节及更多操作步骤,资料中暂未完整提供。