📝 任务完成后归档

**重要提醒**：每次完成复杂调试或开发任务后，务必主动执行此流程！将所学经验归档为技能，以备日后参考。切勿等待用户提醒！

SKILL.md

--- frontmatter

name: 📝 任务完成后归档
description: |
  **重要提醒**: 每次完成复杂调试或开发任务后，主动执行此流程！
  将学到的经验归档为 skill，供以后参考。不要等用户提醒。

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

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

应用场景

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

归档流程

1. 识别直接原因

code

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

2. 分析根本原因

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

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

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

情况	是否归档
通用算法/公式（可复用于其他项目）	✅ 归档
特定框架/库的陷阱和解决方案	✅ 归档
具体项目的代码组织问题	❌ 不归档
简单的拼写错误或配置问题	❌ 不归档

4. 创建/更新 Skill 文件

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

markdown

---
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（可选）

提醒

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

•这个问题有通用价值吗？

•以后可能再遇到类似问题吗？

•如果是，立即归档！