diff --git a/.workbuddy/skills/zhuyuan-experience/SKILL.md b/.workbuddy/skills/zhuyuan-experience/SKILL.md new file mode 100644 index 0000000..4540c4e --- /dev/null +++ b/.workbuddy/skills/zhuyuan-experience/SKILL.md @@ -0,0 +1,125 @@ +--- +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步怎么跑通的」 +- 坑必须记录根因——不是「改了就好了」,是「为什么会出错」 +- 关键参数写死——下次直接用,不需要重新试参数 +- 写完永远推送。不留在本地。