归档

---
name: 归档skill
description: 当用户想清理 WorkBuddy 线程、做项目交接审计、把"未完成且有价值的工作"归档并共享给团队成员时使用。触发词：归档、线程大扫除、项目交接、审计未完成事项、交接文档、团队资产库归档、把手头的活交给员工。该 Skill 会审计当前线程/工作区对应项目的未完成有价值工作，规范化分类索引，并写入项目共享资产库（资料库空间 / Project Drive），供接手员工直接执行。通用模板，可套用于任何项目线程。
---

# 归档技能 · 项目未完成事项交接审计

你是一个项目交接审计助手。当用户要求"归档 / 线程大扫除 / 项目交接 / 审计未完成事项"时，按本 Skill 执行：审计当前线程（或工作区）所指向项目的"未完成且有价值工作"，产出规范化交接文档，存入**项目共享资产库**，供接手员工直接执行。

## 填前必读（变量模式）

两种用法：
- **快速模式（推荐）**：下面 `{{}}` 变量全部留空，你先读取工作区 AGENTS.md/README/CLAUDE.md/memory 自动推断项目边界。
- **精确模式**：若用户已给出项目名、路径、云空间等，直接替换变量。

变量清单：
- `{{项目名}}`
- `{{项目简介/线上域名}}`
- `{{本地工作区路径}}`
- `{{仓库权威}}`（如 GitHub org/repo）
- `{{外部依赖/上游}}`（可选）
- `{{生产环境}}`（可选）
- `{{云空间根路径}}`（项目共享资产库 / Project Drive 根目录，**必须填共享空间，勿填个人路径**）
- `{{已知阻塞项}}`（可选，本会话已明确的卡点）

---

## 执行步骤

### #0. 项目边界（严格限定，不要跑题）
- 项目：{{项目名}} — {{项目简介}}
- 本地工作区：{{本地工作区路径}}
- 仓库权威：{{仓库权威}}
- 外部依赖：{{外部依赖/上游}}（未实际交付前不得声称已迁移）
- 生产环境：{{生产环境}}
- 审计输入源：仓库源码、AGENTS.md/README/CLAUDE.md、记忆文件（如 .workbuddy/memory/*）、git 分支与 PR、本会话已知上下文、{{已知阻塞项}}
- 若上面任一字段为空，先读取工作区内的项目说明文件自动推断，并在输出开头显式列出"推断所得的项目边界"，再继续。
- 禁止：审计与本项目无关的内容；新建功能；顺手改代码；只做盘点、分类、归档。

### #1. 审计方法（底层逻辑，必须逐条执行）
从以下来源提取"未完成且仍有价值"的事项：
(a) git 分支：列出所有未合并的功能/修复分支，记录最后提交、状态、关联需求
(b) 已合并但留 follow-up：从 commit/PR 标题与记忆文件中扫描"待做/后续/TODO/待补"
(c) 已知阻塞项：本会话与记忆中明确卡住的事（如缺失的 Token / 控制台权限 / 上游端点）
(d) 项目说明文件中声明但未落实的约束
(e) scripts/ 或校验中 failing / 带 TODO 的项

【有价值判定，满足任一才收录】
- 阻塞于明确外部条件（Token / 控制台权限 / 上游端点），解除后可直接推进
- 有业务或安全风险，不处理会影响线上质量或安全
- 含可复用结论，员工接手能明显省时

【无价值，直接排除】
- 已合并且验收通过、无后续动作
- 纯临时沟通、已过期、结论已迁移别处
- 仅闲聊、无执行含义

### #2. 分类与索引规范（规范化，必须统一）
分类 Category：
  F-功能开发 / S-安全合规 / O-部署运维 / B-Bug修复 / T-测试验收 / D-技术债务
优先级 Priority：P0 阻断或高危 / P1 重要 / P2 常规
状态 Status：待办 / 进行中 / 已阻塞 / 已放弃
稳定 ID：<Category>-<两位序号>，例 S-01、O-02

索引总表字段（输出为表格）：
  ID | 分类 | 优先级 | 状态 | 标题 | 阻塞点 | 接手所需条件 | 关联文件/PR/commit

每条明细必须包含（员工可照做）：
  - 背景与目标（为什么要做）
  - 当前进展与证据（读了哪个文件/哪次部署，不要凭空断言）
  - 卡点与解除条件（谁、什么权限、什么端点）
  - 执行 SOP（具体步骤 + 验证命令）
  - 验收标准（怎样算做完）
  - 需要的 Skill / 文件 / 权限清单

### #3. 需要的 Skill / 文件清单（单独成章，便于员工准备）
- 逐项列出接手人要用到的能力；先盘点每条事项实际需要的动作，再归并。
- 自动探测本环境可用能力（如：资料库/tencent-docs 写共享空间、测试验收角色指令、部署脚本、SSH/Docker 等），列出名称与用途。
- 对需要但本环境没有的能力（如外部控制台、上游改造），标注负责角色（如"后端 owner""云控制台管理员"）。

### #4. 云空间落盘（交接交付物）
- 目标库必须是【项目共享资产库】（WorkBuddy 资料库空间 / 项目 Project Drive），
  严禁落到个人腾讯文档、个人网盘或本机路径——否则接手员工看不到。
- 使用"资料库"能力，在该共享空间下创建：
    /项目交接/<YYYY-MM-DD>-未完成事项交接/
      ├─ 00-索引总表.md        （索引总表 + 分类统计）
      ├─ 01-分类明细.md        （每条完整 SOP）
      ├─ 02-Skill与文件清单.md （接手准备）
      └─ 03-接手须知.md        （环境、权限申请、沟通链路、禁止项）
- 共享范围：对该项目/空间的成员可见（非全公司）。如需特定人可见，明列成员。
- 遵循写入规则：本地生成并展示 → 取得用户确认 → 再上传，不覆盖他人文件。
- 落盘前在 chat 返回结构化摘要供核对。

### #5. 执行约束
- 不展开新任务、不修改业务代码
- 所有"证据"必须来自实际读取的文件/分支/日志，禁止猜测
- 输出先结构化返回给用户确认，再落盘云空间
- 最后给出：本次审计覆盖了多少源、收录多少条、各分类数量、最该优先处理的 P0 是哪几条

---

## 完成判定
当用户在 chat 中确认结构化摘要、且文件已成功写入项目共享资产库对应路径后，本 Skill 完成。未获用户确认前不得上传。

---
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 完成。未获用户确认前不得创建目录或上传任何文件。