light-diagram

1# light-diagram
2 
3## 项目目录与续作
4 
5需要落盘或继续已有项目时，先读 [项目目录约定](references/project-layout.md)，按其中的本阶段位置、版本与关联规则保存；用户指定路径和旧项目优先。包内资源相对本 skill，研究产物相对真实项目，二者不要混用。只做局部讨论时无需初始化目录。
6 
7这是总入口，负责阶段衔接、工具选择和结果验收。四个子 skill 保持独立职责；总入口按需要读取它们的 `SKILL.md`，不要求用户逐个调用。默认目标是科学关系正确、可继续编辑的科研示意图，不承诺 1:1 完美复现。定量数据图使用相应数据绘图流程；混合图中的真实数据面板保留作者素材。
8 
9所有相对路径以本包目录为基准。参考仓库和大图库是可选学习资料，不是执行依赖。
10 
11继续项目、修稿或响应评审时，按需读 [项目证据与修订衔接](references/project-integration.md)：先看有关 Memory，再回原论文、设计、分析及采用的稿图版本核对。记忆用于恢复上下文，图像生成结果用于视觉参考；两者均不替代科学原件。局部请求直接完成，不强制创建完整交接。
12 
13## 先判断从哪里开始
14 
15| 用户已有内容 / 目标 | 进入位置 |
16| --- | --- |
17| 论文、方法、机制说明或构想，需要新图 | 科学 brief → 交付提示词 → 按能力生图 → 参考核查 → 可编辑重建 |
18| 已有生图、论文图或截图，需要编辑文件 | 查看参考 → 关系与来源核查 → 工具选择 → 可编辑重建 |
19| 明确只要提示词 | 调用 prompt 子 skill，交付提示词即完成 |
20| 明确只要生成图片 | 先交付提示词 → 按能力生图 → 图像核查，交付图片即完成 |
21| 宿主不能生图，也未配置可用服务 | 交付完整提示词与核查点，说明可手动生图后继续；本次无需强制配置 |
22| 续做已有项目 | 读取交接记录，核对参考/候选的路径、版本和哈希，从未完成阶段继续 |
23 
24用户已提供清晰参考时不强制重新生图。只有风格参考、没有待画的科学内容时，不能把参考论文的机制直接借给新图。仅有摘要时可以做有边界的概念图，不能补出未读方法细节。
25 
26## 工作流程
27 
28### 1. 建立共同 brief
29 
30读取相关论文内容、方法、图注或用户说明；明确领域、核心图意、必须实体、重要关系与方向、精确标签、画布、真实证据素材和未知项。记录读到的范围，示意构型与实验事实分开。复杂图给重复组件稳定 ID，并列出关键边、物理层位和局部放大来源。
31 
32沿用用户已明确的工具、输出格式和可见绘制偏好。本项目用户希望看见制作，桌面应用可用时默认可见创建；其他使用者仅在请求可见制作时启用相应节奏。先发现可用工具和应用，不能等选定路线后才发现无法运行。
33 
34### 2. 新图先生成视觉参考
35 
36需要新图时读取 [light-diagram-prompt](light-diagram-prompt/SKILL.md)，先产出科学 brief、结构蓝图、完整生图提示词及检查点。**每次生图或编辑前，先在用户可见回复中输出完整提示词，或提供实际提示词文件的可点击链接；无需等待确认，再继续调用。** 工具内部日志和仅写入磁盘不能替代这次交付。只执行所交付的版本，修订后也先交付再执行。
37…