devtreelisted

用户调用此 skill 表示要刷新「可视化」和「节点索引」两个区块（含同步本轮开发项的 Epic 归属）。 --- ## 核心原则：每次都从 Epic 结构完全重建 **「Epic 结构」区块是单一事实来源。「可视化」和「节点索引」每次调用本 skill 时都必须被完全重建，不允许增量修补、不允许从旧图里复制结构。** 执行流程： 1. 读取并解析「Epic 结构」区块 2. **丢弃**现有「可视化」与「节点索引」区块的全部内容（它们是从上次 Epic 结构渲染的过时产物） 3. **只从**当前「Epic 结构」 + 各开发项 SUMMARY.md 重新构造两个区块 4. 整块替换写回 如果旧「节点索引」表里有某开发项的「一句话描述」且该开发项在新 Epic 结构中仍存在，可以复用这一行描述（避免重新读 SUMMARY.md），但层级/归属一律以新 Epic 结构为准。 **例外：冷启动**。当 `docs/DEVTREE.md` 不存在，或文件中没有「Epic 结构」区块，或 Epic 结构区块没���任何叶 Epic 时，本 skill 改为落初始骨架（见下文「第���步」），不报错。只要 Epic 结构非空，仍严格遵循「从 Epic 结构完全重建」原则。 --- ## docs/DEVTREE.md 文件结构 **区块顺序（从上到下）：可视化 → 节点索引 → Epic 结构。** 读者最先看到的是图，其次是索引表，最底下才是作者手写的依赖关系定义 —— 从「结论」到「原料」。 | 顺序 | 区块 | 维护者 | 说明 | | ---- | ------------- | ----------------- | ------------------------------------------ | | 1 | **可视化** | AI 维护 | Mermaid 图 | | 2 | **节点索引** | AI 维护 | 所有开发项的分类与 Epic 归属表 | | 3 | **Epic 结构** | 作者主导，AI 协助 | Markdown 树形列表，定义目标层次 + 轮次归属 | （「可视化」「节点索引」每次从 Epic 结构完全重建，见上「核心原则」。另有「分类图例」小区块在「可视化」之前，作阅读字典。） **Epic 结构是作者主导维护的区块**。AI 按下述策略协助： - **作者已手改入新开发项** → 以作者版本为准、不覆盖，直接渲染。 - **本轮有新开发项但 Epic 结构里没有** → AI 提议追加（往哪个叶 Epic 加 + 理由，或建议新建），等作者确认后写回再渲染。 - **本轮 Epic 结构与现状一致** → 跳过提议，直接渲染。 --- ## Epic 结构规范 作者在「Epic 结构」区块中用 Markdown 标题层级定义目标树： - 非叶 Epic（中间节点）：只有子目标，没有「状态」和「轮次」 - 叶 Epic（最底层目标）：有「状态」和「轮次」字段 - 状态取值：`已完成` / `进行中` / `已放弃` - 轮次：逗号分隔的开发项编号列表 - 同一叶 Epic 内的开发项是**并列关