Atomeocean仪式性贡献流程指南

发表于 2026-01-06

最后修改 2026-07-28

阅读量 —

本文档用于指导Atomeocean轻量工作成员以规范、可追溯、可审核的方式，向 Job Compass 开源项目提交一次完整的“仪式性贡献”（Ceremonial Contribution）。

本页只讲“怎么做”

本页覆盖从 Git 配置到 PR 合并的完整操作流程，以及一次贡献是否被计为有效的验收与判定规则。

至于面经文章里具体写什么（JSON 字段规范、Markdown 模板、引用来源），请看 面经内容规范。

开始之前（仪式性贡献前须知）

贡献目的

轻量工作员工在 Atomeocean进行仪式性贡献，是为了保障员工自身在美国的签证与身份合规，以便向移民局证明在Atomeocean有真实可查的工作记录。

此类贡献内容对公司本身 不产生任何实际价值。

基本要求

1. 仪式性贡献旨在为你自己建立在美国的合规工作记录，通常需要数小时准备相应内容。
2. Atomeocean设有Discord社区和Office Hour机制，如遇困难请及时沟通寻求帮助。
3. 提交后请按照下方验收与判定核对，若流程卡顿，可参考第2条联系协助。
4. 基于第1点，Atomeocean 不强求必须完成此项工作。如无美国工作记录需求，可选择放弃。
5. 请勿使用任何LLM模型生成灌水内容，尊重审核人员的人工劳动。

获得提交权限

• 已加入 Atomeocean GitHub Organization
• 已获得 Job Compass 仓库的访问权限
• 了解本次贡献的目标内容是美国面试的真实经验

需要协助时

如果遇到以下情况

• 不确定内容是否合适
• 不清楚放在哪个目录
• Git / Pull Request流程不熟悉

可在 Discord 社区中咨询，特别是mentor，Atomeocean提供每周数次的 轻量工作Office Hour可以语音求助。

本地准备

1. 配置 Git 环境

确保本地已正确安装并配置 Git

git --version
git config --global user.name "Your Name"
git config --global user.email "your@email.com"

2. Clone Job Compass 仓库

git clone https://github.com/atomeocean/job-compass.git
cd job-compass

3. 确认仓库状态

确保当前分支为 main，且本地代码是最新的

git checkout main
git pull

创建分支

🚫 禁止直接在 main 分支上开发

请基于 main 创建一个新的分支，命名规则如下：

yourname/ceremonial-yyyymmdd

示例：

git checkout -b alice/ceremonial-20260106

该命名方式用于：

• 明确贡献人
• 标识为仪式性贡献
• 便于后续审计与统计

编辑内容

一次仪式性贡献需要在 Job Compass 仓库中新增两个文件：一个存放面试基本信息的 JSON，一个存放面试过程的 Markdown。

1. 生成六位随机ID

先生成一个六位随机ID（如 869pu4），由数字和小写字母组成，两个文件共用同一个ID。目前atomeocean还没有提供生成工具，可以随便想一个。

2. 创建两个文件

按下面的路径格式创建，需要替换 {company} 和 {六位随机ID} 两个值：

docs/assets/json/interview-experience/{company}/{六位随机ID}.json
docs/zhHans/interview-experience/{company}/{六位随机ID}.md

例如添加一个 Apple 公司的面试经验，company 取 apple，六位随机ID 取 869pu4，则创建

docs/assets/json/interview-experience/apple/869pu4.json
docs/zhHans/interview-experience/apple/869pu4.md

两个文件里写什么

JSON 字段规范、Markdown 模板与引用来源要求，请查阅 面经内容规范。

内容不合规的 PR 会在审核阶段被关闭，见不计入贡献的情形。

完成编辑后，请先在本地快速检查文件内容是否正确。

提交代码（Commit）

确认修改无误后，将变更加入暂存区并提交

git add .
git commit -m "docs: add interview experience (ceremonial)"

Commit Message 建议规范

• 信息简洁明确
• 一个PR可以包含1个或多个commit

提交 Pull Request 到 Job Compass 仓库

将分支推送到远程仓库：

git push origin yourname/ceremonial-yyyymmdd

随后在GitHub上创建Pull Request，请确保

• PR 标题 简要描述本次贡献内容
• PR 描述 包含：
  • 本次贡献的内容说明
  • 是否为首次贡献
  • 如有对应 Issue，请在描述中关联（如 Fixes #123）
• 重要: PR Assignees 已指派给自己

请确认PR Assignee是你自己的GitHub账号，否则无法关联到个人工作记录中

根据Review意见修改并通过 CI

• Mentors 或 Maintainers 会对 PR 进行 Review
• 请根据 Review 意见在同一分支上继续修改并 push
• CI 检查通过是合并前的必要条件

如对 Review 意见不理解，可在PR评论区或 Discord 中进行沟通。

别让 PR 静默

维护者提出修改意见后，连续 7 天无任何更新或回复的 PR 会被关闭，见 PR 自动关闭政策。

合并 Pull Request

当满足以下条件后：

• Review已通过
• CI状态为 ✅
• 内容符合项目规范

由贡献者本人负责将PR合并至 main 分支

验证发布成功

PR合并后，请确认

1. Job Compass 仓库中已包含你的内容
2. Job Compass 网站或文档页面已成功更新（可能存在缓存或延迟）

如长时间未生效，可在 Discord 中反馈。

验收与判定

完成以上流程，即视为一次完整且合规的仪式性贡献。 贡献记录包含Job Compass网站页面更新和GitHub PR记录，完全满足美国工作身份合规要求。

验收清单

请逐项确认以下条件均已满足：

1. Pull Request 已合并 —— 确认 PR 已被合并至代码库的主分支。
2. 合规工作记录已登记 —— 确认在 Atomeocean 员工页面的“合规工作记录”中，已添加对应的仪式性贡献记录。
3. GitHub 活动网格已更新 —— 确认 GitHub Profile 的活动网格图已显示本次贡献记录。
4. Job Compass 部署完成 —— 确认 Job Compass 网站已成功部署，并可访问对应 URL。

不计入贡献的情形

以下情况不计入仪式性贡献：

• PR 仅提交但未合并 —— 若 Pull Request 仅发起但未最终合并至主分支，不计入贡献。这是最常见的误区。
• 一个 PR 中包含多篇面试经验 —— 我们会在沟通后关闭该 PR，请拆分为每篇一个 PR。
• 内容为 AI 直接生成 —— 检测到 PR 内容由 AI 直接生成的，我们将在留言说明后关闭该 PR。
• PR 因长期无响应被关闭 —— 见下方政策。

内容层面的具体要求见面经内容规范。

PR 自动关闭政策

为什么我的PR会被关闭

A：当PR在连续无活动时： 等待修改阶段：维护者提出修改意见后，7天内无任何更新或回复

如果我有事无法及时响应怎么办

A：我们完全理解！请选择以下任一方式

• 在 PR 中留言说明预计可响应的时间
• 为 PR 添加work in progress标签
• 简单回复“收到，将在[日期]前处理”即可重置计时器

自动关闭会影响我的贡献记录吗

A：关闭的PR会保留在项目历史中，展示您的贡献努力。为鼓励活跃协作，仅成功合并的PR会计入月度贡献统计。

如何避免PR被误关闭

A：保持定期沟通是关键

• 即使只是“正在处理中”的简短回复
• 分批提交修改，每次提交都会重置计时
• 遇到困难时主动求助，维护者很乐意提供指导

节假日或周末会计时吗

不会