AI Agent 新员工入职引导系统设计文档

┌─────────────────────────────────────────────────────────────────┐
│                    Onboarding Orchestrator                      │
│                    (入职编排官 · 核心调度层)                      │
│                                                                 │
│  职责: 任务路由 / 状态跟踪 / 优先级决策 / 异常升级 / 仪表盘汇总    │
└──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬─────────┘
       │      │      │      │      │      │      │      │
       ▼      ▼      ▼      ▼      ▼      ▼      ▼      ▼
   ┌──────┐┌─────┐┌─────┐┌─────┐┌─────┐┌─────┐┌─────┐┌──────┐
   │Pre-  ││Day-1││Task ││Growth││Know-││Men- ││Expe-││ Ops  │
   │board ││Guide││Board││Track ││ledge││tor  ││rience││Agent │
   │Agent ││Agent││Agent││Agent ││Agent││Match││Survey││      │
   │      ││     ││     ││     ││     ││Agent││or   ││      │
   └──┬───┘└──┬──┘└──┬──┘└──┬──┘└──┬──┘└──┬──┘└──┬──┘└──┬───┘
      │       │     │     │     │     │     │     │
      └───────┴─────┴─────┴─────┴─────┴─────┴─────┘
                        │
                        ▼
              ┌─────────────────┐
              │   Shared Layer  │
              │  (共享数据层)    │
              │                 │
              │ • onboarding/   │  ← 每位新员工一个目录
              │ • specs/        │  ← 岗位入职规格
              │ • artifacts/    │  ← 生成的交付物
              │ • knowledge/    │  ← 知识库
              │ • reviews/      │  ← 评估记录
              │ • decisions/    │  ← 决策日志
              └─────────────────┘

/onboarding-system/
├── agents/                          # 各 Agent 的身份与配置
│   ├── orchestrator/
│   │   └── SOUL.md
│   ├── pre-boarding/
│   │   └── SOUL.md
│   ├── day-one-guide/
│   │   └── SOUL.md
│   ├── task-board/
│   │   └── SOUL.md
│   ├── growth-tracker/
│   │   └── SOUL.md
│   ├── knowledge/
│   │   └── SOUL.md
│   ├── mentor-match/
│   │   └── SOUL.md
│   ├── experience-surveyor/
│   │   └── SOUL.md
│   └── ops/
│       └── SOUL.md
├── shared/                          # 跨 Agent 共享
│   ├── onboarding/                  # 每位新员工一个目录
│   │   └── {employee-id}/
│   │       ├── profile.json         # 员工基础信息
│   │       ├── pre-boarding/        # 入职前准备记录
│   │       ├── day-one/             # 首日引导记录
│   │       ├── week-one/            # 首周任务看板
│   │       ├── growth/              # 成长路线图
│   │       ├── qa-log/              # 问答记录
│   │       ├── mentor/              # 导师匹配记录
│   │       └── surveys/             # 满意度调研
│   ├── specs/                       # 岗位入职规格模板
│   │   ├── engineer-onboarding-spec.md
│   │   ├── designer-onboarding-spec.md
│   │   └── pm-onboarding-spec.md
│   ├── knowledge/                   # 公司知识库
│   │   ├── policies/                # 规章制度
│   │   ├── tools/                   # 工具使用指南
│   │   ├── culture/                 # 文化价值观
│   │   └── faq/                     # 高频问题
│   ├── reviews/                     # 评估记录
│   ├── decisions/                   # 决策日志
│   └── dashboard/                   # 仪表盘数据
└── templates/                       # 可复用模板
    ├── pre-boarding-checklist.md
    ├── day-one-timeline.md
    ├── week-one-board.md
    ├── 30-60-90-roadmap.md
    ├── 1on1-template.md
    └── survey-templates/

# SOUL.md — Onboarding Orchestrator

我是入职编排官。我的职责是确保每位新员工从 offer 接受到 90 天转正评估的
全流程顺畅运行。我不执行具体任务——我路由、跟踪、决策和升级。

## 职责范围
- 接收新员工入职通知，创建 onboarding 记录
- 将准备任务路由给 Pre-boarding Agent
- 在关键节点触发对应 Agent（首日、首周、30/60/90 天）
- 监控所有 in-progress 任务，识别阻塞并升级
- 汇总仪表盘数据，向 HR/管理层报告

## 决策边界
- 入职规格不明确 → 查阅 specs/ 或询问 HR，不自行编造
- Agent 超时无响应（> 预期时间 1.5 倍）→ 标记 stale，重启或重分配
- 跨部门阻塞（IT/行政/安全）→ 升级到人类 HR，附带完整上下文
- 新员工主动反馈负面体验 → 立即触发 Experience Surveyor Agent

## 交接格式
每次触发 Agent 时提供：
1. 员工 ID 和基础信息
2. 当前入职阶段
3. 该阶段的具体任务清单
4. 输出路径（shared/onboarding/{id}/对应目录）
5. 完成后的交接要求

入职前 5 工作日 (D-5)
├── [HR] 发送欢迎邮件 + 入职指引（含报到时间、地点、着装、需带材料）
├── [HR] 录入员工基本信息到系统
├── [IT] 启动设备采购/调配流程
└── [Orchestrator] 创建 onboarding 记录，分配 {employee-id}

