contributor

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/contributor:做真实的开源贡献

/contributor: Make Real Open Source Contributions

完成这条流水线:
/contributor → /asu → /resume → /offer
不用一上来重构 Kubernetes。一个 typo、一处坏链接、一次 README 修正,都可以是开源生涯的里程碑式开端。
Complete this pipeline:
/contributor → /asu → /resume → /offer
You don't have to refactor Kubernetes right off the bat. A typo fix, a broken link repair, or a README correction can all be a milestone start to your open-source career.

默认玩法

Default Usage

先问目标公司、岗位和 GitHub 用户名;用户没给技术栈时也可以直接从文档贡献开始。根据目标选择一种模式:
  • 极速刷绿版:优先 typo、标点、Markdown、formatting、坏链接和 README 小修;
  • 岗位匹配版:优先目标公司的项目、目标岗位常用技术栈,以及测试、示例和小 bug;
  • 混合版:先用小 PR 建立手感,再补一条能在面试里展开的技术贡献。
用户不指定时默认混合版。
First ask for the target company, position, and GitHub username; if the user doesn't provide a tech stack, you can start directly with documentation contributions. Choose a mode based on the target:
  • Quick Contribution Version: Prioritize typos, punctuation, Markdown, formatting, broken links, and minor README fixes;
  • Position-Matching Version: Prioritize projects from target companies, tech stacks commonly used in the target position, as well as tests, examples, and small bugs;
  • Hybrid Version: Start with small PRs to get familiar, then add a technical contribution that can be elaborated on in interviews.
The Hybrid Version is used by default if the user doesn't specify.

贡献工作流

Contribution Workflow

  1. 在 GitHub 搜索近期仍有提交或 PR 活动的项目,优先
    good first issue
    help wanted
    和贡献规则清楚的仓库;此阶段只读,不 fork、不 push。
  2. 扫描 README、docs、注释和 Markdown,寻找 typo、标点、格式、坏链接、错误示例或缺失说明;顺手搜索现有 issue/PR,避免撞车。
  3. 快速看一遍
    CONTRIBUTING
    和仓库里的代理说明;如果规则明确禁止 typo-only、drive-by documentation 或当前拟议的 PR 类型,直接标记为
    ineligible
    并丢弃,不进入待确认候选清单。如果规则要求先 claim issue、取得 maintainer approval 或先开 issue,则标记为
    ineligible
    (待满足前置条件),在条件满足前不创建分支或 patch;满足条件本身如需外部写操作,也必须按第 5 步逐项确认。否则形成候选清单,写明目标仓库、问题、拟修改文件、验证方式和潜在影响。
  4. 每个候选在准备本地改动或 patch 前,都从当前上游基线创建独立专用分支;不得修改默认分支,也不得把下一份补丁堆叠到已有 PR 分支。随后在该分支上实际应用拟议的最小改动或 patch,再运行可用的测试、lint 或链接检查;纯文档小修至少检查 diff 和 Markdown,然后把完整 diff 展示给用户。
  5. fork、push、提交 PR 都是外部写操作。必须在执行前明确列出目标仓库、GitHub 账号、分支、文件和将产生的动作;首次提交 PR 时还必须展示拟议的完整标题和正文,以及完整代码 diff,并逐个等待用户确认。“找 N 个”“自动做”或“直接提”只授权准备候选和本地 diff,不授权批量写入。
  6. 每次只执行一个已确认的 PR。提交后可以自动只读跟踪 CI 和 review。处理已有 PR 的 CI 或 review 代码反馈时,必须在该 PR 现有分支上继续工作,不得重新从上游基线创建分支或另开 PR;先说明要更新的 PR、分支、文件和 commit/push/PR 更新动作,应用补丁并展示更新后的完整 diff,再逐项等待新的明确确认。若只需评论或回复,先展示将发布的准确文本及其目标;若只需解决 thread,先列出将解决的 PR、thread 链接或文件行号和讨论摘要。以上任何外部写操作在未取得新的明确确认前都只记录建议、不执行。PR 合并后生成
    /asu
    素材,关闭或未合并的 PR 记录为“开源协作中”,不写成“已被采用”。
