资料库

---
name: project-drive-archive
description: 当要把一个项目的产出物、文档与交接材料整理后归档到项目资料库（WorkBuddy 原生资料库 / Project Drive / netdrive MCP 通道），供团队员工接手继续推进时使用。触发词：归档到资料库、上传资料库、交接文档、项目资料归档、团队交接、把手头的活交给员工、防止线程搞错。覆盖完整流程：线程状态锚点核对 → 交接文档编写 → 写操作确认门 → 上传三件套（file_upload → curl PUT → file_upload_complete）→ 落库验收 → 作废批次管理。同时内置两个高频坑的解法：本机 Python 解释器选择（托管 Python 精简版缺标准库）与中文路径 curl 上传。通用模板，可套用于任何含产出物的项目（短剧/网站/文档/资产图）。与「归档skill」（未完成事项审计交接）互补：本 skill 侧重把已产出物与资料完整归档，归档skill 侧重把未完成事项审计成交接清单。
agent_created: true
version: 1.0.0
---

# 项目资料库交接归档

把项目产出物 + 交接材料归档到项目资料库，供团队接手继续推进。结论先行：**先核对线程状态锚点 → 写交接文档 → 展示方案等确认 → 三件套上传 → 落库验收**。

## 何时使用

- 用户说「把这个项目资料/产出物/交接文档放到资料库，方便团队推进」
- 用户在做项目交接、线程收尾、资料沉淀
- 任何含产出物（文档、图片、视频、代码）的项目要归档到 WorkBuddy 原生资料库 / Project Drive

## 铁律（违反即返工）

1. **写操作必须先确认**：项目资料库属团队空间，任何创建目录/上传/覆盖前，先向用户展示「放哪、传什么、目录结构」并等明确确认，不确认不上传。
2. **只传有效产出**：作废批次（v01、batch01/02 等不合格版）不上传，留本地存档；资料库保持干净。
3. **交接文档是入口**：归档目录第一位放交接文档，团队从它读起，再按索引定位具体文件。
4. **开工先读锚点**：多线程推进同一项目时，先读 `project_state.yaml` / `asset_manifest.yaml` 确认当前阶段与上次进度，防重复开工、防状态打架（见 `references/thread-anchor.md`）。
5. **Python 用系统解释器**：本机托管 Python 是精简版缺标准库，脚本必须用系统 Python312（见 `references/python-env.md`）。

## 标准流程

### Step 1 · 线程状态锚点核对
读项目目录下的 `project_state.yaml`（或等价状态文件），确认：当前阶段、已拍板决策、上次进度、阻塞项。向用户复述「本项目当前到哪、下一步是什么」，确认没走错线程再开工。

### Step 2 · 收集待归档清单
列出要归档的内容并按类型归类：
- 核心文档（SOP、剧本、分析、分镜、manifest、state、交接文档）
- 已验收资产（人物图、场景图、道具图）
- 是否含作废批次（默认不上传，明确询问是否要）

### Step 3 · 编写交接文档
用 `assets/交接文档模板.md` 生成，至少包含：项目概览、已拍板决策、当前进度、产出物索引、下一步行动、操作铁律、环境备注（Python 坑、脚本路径）。交接文档放归档目录第一位。

### Step 4 · 展示方案等确认（写操作确认门）
用 AskUserQuestion 确认两点，缺一不可：
1. **目录位置**：资料库根目录新建交接目录（默认，与其它交接目录同级）还是指定其它位置
2. **上传范围**：只传有效产出（推荐）还是含作废批次
确认后**先创建目录**，再申请上传。

### Step 5 · 上传三件套（逐文件）
每个文件走三步（详见 `references/upload-flow.md`）：
1. **申请**：`mcp__netdrive__tdrive.file_upload`（dir_id + file_name + file_size），拿预签名 URL + 确认凭据
2. **PUT**：`curl -sSL -X PUT` 带 Authorization/token 头，**先 cd 进文件目录用相对文件名**（中文路径 -T 会失败）
3. **落库**：`mcp__netdrive__tdrive.file_upload_complete`（confirm_key + 原参数），才算真正入库

限流时（报错重试类）：**等 5-6 秒再重试落库**，不要立刻重试。

### Step 6 · 落库验收
列目录（dir_list）核对三处：文件数、文件名、目录归属。确认 22 个（或对应数量）文件齐全后，向用户汇报归档结果 + 目录结构 + 团队接手入口。

## 资源索引

- `references/upload-flow.md` — 上传三件套完整实操（含 curl 头、限流重试）
- `references/python-env.md` — 本机 Python 解释器选择（为什么托管 Python 用不了 + 检测命令）
- `references/thread-anchor.md` — 线程状态锚点机制，防跨线程搞错
- `references/naming-sop.md` — 资产/批次命名规范与作废批次管理
- `assets/交接文档模板.md` — 交接文档模板（从安娜短剧实例抽象）
- `scripts/check_python.py` — 一键探测本机可用 Python 解释器

## 完成判定
用户确认了目录位置与上传范围、所有文件已通过 file_upload_complete 落库、目录列表核对无误、已向用户汇报归档结果后，本 skill 完成。未获用户确认前不得创建目录或上传任何文件。