入职前 3 工作日 (D-3)
├── [IT] 开通企业邮箱
├── [IT] 确认设备到位
├── [行政] 分配工位
├── [用人经理] 确认导师人选
└── [Pre-boarding Agent] 第一次进度检查，标记逾期项

入职前 2 工作日 (D-2)
├── [IT] 开通 VPN + 内部系统权限
├── [行政] 准备门禁卡
├── [用人经理] 提交首周任务规划
└── [Pre-boarding Agent] 第二次进度检查，逾期项升级到 HR

入职前 1 工作日 (D-1)
├── [HR] 准备劳动合同
├── [HR] 更新员工手册
├── [Knowledge Agent] 配置知识库访问权限
├── [Day-One Guide Agent] 生成个性化入职引导页面
├── [Mentor Match Agent] 发送导师匹配通知
└── [Pre-boarding Agent] 最终检查，生成《入职准备就绪报告》

触发条件: Orchestrator 创建 onboarding 记录（D-5）

1. 读取新员工 profile.json（岗位、部门、入职日期）
2. 根据岗位匹配入职规格模板 (specs/{role}-onboarding-spec.md)
3. 生成个性化准备清单 → 写入 shared/onboarding/{id}/pre-boarding/checklist.md
4. 逐项创建任务卡片，派发给对应责任方
5. 定时检查（D-3, D-2, D-1）：
   a. 扫描所有任务状态
   b. 标记逾期项（超过截止时间仍未 Ready）
   c. 逾期项自动发送催办通知给责任方
   d. D-2 仍有逾期的 → 升级到 HR
6. D-1 生成《入职准备就绪报告》:
   - 全部准备项状态汇总
   - 逾期/风险项标注
   - 首日注意事项
   → 写入 shared/onboarding/{id}/pre-boarding/readiness-report.md
7. 交接给 Orchestrator: "准备清单执行完毕，N 项就绪，M 项风险，详见报告"

┌─────────────────────────────────────────────────────────────┐
│                    Day 1 Timeline                           │
├──────────┬──────────────────────────────────────────────────┤
│ 时间段    │ 活动内容                                         │
├──────────┼──────────────────────────────────────────────────┤
│ 09:00    │ 【报到迎接】                                     │
│ - 09:30  │ • HR/前台迎接，领取门禁卡                        │
│          │ • 引导至工位，确认设备就绪                       │
│          │ • 签署劳动合同（HR 主持）                        │
│          │ • 领取员工手册                                   │
├──────────┼──────────────────────────────────────────────────┤
│ 09:30    │ 【系统配置】                                     │
│ - 10:30  │ • 首次登录企业邮箱                               │
│          │ • 配置 VPN 连接                                  │
│          │ • 登录内部系统（Jira/Confluence/GitLab 等）      │
│          │ • 配置开发环境/工作工具                          │
│          │ • Day-One Guide Agent 实时辅助                   │
├──────────┼──────────────────────────────────────────────────┤
│ 10:30    │ 【公司介绍】                                     │
│ - 11:30  │ • 公司历史、愿景、价值观                         │
│          │ • 组织架构与部门职责                             │
│          │ • 规章制度要点（考勤、报销、请假）               │
│          │ • 安全合规要求                                   │
│          │ • Knowledge Agent 推送相关文档链接               │
├──────────┼──────────────────────────────────────────────────┤
│ 11:30    │ 【团队破冰】                                     │
│ - 12:00  │ • 用人经理带领介绍团队成员                       │
│          │ • 导师正式见面                                   │
│          │ • 确认首周 1-on-1 时间                           │
├──────────┼──────────────────────────────────────────────────┤
│ 12:00    │ 【午餐】                                         │
│ - 13:30  │ • 导师/团队成员陪同午餐                          │
│          │ • 非正式交流                                     │
├──────────┼──────────────────────────────────────────────────┤
│ 13:30    │ 【岗位认知】                                     │
│ - 15:00  │ • 用人经理 1-on-1：岗位职责详解                  │
│          │ • 团队当前项目概览                               │
│          │ • 首周期望与目标对齐                             │
│          │ • Review 首周任务看板                            │
├──────────┼──────────────────────────────────────────────────┤
│ 15:00    │ 【环境探索】                                     │
│ - 16:00  │ • 代码仓库 clone & 本地构建                      │
│          │ • 文档库浏览（团队规范、技术栈文档）             │
│          │ • Knowledge Agent 引导式知识库走查               │
│          │ • 标记待学习文档                                 │
├──────────┼──────────────────────────────────────────────────┤
│ 16:00    │ 【首日总结】                                     │
│ - 17:00  │ • 填写首日检查清单                               │
│          │ • 提交首日反馈（Experience Surveyor Agent）      │
│          │ • 确认 Day 2-5 任务安排                          │
│          │ • 导师简短 check-in：今日感受、明日计划           │
└──────────┴──────────────────────────────────────────────────┘

触发条件: 入职前 1 工作日 (D-1)

1. 读取新员工 profile.json + 岗位入职规格
2. 读取 Pre-boarding Agent 的就绪报告
3. 生成个性化首日时间轴:
   - 根据岗位调整活动内容（工程师侧重开发环境，设计师侧重设计工具）
   - 根据就绪报告标注风险项（如"VPN 未就绪，10:30 前需 IT 协助"）
   → 写入 shared/onboarding/{id}/day-one/timeline.md
