📝 任务完成后归档 (Post-Work Analysis)

🔔 触发条件: 当你刚完成一个涉及调试、研究、或多次迭代的任务时，主动执行此流程！

应用场景

• ✅ 解决了非平凡的 bug
• ✅ 通过调查发现了根本原因
• ✅ 解决方案涉及多次尝试
• ✅ 知识对未来类似问题有价值

归档流程

1. 识别直接原因

直接原因: [一句话描述]
例: "边界检测使用模型中心点而非可见区域，导致放大后只能看到腿"

2. 分析根本原因

深入思考 - 为什么会存在这个问题？

• 设计缺陷: 架构问题？
• 工具/平台限制: 已知 bug？缺失功能？
• 人为因素: 开发中常见错误？
• 文档缺失: 文档不清晰？

3. 判断是否值得归档为 Skill

4. 创建/更新 Skill 文件

路径: .agent/skills/<topic>/SKILL.md

---
name: [skill-name]
description: [简要描述这个 skill 涵盖的内容]
---

# [标题]

## 症状
- [可观察的问题 1]
- [可观察的问题 2]

## 根本原因
### 原因 1: [名称]
- **问题**: [描述]
- **为什么发生**: [根因分析]
- **诊断方法**: [如何确认]
- **解决方案**: [如何修复]

## 代码解决方案
[可复用的代码片段和公式]

## 关键经验
- [要点]

5. 向用户汇报

• 修复了什么
• 根因总结
• 知识归档位置
• 遗留问题（如有）

归档示例

示例 1: VRM 物理调试

• 直接原因: 头部碰撞体过大
• 根因: 模型缩放不一致、Unity 导出 bug
• 归档: .agent/skills/vrm-physics/SKILL.md

示例 2: 3D 拖拽交互

• 直接原因: 使用固定 panSpeed 导致缩放后移动不同步
• 根因: 未考虑相机距离对像素→世界空间映射的影响
• 归档: .agent/skills/3d-interaction/SKILL.md（可选）

提醒

🚨 不要等用户提醒！ 每次完成复杂任务后，主动问自己：

1. 这个问题有通用价值吗？
2. 以后可能再遇到类似问题吗？
3. 如果是，立即归档！