项目交接格式

一句话定位：让接手者读完就能干活，不重复踩坑。

1. 适用场景

• 交接给新的 AI 会话或同事、跨阶段续做、长期项目维护
• 不适用：一次性小任务

2. 硬性规则

1. 先写「环境事实」，且只写验证过的，不写推测。
2. 「已踩的坑」必须写清：现象 → 根因 → 正确做法，禁止重试旧错误。
3. 文件地图给绝对路径与用途，一行一个。
4. 不写密钥、不写一次性临时路径。

3. 输出结构

# {项目} 交接白皮书

> 给接手者：先读完再动手

## 0. 使用约定
## 1. 现状（能跑什么、跑在哪）
## 2. 环境事实（表）
## 3. 已踩的坑（现象/根因/正解）
## 4. 文件地图
## 5. 待办与风险

4. 质量判定

• 合格：接手者能独立复现环境并避开已知坑
• 不合格：给结论不给证据、缺少路径