Onboarding Guide

---
name: onboarding-guide
description: "入职指南——为新同事写一份第 1 天、第 1 周、第 1 月的入职清单，含账号权限、工具、联系人、里程碑与反馈节点。当用户说「帮我写入职指南」「新人来了怎么安排」「新人第一周做什么」「导师怎么带新人」时使用。"
author: Captain
version: 0.1.1
display_name: "入职指南"
display_name_en: "Onboarding Guide"
description_zh: "给新同事写入职指南：按第 1 天、第 1 周、第 1 月列清单，覆盖账号权限、工具、联系人、里程碑与反馈节点，设计导师（buddy）机制，补上「怎么问问题」这类最常被漏掉的说明；附一份可填空模板。适合团队负责人、导师和 HR 使用。"
description_en: "Write an onboarding guide for a new teammate with Day 1, Week 1 and Month 1 checklists covering accounts and permissions, tools, contacts, milestones and feedback check-ins, plus a buddy system and a fill-in-the-blanks template."
tags:
  - "入职指南"
  - "新人入职"
  - "入职清单"
  - "新员工培训"
  - "导师制"
  - "buddy"
  - "onboarding"
  - "新人手册"
examples_zh:
  - "下周一有个新人到岗，帮我写入职指南"
  - "新人来了怎么安排，第一周总是让他自己看文档"
  - "第一次当导师，导师怎么带新人比较好"
examples_en:
  - "A new hire starts next Monday. Help me write an onboarding guide"
  - "How should we plan a new hire's first week? Right now they just read docs on their own"
  - "I'm a buddy for the first time. How should I help a new hire?"
---

# 入职指南

定位一句话：**入职指南不是把所有资料塞给新人，而是保证三件事：第 1 天能干活，第 1 周交出第一个小产出，第 1 月能独立负责一块；卡住的时候知道找谁、怎么问。**

## 何时使用

用户这样说时启用（前五条是主要场景，后两条是边缘场景）：

- 「下周一有个新人到岗，帮我写入职指南」
- 「新人来了怎么安排，第一周总是让他自己看文档」
- 「第一次当导师，导师怎么带新人比较好」
- 「下个月来两个实习生，第一天要准备什么」（社招、校招、实习、转岗都适用）
- 「新人来了两三周一直不说话，也不知道他卡在哪」——新人在第二三周沉默、偷偷焦虑，往往是缺反馈节点和「怎么问问题」
- 「我们有份旧的入职文档，只是一堆链接，帮我更新一下」——按「更新」处理，不推倒重写
- 「新人在外地远程入职，怎么安排」

调用方式：在对话里说岗位、到岗日、主管和导师；有旧文档就直接粘贴或发文件。节点日期和发前检查可以在本机运行 `python3 scripts/onboarding_tool.py`（`dates` 推算日期，`check` 查漏填和误写的凭据）。

不适用（遇到时这样处理）：

- 劳动合同、社保公积金、试用期解除等问题 → 找 HR 或劳动法律师，本技能不解答。
- 带教过程本身：每周一对一聊什么、反馈怎么说、上手慢怎么办 → 转「新人带教」类技能（如 new-hire-mentoring）。
- 还没招到人，要写招聘启事 → 转「招聘 JD」类技能（如 job-description-writer）。

## 先判断什么

1. **新人是哪一类。** 应届生和实习生需要职场基本功（周报怎么写、会议怎么参加、请假找谁）；有经验的社招跳过常识，重点讲「这里和别处不一样的地方」；内部转岗账号大多现成，重点补业务背景和人。
2. **第 30 天的「独立负责」指什么。** 先写这一句，再倒推清单。写不出来，说明岗位期望本身没想清楚，要先和主管对齐。
3. **每一项谁负责。** 主管管目标与评价，导师管日常答疑，HR 与行政管手续和设备，管理员管账号权限。清单上没有负责人的事项，大概率没人做。
4. **有没有现成材料。** 旧的入职文档、团队介绍、常见问题文档先收集起来：链接可用、内容没过期的直接引用，不要重写一份；过期的标出来，交给负责人更新。

## 编写流程：五步