4. 生成首日检查清单（新员工自助勾选）
   → 写入 shared/onboarding/{id}/day-one/checklist.md
5. 推送首日引导页面到新员工终端

入职当日:
6. 实时辅助模式：
   - 新员工遇到问题 → Knowledge Agent 优先响应
   - 系统配置问题 → Day-One Guide Agent 提供步骤指引
   - 无法解决的问题 → 升级到 IT/HR
7. 16:00 触发首日检查清单填写
8. 16:30 触发 Experience Surveyor Agent 采集首日反馈
9. 17:00 生成的首日总结报告
   → 写入 shared/onboarding/{id}/day-one/summary.md
10. 交接给 Orchestrator: "首日引导完成，N/M 项检查通过，反馈分数 X/5"

{
  "task_id": "WB-{employee-id}-W1-001",
  "title": "配置本地开发环境",
  "priority": "MUST",           // MUST | SHOULD | EXPLORE
  "category": "ENVIRONMENT",    // ENVIRONMENT | LEARNING | SOCIAL | DELIVERABLE
  "assigned_by": "Task Board Agent",
  "estimated_hours": 2,
  "due_day": "Day 1",          // Day 1-5
  "status": "TODO",            // BACKLOG | TODO | IN_PROGRESS | DONE | BLOCKED
  "dependencies": ["WB-{id}-W1-000"],
  "checklist": [
    "安装 Node.js / Python / Java（按技术栈）",
    "配置 Git 全局用户名和邮箱",
    "Clone 主仓库到本地",
    "成功运行项目构建命令",
    "运行测试套件确认通过"
  ],
  "resources": [
    {"type": "doc", "title": "开发环境配置指南", "url": "knowledge/tools/dev-setup.md"},
    {"type": "person", "name": "导师", "role": "答疑"}
  ],
  "completion_criteria": "本地能成功构建项目并运行测试",
  "notes": ""
}

触发条件: 入职前 2 工作日 (D-2)，由 Orchestrator 触发

1. 读取员工 profile + 岗位入职规格 + 用人经理提交的首周任务规划
2. 根据模板生成个性化首周任务卡片集
   → 写入 shared/onboarding/{id}/week-one/board.json
3. 生成看板视图
   → 写入 shared/onboarding/{id}/week-one/board.md
4. 推送到新员工看板界面

入职首周期间:
5. 每日 09:00 (Ops Agent 触发):
   a. 扫描看板状态
   b. 检查是否有任务应于今日完成但仍在 TODO
   c. 发送每日提醒给新员工
6. 每日 18:00:
   a. 统计当日完成情况
   b. 检查是否有 BLOCKED 任务超过 4h 未解决
   c. BLOCKED 任务 → 通知导师协助
7. Day 5 17:00:
   a. 生成首周任务完成报告
   b. 标记未完成任务，滚动到 Week 2
   → 写入 shared/onboarding/{id}/week-one/summary.md
8. 交接给 Orchestrator: "首周看板: N 项完成, M 项进行中, K 项阻塞"

┌─────────────────────────────────────────────────────────┐
│              30 天里程碑: "能独立完成简单任务"             │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  维度         │ 30 天目标                               │
│  ────────────┼──────────────────────────────────────── │
│  业务理解     │ 能完整口述核心业务流程，理解团队在流程中  │
│               │ 的位置和职责                             │
│               │                                         │
│  技术能力     │ 熟练使用团队技术栈，能独立完成 1-2 个     │
│               │ 小型任务/bug 修复                        │
│               │                                         │
│  团队融入     │ 认识所有直属团队成员，参加至少 2 次团队   │
│               │ 活动，建立日常沟通节奏                    │
│               │                                         │
│  流程规范     │ 熟悉代码评审、发布、值班流程，完成首次    │
│               │ 代码评审参与                             │
│               │                                         │
│  文化认同     │ 理解公司价值观，能举例说明价值观在日常    │
│               │ 工作中的体现                             │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│              60 天里程碑: "能独立承担中等任务"            │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  维度         │ 60 天目标                               │
│  ────────────┼──────────────────────────────────────── │
│  业务理解     │ 深入理解所负责模块的业务逻辑，能识别      │
│               │ 潜在风险和改进点                         │
│               │                                         │
│  技术能力     │ 独立完成 1 个中等复杂度需求（跨模块/      │
│               │ 涉及设计决策），参与 1 次技术方案评审     │
│               │                                         │
│  团队融入     │ 主动参与团队讨论，提出至少 1 个改进建议   │
│               │ 开始与新员工分享入职经验                  │
│               │                                         │
│  流程规范     │ 独立完成 1 次发布流程，参与 1 次值班      │
│               │                                         │
│  文化认同     │ 参与至少 1 次跨团队协作                   │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│              90 天里程碑: "能独立工作并规划未来"          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  维度         │ 90 天目标                               │
│  ────────────┼──────────────────────────────────────── │
│  业务理解     │ 全面理解业务全貌，能独立处理业务咨询      │
│               │                                         │
│  技术能力     │ 独立完成 1 个复杂需求或主导 1 个小型      │
│               │ 技术改进项目                             │
│               │                                         │
│  团队融入     │ 成为团队可靠贡献者，能指导更新的员工      │
│               │                                         │
│  流程规范     │ 熟练掌握所有团队流程，能独立处理突发      │
│               │ 事件                                     │
│               │                                         │
│  文化认同     │ 主动参与文化建设，价值观践行获团队认可    │
│               │                                         │
│  未来规划     │ 与经理共同制定下季度个人发展计划 (IDP)    │
└─────────────────────────────────────────────────────────┘

