交接

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

---
name: ai-video-champion-handoff
description: name: ai-video-champion-handoff
---

---
name: ai-video-champion-handoff
description: AI 短剧五冠军的总控说明与统一交接契约。用户需要判断当前该用哪位冠军、五个冠军分别做什么、何时接手、交付什么，或需要在冠军之间交接项目、资产和连续性事实时使用；下级 Skill 只能在用户明确批准后调用。
---

# AI 短剧冠军 Skill 统一交接契约

这是一份共享数据契约，不负责写剧本、生成资产或调用模型。五个冠军 Skill 构成唯一正式生产链，必须读取并遵守本文件；稳定字段名保留为机器接口，用户可见标签必须使用中文。

## 四个权威交接对象

### `project_state`（项目状态）

每次交接都必须携带同一个对象，不得另起一套“当前状态”字段：

```yaml
project_state:
  project_id: "稳定项目编号"
  title: "项目名称"
  source_version: "剧本或上游材料版本"
  stage: "剧本|资产|拆镜|导演提示|生成|剪辑|交付"
  approved_gates: ["已确认的阶段"]
  decisions: ["创作者已拍板的事实"]
  blockers: ["阻塞项；没有则为空数组"]
  next_action: "唯一下一动作"
```

### `asset_manifest`（资产清单）

资产只能用稳定 `asset_id` 交接，禁止用文件名或聊天顺序代替：

```yaml
asset_manifest:
  - asset_id: "稳定资产编号"
    category: "角色|状态|场景|道具|参考图|音频|视频"
    name: "用户可读名称"
    version: "资产版本"
    source: "上传|念念画布生成|外部导入"
    status: "候选|待确认|已确认|淘汰"
    dependencies: ["依赖的 asset_id"]
    approved_by_user: false
```

### `continuity_ledger`（连续性台账）

只记录已确认事实；每条锁定必须能定位到场次或镜头：

```yaml
continuity_ledger:
  - lock_id: "稳定锁定编号"
    scope: "场次或镜头编号"
    characters: ["asset_id"]
    wardrobe_state: "服装、妆发、伤口、年龄状态"
    prop_state: "道具位置、朝向、损坏状态"
    spatial_state: "人物、镜头、地标的相对位置"
    lighting_state: "光源方向、色温、反差"
    camera_state: "轴线、焦段、运动方向"
    audio_state: "对白、环境声、音乐连续性"
    source: "用户确认|已验收片段|剧本事实"
```

### `accepted_clip`（已验收片段）

只有用户确认或质量门通过后才能写入；生成任务刚完成时仍是候选片段：

```yaml
accepted_clip:
  clip_id: "稳定片段编号"
  shot_id: "镜头编号"
  task_id: "念念画布任务编号"
  asset_id: "注册到资产库的视频资产编号"
  duration_seconds: 15
  status: "候选|已验收|返工|淘汰"
  acceptance_note: "验收结论"
  rejection_reason: "返工原因；已验收时为空"
  parent_clip_id: "替换片段编号；没有则为空"
  continuity_snapshot: "写入片段时的连续性台账版本"
```

### `canvas_group_contract`（念念画布分组与连接合同）

念念画布只允许使用系统默认的五个顶层分组：`分镜`、`角色`、`场景`、`道具`、`声音`。项目分类、集数、镜头组和视频段只能作为这五组下的子组，不得新建自定义顶层分组。

```yaml
canvas_group_contract:
  top_level_groups: ["分镜", "角色", "场景", "道具", "声音"]
  custom_top_level_groups: false
  shot_subgroups:
    - group_id: "分镜/第1集/镜头组1"
      shot_ids: ["镜头编号"]
      video_node_ids: ["视频节点编号"]
      referenced_assets:
        - asset_id: "稳定资产编号"
          role: "首帧|角色|场景|道具|声音|参考"
          source_group: "角色|场景|道具|声音"
          linked: true
```