```
第 1 步 倒推目标    写出第 30 天的一到两个可验收产出，再拆出第 1 周的第一个小任务：
                   半天到两天能完成、真实会被用到（修一个小缺陷、改一份真实文档），不是「熟悉代码」
第 2 步 列权限      按「第 1 天就要 / 第 1 周内 / 用到再开」三档；每项写找谁开、审批大约几天；
                   审批要几天的，到岗前一周就发起
第 3 步 列联系人    不是通讯录，是「什么事找谁」：业务、工具与权限、手续（请假报销）、心情与发展
第 4 步 定反馈节点  第 1 天下班前、第 1 周周五、第 2 周、第 30 天；试用期较长的再加第 60、90 天；
                   每个节点提前放进双方日历，不等「有空再聊」
第 5 步 写怎么问    提问的时间盒、格式、渠道、回复预期，见下方模板第七节
```

到岗前一周，主管和导师要做完五件事：

- 确定导师，并把带教时间写进导师本月的工作安排；
- 发起所有「第 1 天就要」的账号与设备申请，确认到岗当天能用；
- 准备好第一个小任务，写清背景、完成标准和可以求助的人；
- 把第 1 天、第 1 周周五、第 30 天的面谈提前放进双方日历；
- 到岗前一两天给新人发一条欢迎消息：几点到、到哪里、找谁、要带什么、第一天大致怎么过。

节点日期用脚本推算，避免手算出错（到岗当天算第 1 天，遇周末或传入的假日顺延；节假日不内置，按公司或官方公布的日历传入，调休上班的周末用 `--workdays`）：

```bash
python3 scripts/onboarding_tool.py dates 2026-11-02 --checkpoints 30,60,90
```

输出是一张可以直接贴进指南的表：节点、日期、星期、负责人、做什么。

里程碑要具体到能验收，下面是四类岗位的示例，按实际情况改：

```
研发   第 1 周：修复一个标记为「新人友好」的小缺陷，走完从评审到上线的全流程
       第 30 天：独立完成一个小需求，从方案评审到上线验收
运营   第 1 周：复盘上一期活动数据，写一页结论与改进建议
       第 30 天：独立策划并上线一个小型活动，结束后交复盘
销售   第 1 周：旁听五次客户沟通，每次写一段纪要，由导师点评
       第 30 天：独立跟进【N】个客户，其中至少一个推进到报价阶段
客服   第 1 周：在导师旁听下处理真实工单，每天复盘一次
       第 30 天：独立上岗，质检得分达到团队及格线
```

每个反馈节点固定问三句，答案记下来，下一个节点对照：

- 这段时间哪件事做得顺，哪件事卡住了，卡了多久？
- 有没有哪件事你不确定该不该问、该问谁？
- 下一段你想先搞懂什么？我们对你的期望，和你理解的一致吗？

## 导师（buddy）机制

- **导师不是主管。** 主管管目标与评价，导师管「这事该找谁、这个词什么意思、这个坑我踩过」。导师最好不是直属主管，而是同组、入职一年以上、和新人时区与工位接近的人。
- **导师的动作清单**：第 1 天陪吃午饭；第 1 周每天 15 分钟碰头；第 2 到 4 周每周两次；新人的第一批产出由导师先看；主动介绍三到五位关键同事；发现新人卡住超过半天，主动去问。
- **给导师留时间。** 带人当月适当减少导师的其他工作量，并把带教写进导师自己的目标，否则一忙起来导师就消失了。
- **导师最常犯的三个错**：第一天讲太多、替新人把任务做完、只问「有问题吗」——为什么错、怎么改，见「常见错误（反模式）」表的最后三行。
- **导师不做的事**：不替主管下评价结论，不越过主管承诺转正、调薪；新人反映的问题涉及主管本人时，建议新人直接找 HR。
- **结束方式**：第 30 天或试用期结束时正式收尾，导师给主管一页观察记录，只写事实，不打分。

## 可填空模板：直接复制，替换【】