触发条件: 入职当日 (Day 1)，由 Orchestrator 触发

1. 读取员工 profile + 岗位规格 + 用人经理输入
2. 生成个性化 30-60-90 路线图:
   - 根据员工经验级别调整目标难度
   - 根据团队当前项目调整具体任务
   - 标注每个里程碑的评估方式和评估人
   → 写入 shared/onboarding/{id}/growth/roadmap.md

持续运行:
3. 每周 (Ops Agent 触发):
   a. 检查里程碑进度
   b. 标记临近截止但未完成的里程碑
   c. 发送进度提醒给新员工和导师

4. Day 30 触发 30 天评估:
   a. 生成评估问卷（自评 + 导师评 + 经理评）
   b. 收集评估结果
   c. 对比里程碑目标，生成差距分析
   d. 如差距显著 → 触发调整建议（延长 ramp-up、调整任务难度等）
   e. 生成 30 天评估报告
   → 写入 shared/onboarding/{id}/growth/day30-review.md

5. Day 60 触发 60 天评估 (流程同上)
6. Day 90 触发 90 天转正评估:
   a. 汇总 30/60/90 三次评估数据
   b. 生成入职全周期成长报告
   c. 触发 IDP 制定流程
   d. 生成知识库贡献提醒
   → 写入 shared/onboarding/{id}/growth/day90-final-review.md
   e. 交接给 Orchestrator: "入职周期完成，转正评估: 通过/需延长"

shared/knowledge/
├── policies/                    # 规章制度
│   ├── attendance.md            # 考勤制度
│   ├── reimbursement.md         # 报销流程
│   ├── leave.md                 # 请假流程
│   ├── security.md              # 安全合规
│   └── remote-work.md           # 远程办公
├── tools/                       # 工具使用指南
│   ├── dev-environment.md       # 开发环境配置
│   ├── git-workflow.md          # Git 工作流
│   ├── ci-cd.md                 # CI/CD 流程
│   ├── vpn-setup.md             # VPN 配置
│   └── communication.md         # 沟通工具（IM/邮件/会议）
├── culture/                     # 文化价值观
│   ├── values.md                # 核心价值观
│   ├── stories.md               # 文化故事
│   └── norms.md                 # 团队约定
├── faq/                         # 高频问题（自动积累）
│   ├── day1-faq.md              # 首日高频问题
│   ├── week1-faq.md             # 首周高频问题
│   └── general-faq.md           # 通用高频问题
├── onboarding/                  # 入职专属知识
│   ├── glossary.md              # 公司术语表
│   ├── org-chart.md             # 组织架构
│   └── team-intro/              # 各团队介绍
└── index.json                   # 知识库索引（向量检索）

新员工提问
    │
    ▼
┌─────────────┐
│ 意图识别     │ ← Knowledge Agent
│             │
│ 分类:       │
│ A. 事实型   │ → "Wi-Fi 密码是什么"
│ B. 流程型   │ → "怎么申请报销"
│ C. 技术型   │ → "这个 API 怎么调用"
│ D. 人际型   │ → "谁负责 XXX 模块"
│ E. 文化型   │ → "公司的晋升机制是什么"
└──────┬──────┘
       │
       ▼
┌─────────────┐     置信度 ≥ 0.85     ┌──────────────┐
│ 知识库检索   │ ──────────────────→ │ 直接回答      │
│ (向量+关键词)│                      │ + 附带来源链接 │
└──────┬──────┘                      └──────────────┘
       │ 置信度 < 0.85
       ▼
┌─────────────┐     找到相关文档      ┌──────────────┐
│ 文档推荐     │ ──────────────────→ │ 推荐文档      │
│             │                      │ "你可能需要   │
│             │                      │  查看这篇"    │
└──────┬──────┘                      └──────────────┘
       │ 未找到相关文档
       ▼
┌─────────────┐     能识别应答人      ┌──────────────┐
│ 路由到人     │ ──────────────────→ │ 转发给导师/   │
│             │                      │ 相关负责人    │
│             │                      │ + 记录问题    │
└──────┬──────┘                      └──────────────┘
       │ 无法识别应答人
       ▼
┌─────────────┐
│ 升级到 Orchestrator               │
│ → 转发给用人经理                  │
│ → 记录为新知识缺口                │
│ → 答案获得后沉淀到 FAQ            │
└───────────────────────────────────┘

触发条件: 持续运行（7×24 在线）

初始化:
1. 加载知识库索引 (shared/knowledge/index.json)
2. 向量化所有知识文档
3. 建立意图分类模型

运行时:
4. 接收新员工提问
5. 意图分类 + 知识库检索
6. 按置信度选择回答路径（直接回答/文档推荐/路由到人/升级）
7. 记录问答日志
8. 每日 (Ops Agent 触发):
   a. 分析高频问题
   b. 识别知识缺口
   c. 生成 FAQ 候选
   d. 更新知识库索引
   → 写入 shared/knowledge/faq/auto-generated-{date}.md

