github-contribution-workflow

一个 Agent Skill（技能）：项目无关的「给别人的 GitHub 仓库提贡献」工作流 —— 从 fork 到 PR 被合并。

适用于 DeepSeek Harness（DSH）、Claude Code 等支持 Agent Skills 规范的 Agent。

它解决什么问题

新手（以及不少老手）提首个 PR 时踩的坑几乎一样：fork 落后于上游、分支基点选错、commit message 不合项目口味、没有 changelog、PR 描述写不到点上、CI 挂了不知道怎么救、review 意见不知道要不要全改。这个技能把这些变成一套固定动作。

覆盖范围

环节	内容
Fork 与同步	fork 之后怎么保持与上游同步，避免「PR 里混进别人的提交」
分支基点	从哪个分支切、PR 该以哪个分支为 base（main / dev / release）
提交质量	写项目实际接受的 commit message 与 changelog 条目
Issue	怎么提 bug report / feature request 才会被回答而不是被关
PR	写一份能被合并的 PR 描述
返工	面对 CI 失败与 review 意见，在不破坏历史的前提下修

细节文档：

references/
├── fork-and-branch.md    # fork、同步、分支基点、rebase
└── issue-and-pr.md       # issue 与 PR 的写法

安装

# DSH 用户级技能目录
git clone https://github.com/audiencegeg-glitch/github-contribution-workflow.git "$env:USERPROFILE\.dsh\skills\github-contribution-workflow"

# 跨 Agent 共享目录
git clone https://github.com/audiencegeg-glitch/github-contribution-workflow.git "$env:USERPROFILE\.agents\skills\github-contribution-workflow"

装好后重启 Agent 进程使其加载。

使用

对 Agent 说需求即可，例如：

• 「帮我把这个修复提到上游仓库去」
• 「这个 issue 该怎么写才能被回答」
• 「PR 的 base 该选 main 还是 dev」
• 「CI 挂了，帮我看看是什么问题、怎么改」

相关技能

• 若贡献内容恰好是 AUTO-MAS 的脚本适配器，还应加载 auto-mas-adapter-workflow。

前置依赖

• git
• 一个 GitHub 账号（HTTPS 凭据或 SSH key）

许可

MIT