```
【新人姓名】的入职指南   到岗日【日期】   主管【姓名】   导师【姓名】

一、你来这里要做成什么
  第 30 天：【一到两个可验收的产出】        第 90 天：【能独立负责的范围】
二、第 1 天：能登录、能找到人、知道这周做什么
  □ 领取设备，登录邮箱、即时通讯、文档工具、【业务系统或代码库】
  □ 导师陪吃午饭，带你认识【三位最常打交道的同事】
  □ 主管 30 分钟：团队在做什么、你的 30 天目标、这周的第一个小任务
  □ 下班前导师 15 分钟：确认账号能用，记下还没开通的权限
三、第 1 周：交出第一个小产出
  □ 读【三份必读文档】，每份写明为什么要读
  □ 完成第一个小任务【任务名，半天到两天】
  □ 旁听【例会名称】，会后导师 10 分钟答疑
  □ 建一份自己的名词表，不懂的词先记下，每天集中问导师一次
  □ 约【三位同事】各聊 15 分钟：他们在做什么、需要你怎么配合
  □ 周五 30 分钟复盘：顺的、卡的、下周计划
四、第 1 月：能独立负责一块
  □ 第 2 周 独立完成【稍大一点的任务】；周五导师 30 分钟面谈
  □ 第 3 周 在【周会或分享会】上讲一次你看到的问题或建议
  □ 第 30 天 主管正式面谈，对照第一节的目标
五、账号与权限（到岗前由【负责人】发起）
  名称 ｜ 哪天需要 ｜ 找谁开 ｜ 审批约几天 ｜ 状态
六、什么事找谁
  业务问题【姓名】 工具与权限【姓名】 请假报销等手续【姓名】 卡住、不开心、想聊发展【导师】
七、怎么问问题（请认真读）
  1. 先自己查 30 分钟：搜文档和群聊记录；30 分钟没进展就问，不要憋一天
  2. 写清四件事：想做什么、试过什么、卡在哪（附截图或链接）、你猜的原因
  3. 通用问题发【团队群】，答案对别人也有用；个人事务私聊；紧急的直接打电话或当面问
  4. 非紧急问题半天内会有人回；没回就再提醒一次，这不算打扰
  5. 问到的答案，顺手补进【常见问题文档】
```

发给新人前，用脚本检查还有几处没填、文中有哪些链接要点一遍、有没有误写初始密码或密钥：

```bash
python3 scripts/onboarding_tool.py check 入职指南.md
```

## 信息不全或出错时

| 情况 | 怎么处理 | 对用户说的话（模板） |
|---|---|---|
| 缺关键信息：只说「来了个新人，写个入职指南」 | 只问 3 个：岗位和类型；到岗日、主管、导师；第 30 天希望他独立负责什么。其余保留【】；第 30 天目标先按同类岗位示例写，标 [待确认] | 「先问三件事：什么岗位、社招还是校招？哪天到岗、主管和导师是谁？第 30 天希望他能独立负责什么？其余我先留【】，文末列清单。」 |
| 说法矛盾：说「下周一到岗」，给的日期却是周三；实习生却要求第 30 天独立负责核心模块 | 指出矛盾，给两种理解，请用户选 | 「你说下周一到岗，但 11 月 4 日是周三：按哪天排？实习生 30 天独立负责核心模块偏重，是改成『独立完成一个小需求』，还是岗位确实这么要求？」 |
| 已有旧版指南（常见：只是一堆链接） | 按「更新」处理：能用、没过期的直接引用；过期的标 [待确认：请负责人核对]；缺的节补上；交付时附改动清单 | 「旧文档的链接我不重写，先请你确认哪些还能用；过期的标出来交给负责人，缺的『第 30 天目标』『怎么问问题』我补上。」 |
| 超出范围：试用期长短、转正标准、合同社保、薪酬福利 | 不替公司定制度，只写公司已有规定；法律问题转 HR 或劳动法律师 | 「试用期多长、转正怎么评，以公司制度和 HR 口径为准；你把现有规定发我，我原样写进指南。」 |
| 时间紧，只要最小可用版 | 最小版 = 第 30 天目标一句 + 第 1 天四件事 + 第一个小任务 + 「什么事找谁」四行 + 怎么问问题五条；权限表和第 1 月清单随后补 | 「先给最小版：30 天目标、第 1 天四件事、第一个小任务、找谁、怎么问问题；权限表和第 1 月清单明天补。」 |
| 坚持越界：要把初始密码写进指南；要导师写转正结论；要在指南里承诺转正或调薪 | 守住：凭据走公司规定的安全渠道；导师只写事实观察，评价和承诺归主管与公司制度 | 「初始密码不能写进指南，这份文档会被转发和留存；我写成『账号密码由 IT 按公司安全渠道发放』。」 |
| 远程或异地新人 | 第 1 周每天视频碰头，写明时差和各自在线时段，设备和账号提前寄送、提前开通 | 「远程的话，第一周我加上每天 15 分钟视频碰头，并写明你们的时差和在线时段。」 |

`scripts/onboarding_tool.py` 报错对照：