交接规则:
- 无法解决的问题 → 升级到 Orchestrator，附带问题原文和检索记录
- 识别到新员工情绪负面（如"好难""想放弃"）→ 立即通知导师

def match_mentor(new_hire, mentor_pool):
    """
    计算新员工与候选导师池的匹配分数，返回 Top-3
    """
    scores = []
    for mentor in mentor_pool:
        # 排除条件
        if mentor.current_mentee_count >= 3:
            continue
        if mentor.department == new_hire.direct_department:
            # 同部门导师降权（避免直接上级兼任导师）
            dept_penalty = 0.8
        else:
            dept_penalty = 1.0

        # 各维度分数 (0-1)
        tech_score = jaccard_similarity(new_hire.tech_stack, mentor.tech_stack)
        role_score = 1.0 if new_hire.role_family == mentor.role_family else 0.3
        personality_score = personality_complement(new_hire.personality, mentor.personality)
        location_score = 1.0 if new_hire.location == mentor.location else 0.5
        workload_score = 1.0 - (mentor.current_mentee_count / 3)
        tenure_score = tenure_weight(mentor.tenure_years)  # 1-3年最优
        interest_score = jaccard_similarity(new_hire.interests, mentor.interests)

        # 加权总分
        total = (
            tech_score * 0.30 +
            role_score * 0.20 +
            personality_score * 0.15 +
            location_score * 0.15 +
            workload_score * 0.10 +
            tenure_score * 0.05 +
            interest_score * 0.05
        ) * dept_penalty

        scores.append({
            "mentor": mentor,
            "total_score": total,
            "breakdown": {
                "tech": tech_score,
                "role": role_score,
                "personality": personality_score,
                "location": location_score,
                "workload": workload_score,
                "tenure": tenure_score,
                "interest": interest_score
            }
        })

    # 返回 Top-3
    scores.sort(key=lambda x: x["total_score"], reverse=True)
    return scores[:3]

触发条件: 入职前 3 工作日 (D-3)

1. Mentor Match Agent 读取新员工 profile
2. 从导师池中筛选可用导师
3. 运行匹配算法，生成 Top-3 候选
4. 生成匹配报告（含各维度得分和推荐理由）
   → 写入 shared/onboarding/{id}/mentor/match-report.md
5. 发送给用人经理确认:
   - 展示 Top-3 候选及匹配理由
   - 经理选择 1 人或提出其他人选
6. 经理确认后:
   a. 向导师发送邀请（含新员工信息、匹配理由、导师职责说明）
   b. 导师确认接受
   c. 向新员工发送导师介绍
   d. 记录匹配结果
   → 写入 shared/onboarding/{id}/mentor/assignment.md

7. 自动安排 1-on-1 日程 (见 8.5)

# 1-on-1 记录: {新员工姓名} × {导师姓名}
**日期**: {date}
**阶段**: {Week 1 / Day 30 / Day 60...}
**时长**: {minutes}

## 导师检查清单（会前预览）

- [ ] 查看新员工本周任务看板完成情况
- [ ] 查看新员工问答记录（是否有反复追问的领域）
- [ ] 查看新员工满意度调研趋势
- [ ] 准备 1 个具体反馈（正面或改进）

## 建议议程

### 1. 开场 (3min)
- 最近感觉怎么样？（开放性问题，让新员工先说）

### 2. 进度回顾 (10min)
- 本周完成了哪些任务？有什么收获？
- 遇到了什么困难？需要什么帮助？

### 3. 反馈与指导 (10min)
- 导师观察反馈（基于本周看板、问答、评估数据）
- 新员工对导师/团队/流程的反馈

### 4. 下一步规划 (5min)
- 下周重点任务确认
- 需要提前准备什么？

### 5. 开放话题 (2min)
- 有没有其他想聊的？（不限工作）

## 记录

### 关键讨论点
-

### 行动项
| 行动项 | 负责人 | 截止日期 |
|--------|--------|----------|
|        |        |          |

### 风险信号（如有）
-

### 下次 1-on-1 时间
{next_date}

Mentor Match Agent 排程逻辑:

1. 读取导师和新员工的日历
2. 查找双方都可用的时间段:
   - Week 1: 每日 16:00-16:15 优先（避开站会和午休）
   - Week 2+: 每周/每两周固定时段
3. 创建日历邀请（含 1-on-1 模板链接）
4. 会前 1 小时推送提醒给导师（含检查清单）
5. 会前 15 分钟推送提醒给新员工
6. 会后自动推送记录模板
7. 记录完成后归档:
   → shared/onboarding/{id}/mentor/1on1/{date}.md

异常处理:
- 导师请假 → 自动重新安排或寻找临时替代
- 连续 2 次取消 → 通知 Orchestrator，考虑更换导师
- 1-on-1 记录连续 2 次未提交 → 提醒导师

体验画像 = f(主动调研分数, 被动信号指标, 时间衰减加权)

实时体验分数计算:

  ExperienceScore = w1 * SurveyScore + w2 * SignalScore

  其中:
  SurveyScore = 最近一次调研的标准化分数 (0-100)
  SignalScore = 被动信号的加权汇总:
    - 问答活跃度: 25% (正常提问 = 高分)
    - 任务完成率: 25%
    - 1-on-1 情绪: 25%
    - 系统活跃度: 25%

  权重:
  w1 = 0.6 (主动调研更可靠)
  w2 = 0.4 (被动信号补充)

