---
name: zhuyuan-experience
description: |
  铸渊项目经验封装技能包。
  每跑通一个环节（第一个视频出来、第一次部署成功、第一次拼接跑通、
  第一次API调通），立即触发封装。把成功路径、踩过的坑、关键参数
  保存为可复用的经验条目，注册到项目经验注册表。
  下次恢复项目进度时，自动加载经验库，不需要重新踩坑。
  触发词：封装经验、保存经验、这个经验存一下、成功了记录下来、
  跑通了、封装成技能、别下次又忘了。
agent_created: true
---

# 铸渊项目经验封装 · zhuyuan-experience

## 触发机制

**当铸渊完成如下任一里程碑时，自动触发封装：**

- 第一个功能跑通（第一个视频生成成功、第一次API调用成功、第一次部署验证通过）
- 踩坑后修复成功（bug修复 → 验证通过）
- 一个完整链路确认可行（从A到B到C全通）
- 冰朔说「把这个经验保存下来」「封装成技能」「别下次又忘了」

**主动触发信号（铸渊自行判断）：**
- 刚才跑通了一个之前没有成功过的东西
- 回头看对话，发现踩了2个以上的坑才修好
- 感觉「这个下次又要重新找」

触发时：在完成当前任务后，自动生成经验条目。

## 经验条目格式

```yaml
# 经验条目 · 零点图书域编号
id: ZP-REG-001/ICE/ZY/EXP/XXX
type: experience
project: 项目名
milestone: 跑通了什么
date: YYYY-MM-DD
d_number: Dxxx

success_path:
  - step_1: 做了什么 → 结果
  - step_2: 做了什么 → 结果
  - ...

pits:  # 踩过的坑
  - pit: 坑的描述
    symptom: 什么现象
    root_cause: 根因
    fix: 怎么修的

key_params:  # 关键参数
  param_name: value  # 下次直接用，不需要重新试

tools_used:  # 用到的工具链
  - 工具名: 调用方式
```

## 存放位置

### 项目经验注册表
```
brain/dev-registry/
  ZY-PROJ-XXX/
    experience/
      EXP-001-first-video.md    ← 第一个视频经验
      EXP-002-stitch-fix.md     ← 拼接修复经验
      EXP-003-deploy-verify.md  ← 部署验证经验
      experience-registry.json  ← 经验索引（自动更新）
```

### 全局经验库
```
brain/fifth-domain/zero-point/zhuyuan/experience/
  INDEX.hdlp               ← 经验库总索引
  seedance-video/           ← 按工具/平台分类
  ffmpeg-stitch/
  gatekeeper-deploy/
  tencent-docs-write/
```

## 工作流

### 场景一：项目开发中跑通一个环节

```
铸渊刚跑通：第一个5秒视频生成成功
  ↓
1. 检查经验注册表 → 是否有重复经验
2. 生成经验条目 → 完整路径 + 所有踩过的坑
3. 写入项目经验目录 → 更新 experience-registry.json
4. 如果经验通用 → 同步写入全局经验库
5. 推送到新加坡 → 完成
```

### 场景二：恢复项目进度

```
冰朔说「继续做短剧视频项目」
  ↓
1. 自动加载 zhuyuan-experience → 查项目经验注册表
2. 列出所有已保存的经验 → 装进当前上下文
3. 以最后一次成功经验为起点 → 继续推进
```

### 场景三：冰朔主动提醒

```
冰朔「别下次又忘了，把这个封装起来」
  ↓
1. 扫描当前对话 → 提取所有成功/失败节点
2. 生成完整经验条目
3. 推送到新加坡
4. 报告：已存储 + 编号
```

## 注意事项

- 经验条目编号纳入零点图书域体系：ZP-REG-001/ICE/ZY/EXP/XXX
- 每条经验必须包含完整路径——不是「跑通了」，是「从第1步到第N步怎么跑通的」
- 坑必须记录根因——不是「改了就好了」，是「为什么会出错」
- 关键参数写死——下次直接用，不需要重新试参数
- 写完永远推送。不留在本地。