角色、场景、道具和声音资产保留在各自默认分组；凡被视频生产消费的资产，必须同时挂接到对应的`分镜`子组，并与视频节点、镜头编号和参考职责建立可回读的连接。画布不支持多父级时使用连接关系或资产引用，不重复上传制造第二份资产。缺少任一必需连接时，生产节点保持未就绪，不得提交视频任务。

## 任务选人

| 用户现在要解决什么 | 该用的冠军 | 交付到哪里 |
|---|---|---|
| “这些小说、参考图、导演资料里哪些规则能用？” | `knowledge-card-skill` | `knowledge_brief`，交给后续冠军 |
| “把创意/小说变成能拍的剧本，或改人物、结构、对白。” | `screenwriter` | 剧本、故事圣经、`project_state` |
| “剧本定了，确定导演基调、人物长相和关键道具。” | `chaoge-assets-trial` | 创作基准、角色/道具和 `asset_manifest` |
| “按剧本和资产逐镜头拍，决定机位、走位和镜头节奏。” | `shotlist-builder` | `shotlist`、连续性草案 |
| “提示词效果不稳，角色表演、物理、镜头或连续性要修。” | `hell-grind` | 最终提示词、锁定后的 `continuity_ledger` |

不要为了“看起来完整”跳过上游：没有资料事实先用知识卡；没有可拍剧本先用编剧；没有已确认角色与关键道具不拆镜；没有拆镜事实不做提示质控。

## 五个 Skill 的职责边界与交接

| Skill | 只负责 | 必须读取 | 必须输出 |
|---|---|---|---|
| `knowledge-card-skill` | 按需检索用户提供的资料，形成有来源的知识简报 | 当前任务与已确认事实 | `knowledge_brief`；不改写项目、资产或连续性事实 |
| `screenwriter` | 故事、人物、场次、对白和可拍摄剧本 | `project_state`、适用的 `knowledge_brief` | 更新后的 `project_state`、剧本、故事圣经 |
| `chaoge-assets-trial` | 角色/状态/关键道具参考资产 | `project_state`、剧本 | 更新后的 `project_state`、`asset_manifest` |
| `shotlist-builder` | 场次拆镜、空间走位、镜头和视频提示计划 | `project_state`、剧本、`asset_manifest` | 更新后的 `project_state`、`shotlist`、待写入的 `continuity_ledger` |
| `hell-grind` | 表演微动作、镜头运动、物理与提示质量控制 | `project_state`、`shotlist`、`asset_manifest`、`continuity_ledger` | 更新后的 `project_state`、最终图像/视频提示、锁定后的 `continuity_ledger` |

生成和剪辑节点还必须读入 `continuity_ledger`，并在任务完成后产生候选 `accepted_clip`；未验收片段不得反向成为连续性事实。

## 统一交接规则

1. 不复制字段：下游只引用上游对象，更新时保留未改变字段。
2. 不静默猜测：缺少 `project_id`、`asset_id`、版本或用户确认状态时暂停并指出缺口。
3. 不越权生成：五个冠军只编译计划和提示；图片/视频必须提交到念念画布任务链，由服务器登记任务、状态和资产。
4. 不丢失失败信息：`blockers`、`rejection_reason` 和返工版本必须保留。
5. 用户看到的阶段名、按钮、表格列、交付说明全部用中文；`project_state` 等稳定机器字段、模型名、文件扩展名和代码标识不翻译。
6. 正式链路外的 15 个下级 Skill 均为 `approval_required`：在读取或调用任一项之前，先向用户说明具体 Skill、用途和本次原因，等待明确批准；不得由总路由自动分派。
7. 进入念念画布生成前，必须先验证 `canvas_group_contract`：只存在五个默认顶层分组、视频素材已归入分镜子组、视频节点与镜头及全部参考资产均已连接；否则停在画布准备门，不把“已上传”当作“已连接”。

## 完整链路

```text
剧本输入
→ knowledge-card-skill
→ screenwriter
→ chaoge-assets-trial
→ shotlist-builder
→ hell-grind
→ 念念画布图像/视频生成任务
→ 候选片段
→ 连续性与质量验收
→ accepted_clip
→ 剪辑、声音、字幕、导出与交付
```