┌─────────────────────────────────────────────────────────┐
│                    预警等级                              │
├──────────┬──────────────────────────────────────────────┤
│ 等级     │ 触发条件                  │ 响应动作          │
├──────────┼──────────────────────────────────────────────┤
│ 🟢 绿色  │ ExperienceScore ≥ 75     │ 正常，无需干预    │
│          │ 无负面信号               │                  │
├──────────┼──────────────────────────────────────────────┤
│ 🟡 黄色  │ 60 ≤ Score < 75          │ 通知导师加强关注  │
│          │ 或出现 1 个负面信号       │ 增加一次 1-on-1   │
├──────────┼──────────────────────────────────────────────┤
│ 🟠 橙色  │ 45 ≤ Score < 60          │ 通知用人经理      │
│          │ 或出现 2 个负面信号       │ 经理安排 1-on-1   │
│          │ 或调研分数骤降 > 20%      │ Experience       │
│          │                          │ Surveyor 深入调研 │
├──────────┼──────────────────────────────────────────────┤
│ 🔴 红色  │ Score < 45               │ 立即通知 HR +    │
│          │ 或连续 2 次调研 < 3 分    │ 用人经理          │
│          │ 或出现"想离开"类信号      │ HR 介入面谈       │
│          │                          │ 制定干预计划      │
└──────────┴──────────────────────────────────────────────┘

触发条件: 持续运行 + 关键节点触发

调研管理:
1. 在 T1-T7 触发点自动推送调研问卷
2. 24h 未填写 → Ops Agent 发送提醒
3. 48h 未填写 → 通知导师提醒
4. 收集调研结果 → 写入 shared/onboarding/{id}/surveys/

被动信号采集:
5. 每日 (Ops Agent 触发):
   a. 从 Knowledge Agent 拉取问答日志
   b. 从 Task Board Agent 拉取任务状态
   c. 从 1-on-1 记录中分析情绪
   d. 从系统日志拉取活跃度数据
   e. 计算当日 ExperienceScore
   → 写入 shared/onboarding/{id}/surveys/daily-score.json

预警处理:
6. 计算预警等级
7. 🟡 → 通知导师
8. 🟠 → 通知用人经理 + 触发深入调研
9. 🔴 → 通知 HR + 用人经理，生成《风险预警报告》
   → 写入 shared/onboarding/{id}/surveys/alert-{date}.md

周期报告:
10. Day 30/60/90 生成阶段体验报告:
    - 体验分数趋势图
    - 调研结果汇总
    - 被动信号分析
    - 预警历史
    - 改进建议
    → 写入 shared/onboarding/{id}/surveys/phase-{N}-report.md

11. Day 90 生成全周期体验报告:
    - 跨阶段趋势对比
    - 各模块满意度排名
    - NPS 分数
    - 高频改进建议汇总
    → 写入 shared/onboarding/{id}/surveys/final-report.md
    → 同时写入 shared/reviews/（供 Orchestrator 汇总到仪表盘）

                    ┌──────────┐
                    │  Inbox   │ ← 新任务创建
                    └────┬─────┘
                         │ Orchestrator 分配
                         ▼
                    ┌──────────┐
                    │ Assigned │ ← 已分配 Agent
                    └────┬─────┘
                         │ Agent 开始执行
                         ▼
                    ┌──────────┐
          ┌────────→│ In Prog. │←───────┐
          │         └────┬─────┘        │
          │              │ Agent 完成   │ Reviewer 退回
          │              ▼              │
          │         ┌──────────┐        │
          │         │  Review  │────────┘
          │         └────┬─────┘
          │              │ Reviewer 通过
          │              ▼
          │         ┌──────────┐
          │         │   Done   │
          │         └──────────┘
          │
          │ 阻塞
          ▼
    ┌──────────┐         ┌──────────┐
    │ Blocked  │────────→│ Escalated│
    └──────────┘  升级    └──────────┘
                         │ 解决
                         ▼
                    ┌──────────┐
                    │ In Prog. │
                    └──────────┘

    任何状态 ──→ Failed (放弃，附带原因)

# 入职每日简报 — {date}

## 今日活跃入职

| 员工 | 阶段 | 体验分 | 预警 | 阻塞任务 |
|------|------|--------|------|----------|
| 张三 | Day 3 | 82 🟢 | 无 | 0 |
| 李四 | Day 15 | 58 🟡 | 导师已通知 | 1 (权限申请) |
| 王五 | Day 45 | 41 🔴 | HR 已通知 | 2 |

## 今日待办
- [ ] EMP-001: 首日引导（Day-One Guide Agent）
- [ ] EMP-002: 30 天评估触发（Growth Tracker Agent）
- [ ] EMP-003: HR 介入面谈跟进

## 逾期任务
| 任务 | 员工 | 逾期天数 | 责任方 | 状态 |
|------|------|----------|--------|------|
| VPN 开通 | EMP-001 | 2 | IT | Escalated |

## Stale 任务（24h+ 无更新）
- 无

## 本周入职预告
- 08/16: 赵六 (前端工程师)
- 08/18: 钱七 (产品经理)

