把离职交接做成 AI Skill：让知识交接从“靠人记”变成“按流程产出”

employee:
  name: "张三"
  role: "后端工程师"
  team: "交易平台组"
  last_day: "2026-08-31"
  successor: "李四"

projects:
  - name: "订单服务"
    status: "稳定运行，近期在做支付超时重试优化"
    repositories:
      - "https://git.example.com/trade/order-service"
    runtime:
      env: "Kubernetes: prod-trade namespace"
      dashboard: "https://grafana.example.com/d/order-service"
    risks:
      - "月底促销流量上升，重试策略需要压测后再全量开启"
    next_actions:
      - "完成 retry-policy 分支代码评审"
      - "和 SRE 确认压测窗口"

contacts:
  - name: "王五"
    role: "产品负责人"
    topic: "订单逆向流程需求"
  - name: "赵六"
    role: "SRE"
    topic: "生产发布与告警规则"

access_notes:
  - "Git 仓库权限需要由团队主管在 IAM 系统转授权"
  - "生产数据库无个人直连权限，通过堡垒机审批访问"

from pathlib import Path
import yaml

source = Path("handover.yaml")
data = yaml.safe_load(source.read_text(encoding="utf-8"))

employee = data["employee"]
lines = []

lines.append(f"# {employee['name']}离职交接文档")
lines.append("")
lines.append("## 基本信息")
lines.append(f"- 姓名：{employee['name']}")
lines.append(f"- 角色：{employee['role']}")
lines.append(f"- 团队：{employee['team']}")
lines.append(f"- 最后工作日：{employee['last_day']}")
lines.append(f"- 接手人：{employee['successor']}")
lines.append("")

lines.append("## 项目交接")
for project in data.get("projects", []):
    lines.append(f"### {project['name']}")
    lines.append(f"- 当前状态：{project['status']}")
    lines.append("- 代码仓库：")
    for repo in project.get("repositories", []):
        lines.append(f"  - {repo}")
    runtime = project.get("runtime", {})
    lines.append(f"- 运行环境：{runtime.get('env', '未填写')}")
    lines.append(f"- 监控看板：{runtime.get('dashboard', '未填写')}")
    lines.append("- 风险：")
    for risk in project.get("risks", []):
        lines.append(f"  - {risk}")
    lines.append("- 下一步动作：")
    for action in project.get("next_actions", []):
        lines.append(f"  - {action}")
    lines.append("")

lines.append("## 关键联系人")
for contact in data.get("contacts", []):
    lines.append(f"- {contact['name']}（{contact['role']}）：{contact['topic']}")
lines.append("")

lines.append("## 权限与访问说明")
for note in data.get("access_notes", []):
    lines.append(f"- {note}")
lines.append("")

required_paths = [
    ("employee.successor", employee.get("successor")),
    ("projects", data.get("projects")),
    ("contacts", data.get("contacts")),
    ("access_notes", data.get("access_notes")),
]
missing = [name for name, value in required_paths if not value]

lines.append("## 完整性检查")
if missing:
    lines.append("以下字段需要补充：")
    for item in missing:
        lines.append(f"- {item}")
else:
    lines.append("基础交接信息已填写完整。")

Path("handover.md").write_text("\n".join(lines), encoding="utf-8")
print("Generated handover.md")

python -m pip install pyyaml
python generate_handover.py

你是一个离职交接助手。你的任务是根据用户提供的事实生成交接文档。

规则：
1. 只能使用用户提供的信息，不要编造仓库、系统、联系人或风险。
2. 如果关键信息缺失，先输出“需要补充的问题”，不要直接生成最终版。
3. 输出 Markdown，章节包括：基本信息、项目交接、权限与资产、关键联系人、未完事项、风险提示、验收清单。
4. 对每个项目都必须包含：当前状态、代码或文档入口、接手人、下一步动作、风险。
5. 涉及密码、密钥、Token 时，只提示走公司密钥管理或权限转移流程，不要要求用户粘贴明文。