| 退出码 / 提示 | 原因 | 修正办法 |
|---|---|---|
| 0 | `dates` 算完；`check` 没有剩余待填项和疑似凭据 | 把日期表贴进指南；可以发给新人 |
| 1「参数错误：…」 | 日期写成 2026-13-01 这类不存在的日子；`--checkpoints` 写错；没写子命令 | 日期写 2026-11-02；`--checkpoints 30,60,90`；子命令用 `dates` 或 `check` |
| 2「找不到文件」「不是 UTF-8 文本」「读不了日期文件」 | 路径不对；Word 等格式不是纯文本 | 路径加引号；另存为 UTF-8 的 .md 或 .txt |
| 3（`check`） | 还有【】/[待补]/[待确认]，或疑似写了密码、密钥 | 按行号补齐，补不了的移进「待你补充」清单；删掉凭据 |
| 130「已中断」 | 按了 Ctrl+C | 工具不写文件，直接重跑 |
| 「注意：到岗日…是周日或假日」 | 到岗日落在休息日 | 核对日期；确实是调休上班日就加 `--workdays` |

## 输出契约

交付一份按模板填好的 Markdown 文档，各部分按以下顺序，不跳节：

1. **抬头**：新人姓名、到岗日、主管、导师。
2. **一、你来这里要做成什么**：第 30 天、第 90 天的可验收产出。
3. **二至四、第 1 天／第 1 周／第 1 月清单**：每个清单项有负责人和完成标志（凭什么打勾）。
4. **五至七、账号与权限表、什么事找谁、怎么问问题**：联系人写「什么事找他」，不只写名字。
5. **反馈节点日程**：日期按到岗日推算，遇周末或节假日顺延（可用 `dates` 子命令生成）。
6. **导师行动表**（需要时）：按天列出导师要做的事。
7. **待你补充清单**：文中所有【】和 [待确认] 汇总在最后。

占位符：用户没提供的信息保留【】（等同 [待补]）；按常见做法推定的写 [待确认：推定内容]。不编人名、系统名、权限名。语气写给新人本人看：用「你」，具体、友好，不写口号。

交付前自检（逐条答是/否）：

- [ ] 第 30 天目标是可验收的产出，而不是「熟悉业务」？
- [ ] 每个清单项都有负责人和完成标志？
- [ ] 所有日期由到岗日推算，周末、节假日已顺延？
- [ ] 「怎么问问题」一节完整，并提醒导师当面讲一遍？
- [ ] 跑过 `check`：剩余【】都进了「待你补充」清单，没有疑似密码、密钥？
- [ ] 通篇用「你」写给新人，没有口号？

## 示例

以下为示例，人名、日期为虚构。

**用户**：下周一有个新人到岗，帮我写入职指南。

**助手先问**：① 什么岗位，社招还是校招？② 到岗日、主管、导师分别是？③ 第 30 天希望他能独立负责什么？

**用户**：社招后端开发小林，11 月 2 日到岗，主管老陈，导师小周；30 天能独立完成一个小需求。

**助手交付**（节选；完整版见下方链接）：

```text
小林的入职指南   到岗日 2026-11-02   主管 老陈   导师 小周
一、你来这里要做成什么
  第 30 天：独立完成一个小需求，从方案评审到上线验收     第 90 天：【能独立负责的范围】
二、第 1 天：能登录、能找到人、知道这周做什么
  □ 领取设备，登录邮箱、即时通讯、文档工具、【代码库】        负责：IT / 完成标志：都能登录
  □ 小周陪吃午饭，带你认识【三位最常打交道的同事】              负责：小周 / 完成标志：知道名字和分工
  □ 老陈 30 分钟：团队在做什么、你的 30 天目标、这周的第一个小任务  负责：老陈
  □ 下班前小周 15 分钟：确认账号能用，记下还没开通的权限          负责：小周
……（三至七节按模板填写）
反馈节点（python3 scripts/onboarding_tool.py dates 2026-11-02 生成）
  第 1 周复盘 2026-11-06 周五 ｜ 第 2 周面谈 2026-11-13 周五 ｜ 第 30 天 2026-12-01 周二
待你补充：第 90 天范围、代码库名称、三位同事、三份必读文档、第一个小任务……
```

更多完整示例：[后端新人的完整入职指南（含日期表与发前检查输出）](examples/filled-guide-backend.md)、[已有旧版指南怎么更新](examples/update-old-guide.md)。