┌─────────────────────────────────────────────────────────┐
│                  入职引导仪表盘                           │
├──────────────────────┬──────────────────────────────────┤
│ 在入职人数           │ 12                               │
│ 本月新入职           │ 8                                │
│ 本月即将入职         │ 5                                │
│ 平均体验分           │ 76 🟢                            │
│ 红色预警人数         │ 1 🔴                             │
│ 90 天转正率          │ 94%                              │
│ 平均 ramp-up 天数    │ 28 天                            │
├──────────────────────┴──────────────────────────────────┤
│ 各阶段体验分数趋势                                       │
│                                                         │
│  90 ┤    ●─────●─────●                                  │
│  80 ┤  ●─┘                                            ● │
│  70 ┤●                                               ● │
│  60 ┤                                            ●●    │
│  50 ┤                                                 │
│     └──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──→         │
│        D1 D3 D7 D14    D30       D60       D90         │
├─────────────────────────────────────────────────────────┤
│ 模块满意度排名 (90 天数据)                                │
│  1. 智能问答助手    4.6/5                                │
│  2. 入职前准备      4.3/5                                │
│  3. 首日引导        4.2/5                                │
│  4. 导师匹配        4.0/5                                │
│  5. 首周任务看板    3.8/5                                │
│  6. 成长路线图      3.7/5                                │
│  7. 满意度追踪      3.5/5                                │
├─────────────────────────────────────────────────────────┤
│ 高频改进建议 (Top 5)                                     │
│  1. "VPN 配置太复杂，希望有视频教程"          (8 票)     │
│  2. "导师太忙，1-on-1 经常被取消"             (6 票)     │
│  3. "希望首周有更多和团队非正式交流的机会"     (5 票)     │
│  4. "30 天评估可以更早一些"                   (4 票)     │
│  5. "知识库部分内容已过时"                    (3 票)     │
└─────────────────────────────────────────────────────────┘

Employee (新员工)
├── id: string (EMP-YYYY-MM-NNN)
├── name: string
├── email: string
├── department: string
├── role: string (engineer | designer | pm | ...)
├── level: string (junior | mid | senior)
├── start_date: date
├── manager_id: string
├── mentor_id: string (nullable)
├── profile: json (技能标签、性格测评、兴趣)
├── status: enum (PRE_BOARDING | ONBOARDING | PROBATION | CONFIRMED)
└── created_at: datetime

OnboardingRecord (入职记录)
├── id: string (ONB-YYYY-MM-NNN)
├── employee_id: string
├── current_phase: enum (PRE | DAY1 | WEEK1 | DAY30 | DAY60 | DAY90 | DONE)
├── experience_score: float (0-100)
├── alert_level: enum (GREEN | YELLOW | ORANGE | RED)
├── tasks: Task[]
├── surveys: Survey[]
├── qa_logs: QALog[]
└── created_at: datetime

Task (任务)
├── id: string
├── onboarding_id: string
├── parent_id: string (nullable)
├── title: string
├── category: enum (PRE_BOARDING | DAY1 | WEEK1 | GROWTH | MENTOR | SURVEY)
├── status: enum (INBOX | ASSIGNED | IN_PROGRESS | REVIEW | DONE | BLOCKED | ESCALATED | FAILED)
├── assigned_agent: string
├── assigned_human: string (nullable)
├── priority: enum (MUST | SHOULD | EXPLORE)
├── due_date: datetime
├── completed_at: datetime (nullable)
├── comments: Comment[]
└── artifacts: string[] (文件路径列表)

MentorAssignment (导师分配)
├── id: string
├── employee_id: string
├── mentor_id: string
├── match_score: float
├── match_breakdown: json
├── confirmed_by: string (manager)
├── confirmed_at: datetime
└── schedule: 1on1Schedule[]

Survey (调研)
├── id: string
├── employee_id: string
├── touchpoint: enum (T1-T7)
├── triggered_at: datetime
├── submitted_at: datetime (nullable)
├── questions: SurveyQuestion[]
└── score: float (nullable)

Phase 0: 基础设施 (Week 1-2)
├── 搭建 shared/ 目录结构
├── 编写岗位入职规格模板（先做工程师岗位）
├── 初始化知识库（从现有文档迁移）
├── 部署 Orchestrator + Ops Agent
└── 验证: 创建测试 onboarding 记录，确认目录结构正确

Phase 1: 核心流程 (Week 3-5)
├── 部署 Pre-boarding Agent
├── 部署 Day-One Guide Agent
├── 部署 Task Board Agent
├── 部署 Knowledge Agent（基础问答）
├── 端到端测试: 模拟 1 位新员工完整首周流程
└── 验证: 首日检查清单 100% 可执行

Phase 2: 成长与匹配 (Week 6-8)
├── 部署 Growth Tracker Agent
├── 部署 Mentor Match Agent
├── 建立导师池（从现有员工中招募和画像）
├── 1-on-1 排程集成日历系统
└── 验证: 导师匹配 Top-3 合理性经经理确认

Phase 3: 体验监控 (Week 9-10)
├── 部署 Experience Surveyor Agent
├── 部署被动信号采集管道
├── 配置预警规则和通知通道
├── 仪表盘上线
└── 验证: 模拟预警场景，确认通知链路正常

Phase 4: 试点运行 (Week 11-14)
├── 选择 3-5 位真实新员工试点
├── 全流程运行，收集反馈
├── 每周 Review: 体验分数、Agent 表现、流程卡点
├── 迭代优化
└── 验证: 试点新员工 30 天体验分数 ≥ 75

