project-handover

Files (12)

• SKILL.md
• coverage-report-template.md · assets/
• handover-manual-template.md · assets/
• degradation.md · references/
• example-full-run.md · references/
• extraction-rules.md · references/
• failure-modes.md · references/
• handover-checklist.md · references/
• handover-dimensions.md · references/
• memory-persistence-guide.md · references/
• knowledge_coverage_scorer.py · scripts/
• test_knowledge_coverage_scorer.py · scripts/

SKILL.md (first lines)

# 项目交接 Skill

把"项目/岗位交接"这件事，稳定地执行成一条可复用的流水线。

核心理念：**Agent 成为原负责人的"代言人"**——不是被动回答问题，而是主动挖掘隐性知识、发现交接盲区、沉淀为可长期查询的数字资产。

```
输入 → Step0 范围评估(门禁) → Step1 问题清单(6维度) → Step2 材料收集
     → Step3 知识提炼(分类+交叉验证) → Step4 覆盖度自检(门禁≥60%)
     → Step5 手册生成 → Step6 记忆写入 → Step7 终审(质量门禁)
     → 输出：交接手册 + 记忆文件 + 覆盖度报告
```

## 适用场景

同事离职/轮岗交接 | 新人入职快速上手 | 项目移交 | 长期项目归档 | 主动知识资产化

## 输入约定

### 必填项

| 字段 | 说明 | 示例 |
|------|------|------|
| `交接人`（原负责人） | 知识的来源方 | "张三 / 学科运营组" |
| `被交接人`（接手方） | 知识的接收方 | "李四 / 我自己" |
| `交接范围` | 需要交接的具体内容 | "教师运营全流程 + 星河社区维护" |

### 可选项

| 字段 | 说明 | 默认值 |
|------|------|--------|
| `材料路径` | 原始文档/知识库的路径 | 无，Step 2 再收集 |
| `交接截止日` | 交接完成的日期 | 无，不设截止 |
| `调研深度` | 快速 / 标准 / 深度 | 标准 |
| `已有记忆文件` | Agent 记忆路径 | `.claude/memory/` |

### 输入校验规则

- 用户只说"帮我做个交接"但没说交接什么 → **追问**，不要猜测范围
- 用户说了交接对象但描述模糊（如"运营相关的工作"）→ 按标准维度走完整流程
- 用户已提供完整材料路径 → 可跳过 Step 2 直接进入 Step 3

## 工具选择

| 能力 | 用途 | 优先级 |
|------|------|--------|
| `WebFetch` / `Read` | 读取文档、知识库、代码仓库 | 首选 |
| `Glob` / `Grep` | 搜索项目文件、配置 | 首选 |
| `Bash` | 执行脚本（覆盖度评分等） | 按需 |
| `Write` / `Edit` | 写入手册、记忆文件 | 输出阶段 |
| `CronCreate` | 设置交接跟进提醒 | Step 6（可选） |

如果需要外部搜索（原负责人的公开资料等），使用 WebSearch。

## 依赖与兼容性

| 依赖项 | 类型 | 必要性 | 不可用时的降级方案 |
|--------|------|--------|-------------------|
| `Write`/`Edit`/`Read` 工具 | Agent 能力 | **硬依赖** | 无法写入文件时，全部内容输出到交接手册，提示用户手动保存记忆文件 |
| `.claude/memory/` 目录 | 文件系统 | **硬依赖** | 目录不存在时，使用用户指定的路径或当前目录下 `memory/` |
| `WebFetch` | Agent 能力 | 软依赖 | 无法访问外部 URL 时，仅处理本地文件，标注 `[外部资源不可读]` |
| `CronCreate` | Agent 能力 | 可选 | 无法设置定时提醒时，在手册中列出需跟进事项，由用户自行安排 |
| `knowledge_coverage_scorer.py` | 脚本 | 可选 | 脚本不可执行时，Agent 在 Step 4 手动评估覆盖率（精确度略低） |

**与相邻 Skill 的兼容性**：当本 Skill 与 `org-research`、`data-resource-evaluation` 等同时安装时，以用户明确指令为准。如果用户说"交接"，走本 Skill 流程；如果说"调研某个机构"，走 `org-research`。

## 执行流程

### Step 0：交接范围评估

**目标**：明确交接边界，防止范围蔓延。

1. 从输入中提取 `交接人`、`被交接人`、`交接范围`
2. 范围模糊则向用户确认（最多 2 轮）：交接哪些模块？有没有不在范围内的？
3. 输出交接范围确认单（含交接人、被交接人、交接范围列表、预计产出）

> **门禁**：没有明确交接人和交接范围 → 不得进入 Step 1。

### Step 1：生成交接问题清单

**目标**：按 6 个维度生成结构化问题清单，确保不遗漏关键信息。

维度定义详见 [`references/handover-dimensions.md`](references/handover-dimensions.md)。

6 个维度：业务流程 | 项目与待办 | 联系人 | 隐性知识与决策 | 模板与资产 | 风险与异常

**裁剪规则**：
- `快速`模式：每维度 3-4 题，合计 18-24 题
- `标准`模式：每维度 5-6 题，合计 30-36 题
- `深度`模式：每维度 6-8 题，合计 36-48 题

> **门禁**：问题总数 < 15 → 检查是否遗漏维度。

### Step 2：收集原始材料

**目标**：系统收集交接所需的全部素材。

材料类型：业务文档 | 项目文件 | 聊天记录（需导出）| 会议纪要 | 权限清单 | 联系人信息

1. 用户已提供材料路径 → 直接读取
2. 未提供 → 按维度列出需收集的材料清单
3. 对已收集材料做维度分类
4. 关键材料缺失标注为 `信息缺口`

完成后输出**材料覆盖摘要**，展示每个维度的已收集材料和缺口。

> **检查点**：展示摘要给用户。确认 OK → 进入 Step 3。

### Step 3：知识提炼与结构化

**目标**：从原始材料中提取结构化知识。

**详细操作规则**详见 [`references/extraction-rules.md`](references/extraction-rules.md)。

执行流程：
1. **分类**：判断每份材料的文档类型（SOP/会议纪要/项目文档/联系人/报表/话术/口述/其他）
2. **提取**：按文档类型对应的模板提取关键信息（每种类型有固定的输出格式和字段）
3. **交叉验证**：比对多个材料，标注矛盾（`[矛盾]`）和过期信息（`[可能过期]`/`[可能失效]`）
4. **自检**：确认所有材料已分类、来源已标注、矛盾已处理

From AgenticAIPlan/AgenticAISkills, MIT.

More from AgenticAIPlan/AgenticAISkills