## 常见问题（FAQ）

**Q：已经有一份旧的入职文档，还要重写吗？**
A：不重写。能用、没过期的直接引用；过期的标出来交给负责人更新；缺的节（第 30 天目标、怎么问问题、反馈节点）补上，并附改动清单。

**Q：第一周只让新人看文档不行吗？**
A：不行。第一周要有一个半天到两天能完成、真实会被用到的小任务，新人有成就感，主管也能看出适不适合。

**Q：导师和主管有什么区别？**
A：主管管目标与评价，导师管日常答疑和「这事该找谁」。导师最好不是直属主管，也不替主管下评价结论。

**Q：实习生和社招的指南一样吗？**
A：不一样。应届生和实习生要补职场基本功（周报、会议、请假）；社招跳过常识，重点讲这里和别处不一样的地方；内部转岗补业务背景和人。

**Q：远程入职的新人怎么安排？**
A：第一周安排每天视频碰头，写明时差和在线时段；设备提前寄送，账号提前开通。

**Q：能直接帮我开账号、发给新人吗？**
A：不能。本技能只出文档和清单，不开通账号、不接入系统，也不代发消息；用 `check` 检查后由你来发。

**Q：试用期多长、转正标准怎么写？**
A：以公司制度和 HR 口径为准，本技能只把已有规定写清楚，不替公司定制度。

**Q：没有 Python 能用吗？**
A：能。日期按「到岗当天算第 1 天、遇周末顺延」手算；检查就是在文档里搜「【」「待补」「待确认」。

## 常见错误（反模式）

| 错误做法 | 为什么错 | 正确做法 |
|---|---|---|
| 没人说明「怎么问问题」 | 新人不知道该在群里问还是私聊，怕打扰别人，一个小问题憋一整天 | 模板第七节写清，而且要当面讲一遍，不能只发文档；团队一侧的约定见表后说明 |
| 权限到岗当天才申请 | 第一周都在等审批 | 到岗前一周发起「第 1 天就要」的申请，审批要几天的更早 |
| 第一周只有「看文档」 | 没有真实任务，新人没有成就感，主管也看不出他适不适合 | 安排一个半天到两天、真实会被用到的小任务 |
| 反馈只有试用期结束那一次 | 问题攒到最后才暴露，已经来不及调整 | 第 1 天、第 1 周、第 2 周、第 30 天固定面谈，提前放进双方日历 |
| 隐性规则没写：会议开不开摄像头、消息多久回算正常、弹性上下班的真实做法、周报格式、文档放在哪 | 新人只能靠猜，猜错了还不好意思问 | 写进指南；一时说不清的列进「待你补充」 |
| 链接失效 | 新人第一天就四处碰壁 | 到岗前导师把指南里的链接从头点一遍（`check` 会列出全部链接） |
| 联系人只写名字 | 新人不知道什么事该找谁 | 写成「什么事找谁」 |
| 远程或异地新人没有特殊安排 | 第一周没见过人，时差让消息总是错过 | 安排第一周的视频见面，写明时差 |
| 只有欢迎，没有期望 | 新人不知道试用期要达成什么、怎么评价，只能靠猜 | 第一节写清第 30 天、第 90 天的产出 |
| 导师第一天讲太多 | 新人一句也记不住 | 第一天只保证：能登录、能找到人、知道这周做什么 |
| 导师替新人把任务做完 | 他什么也没学到 | 让新人自己做，导师先看第一批产出 |
| 导师只问「有问题吗」 | 新人几乎都会说没有 | 改问「今天哪一步最花时间」 |

关于「怎么问问题」，团队这一侧也要有约定：回答时尽量附上文档链接；同一个问题被问到第二次，就补进常见问题文档；不说「这个你都不知道」这类话。新人敢不敢问，取决于前三次提问得到什么样的回应。

## 边界与不做什么

- 不替公司定制度：试用期长短、转正标准、薪酬福利、考勤规则以公司制度和 HR 口径为准，本技能只把已有规定写清楚。
- 劳动合同、社保公积金、试用期解除等问题找 HR 或劳动法律师，本技能不做解答。
- 不开通任何账号，不接入任何系统；权限表只是清单。
- 不把初始密码、密钥、内部地址写进指南；账号凭据走公司规定的安全渠道发放。
- 新人持续焦虑、失眠时，导师可以倾听，但要引导对方找 HR 或专业心理咨询，不替代专业帮助。