Phase 5: 全面上线 (Week 15+)
├── 所有新员工纳入系统
├── 扩展岗位模板（设计师、产品经理、运营等）
├── 建立持续优化机制（月度复盘）
└── 长期目标: 90 天转正率 ≥ 95%，平均体验分 ≥ 80

# SOUL.md — Pre-boarding Agent

我是入职前准备专员。我的职责是确保每位新员工在报到前一切就绪。

## 职责范围
- 根据岗位规格生成个性化准备清单
- 逐项派发任务给 IT/行政/HR/用人经理
- 定时检查进度，标记逾期，自动催办
- 生成《入职准备就绪报告》

## 决策边界
- 清单内容基于岗位规格模板，不自行添加或删除项目
- 逾期项先催办，D-2 仍逾期才升级到 HR
- 设备/账号的具体配置由 IT 决定，我只跟踪状态

## 交接格式
完成后向 Orchestrator 报告:
1. 准备清单总项数和完成数
2. 逾期/风险项列表（含原因和当前状态）
3. 就绪报告路径
4. 首日需要注意的风险提示

# SOUL.md — Knowledge Agent

我是新员工的 7×24 问答助手。我的目标是让新员工的问题在 30 秒内得到响应。

## 职责范围
- 基于知识库回答新员工问题
- 无法回答的问题路由到正确的人
- 记录所有问答，识别知识缺口
- 持续优化知识库

## 决策边界
- 只回答知识库覆盖范围内的问题，不编造答案
- 置信度 < 0.5 的问题必须路由到人，不猜测
- 检测到新员工情绪负面信号 → 立即通知导师
- 涉及薪资/合同等敏感问题 → 路由到 HR

## 响应原则
- 事实型问题: 直接回答 + 来源链接
- 流程型问题: 分步骤回答 + 文档链接
- 技术型问题: 概念解释 + 代码示例 + 文档链接
- 找人型问题: 直接告知负责人 + 联系方式
- 超范围问题: "这个问题我需要帮你转给 XXX，已通知 Ta"

# SOUL.md — Experience Surveyor Agent

我是入职体验调研员。我的目标是在新员工"用脚投票"之前发现问题。

## 职责范围
- 在关键触点投放脉冲调研
- 持续采集被动信号，计算体验分数
- 识别预警信号，触发分级响应
- 生成阶段性和全周期体验报告

## 决策边界
- 调研内容基于模板，不自行设计新题目（需 Orchestrator 批准）
- 预警分级严格按阈值执行，不主观判断
- 红色预警必须立即通知 HR，不延迟
- 体验数据仅 HR 和用人经理可见，不向其他新员工暴露

## 分析原则
- 趋势比绝对值更重要（连续下降比单次低分更危险）
- 主动调研和被动信号交叉验证
- 开放式反馈的文本分析重点关注情绪词和风险信号词
- 每次预警都附带上下文，不只是分数

# 工程师入职规格

## 岗位信息
- 岗位序列: 研发
- 技术栈: {根据具体团队填充}
- 直接上级: {team_lead}
- 导师要求: 同技术栈，司龄 1-3 年

## 入职前准备
### IT 账号
- 企业邮箱
- VPN 账号
- GitLab 账号（需指定 group 权限）
- Jira 账号（需指定项目权限）
- Confluence 账号（需指定空间权限）
- CI/CD 系统账号
- 日志系统账号
- 监控系统账号

### IT 设备
- 笔记本电脑（MacBook Pro / ThinkPad，按团队标准）
- 外接显示器 × 2
- 机械键盘 + 鼠标
- Docking station
- 耳机

### 系统权限
- 代码仓库: {repo_list} 的 read/write 权限
- 测试环境: {test_env} 访问权限
- 生产环境: 仅 read 权限（转正后申请 write）

## 首日引导
### 系统配置（09:30-10:30）
- 配置 SSH key
- 配置 Git 全局配置
- Clone 主仓库
- 安装依赖
- 本地构建验证

### 环境探索（15:00-16:00）
- 阅读项目 README
- 阅读 CONTRIBUTING.md
- 阅读技术架构文档
- 跑通本地开发环境
- 标记待学习文档

## 首周任务
（见模块三 5.4 节工程师模板）

## 30-60-90 天里程碑
（见模块四 6.2 节，根据具体技术栈调整目标）

## 知识库优先阅读
- 团队编码规范
- Git 工作流指南
- CI/CD 流程文档
- 代码评审规范
- 技术架构概览

# Decision: 导师匹配算法权重调整

**Date:** 2026-08-14
**Author:** Orchestrator
**Status:** Accepted
**Task:** #MEN-001

## Context
试点期间发现，技术栈匹配权重过高导致部分新员工匹配到性格不合的导师，
1-on-1 取消率上升 15%。

## Options Considered
1. 降低技术栈权重，提高性格互补权重 — 更注重沟通体验
2. 维持现状，增加试用期机制 — 允许 2 周后更换导师
3. 引入导师自荐机制 — 让导师主动选择新员工

## Decision
选择方案 1。将技术栈权重从 35% 降至 30%，性格互补权重从 10% 提至 15%。
同时保留方案 2 的试用期机制作为兜底。

## Consequences
- 匹配算法需要重新运行
- 现有匹配关系不受影响（仅对新匹配生效）
- 需要更新 Mentor Match Agent 的 SOUL.md