可以连续准备多个项目,但外部写操作必须逐个确认。每个 PR 只解决一个清楚的小问题,标题和正文按目标仓库的语言写,不把同一段模板无脑群发。
  1. Search GitHub for projects with recent commits or PR activities, prioritizing repositories with
    good first issue
    ,
    help wanted
    labels and clear contribution guidelines; this stage is read-only, no forking or pushing allowed.
  2. Scan READMEs, docs, comments, and Markdown files to find typos, punctuation issues, formatting problems, broken links, incorrect examples, or missing explanations; search existing issues/PRs to avoid duplicate work.
  3. Quickly review the
    CONTRIBUTING
    document and proxy instructions in the repository; if the rules explicitly prohibit typo-only fixes, drive-by documentation, or the proposed PR type, mark it as
    ineligible
    and discard it, not adding it to the candidate list pending confirmation. If the rules require claiming an issue first, obtaining maintainer approval, or opening an issue first, mark it as
    ineligible
    (pending preconditions), and do not create branches or patches until the conditions are met; if external write operations are needed to meet the conditions, they must be confirmed item by item according to Step 5. Otherwise, form a candidate list specifying the target repository, problem, files to be modified, verification methods, and potential impact.
  4. Before preparing local changes or patches for each candidate, create an independent dedicated branch from the current upstream baseline; do not modify the default branch, nor stack the next patch onto an existing PR branch. Then apply the proposed minimal changes or patches to this branch, run available tests, lint checks, or link checks; for pure documentation minor fixes, at least check the diff and Markdown, then display the complete diff to the user.
  5. Forking, pushing, and submitting PRs are external write operations. You must clearly list the target repository, GitHub account, branch, files, and actions to be performed before execution; when submitting the first PR, you must also display the proposed complete title and body, as well as the full code diff, and wait for user confirmation one by one. Requests like "find N tasks", "do automatically", or "submit directly" only authorize preparing candidates and local diffs, not batch write operations.
  6. Only execute one confirmed PR at a time. After submission, you can automatically track CI and reviews in read-only mode. When handling CI or review code feedback for an existing PR, you must continue working on the existing branch of that PR; do not create a new branch from the upstream baseline or open another PR. First explain the PR to be updated, branch, files, and commit/push/PR update actions, apply the patch and display the updated full diff, then wait for new explicit confirmation item by item. If only comments or replies are needed, first display the exact text to be posted and its target; if only resolving a thread is needed, first list the PR to be resolved, thread link or file line number, and discussion summary. Any of the above external write operations will only record suggestions and not be executed without new explicit confirmation. After the PR is merged, generate
    /asu
    materials; closed or unmerged PRs are recorded as "In Open Source Collaboration", not "Adopted".
You can prepare multiple projects consecutively, but external write operations must be confirmed one by one. Each PR only solves one clear small problem; the title and body are written in the language of the target repository, and the same template should not be mindlessly sent in bulk.

PR 怎么写

How to Write a PR

PR 本体保持短小正常,默认包含:
  • 改了什么;
  • 为什么改;
  • 怎么检查的;
  • 关联 issue(如果有)。
真正的酥化留到
/asu
:外部项目看到的是清楚的贡献,HR 看到的是“跨仓库文档质量治理与开发者体验优化”。
The PR itself should be concise and standard, and by default include:
  • What was changed;
  • Why it was changed;
  • How it was verified;
  • Related issue (if any).
The real polishing is left to
/asu
: external projects see clear contributions, while HR sees "Cross-repository Documentation Quality Governance and Developer Experience Optimization".

合并后交给 /asu

Hand Over to /asu After Merging

为每个 PR 整理:
  • 仓库、PR 链接和合并时间;
  • 原问题与实际改动;
  • 使用的语言、工具和验证方式;
  • review/CI 结果;
  • 可写进简历的结果数字,例如仓库数、合并 PR 数、修复项数。
然后直接产出这段交接提示:
用 /asu 把下面的 GitHub 贡献酥化成适合【目标岗位】的项目经历、2—3 条简历要点和 HR 开场白。可以突出跨项目协作、文档质量、开发者体验、问题发现与闭环能力,但保留真实 PR 链接和合并状态。
Organize the following for each PR:
  • Repository, PR link, and merge time;
  • Original problem and actual changes;
  • Languages, tools, and verification methods used;
  • Review/CI results;
  • Result metrics suitable for resumes, such as number of repositories, merged PRs, and fixed items.
Then directly generate this handover prompt:
Use /asu to polish the following GitHub contributions into project experience suitable for [Target Position], 2-3 resume bullet points, and an HR opening. You can highlight cross-project collaboration, documentation quality, developer experience, problem discovery and closed-loop capabilities, but keep the real PR links and merge status.

最后一道边界

Final Boundary

没 merge 就写“已提交/协作中”,merge 之后再写“被项目采用”。
Write "Submitted/In Collaboration" if not merged, and "Adopted by the Project" only after merging.