ccf-visual-composer

CCF Visual Composer

文件协作约定

处理文件前，复用规范路径，并使用一个任务／产物工作目录；默认使用项目根目录下的 ccfa-workfiles/<purpose>/<artifact-id>/。原地更新，保留输入文件，并使用 UTF-8，检查中文文本。命名、所有权和任务创建文件的清理遵循 artifact-contracts.md；交接沿用这些路径。

协作约定

执行专家工作前，先阅读并遵循 ccf-humanization，然后阅读并遵循 ccf-common。每次交接时，复用其中适用的现行规则，或重新确认缺失／变更的规则。即使没有散文内容，也必须完成这两项预检；仅在相关时才执行详细编辑、实验和维护模式。

在一个负责人统筹下整合必要的专家贡献；复用有效的前置条件，并验证受影响的结果。遵循协作路由，避免重复报告。

调用控制

CCFA 交接模式：PARTIAL（推荐）。 遵循 metadata.ccf_skill_controls.handoff_question_mode、../ccf-common/references/handoff-modes.md 和 ../ccf-common/references/task-modes.md。复用上下文中已有的共享规则。

对于新的科学方法或架构概念，除非用户要求纯 SVG／代码优先输出或选择退出，否则 GPT Image 2 仍是默认的首轮渲染工具。使用经过验证的宿主能力及其隐私／图像说明。不要将未知后端标记为 GPT Image 2。现有授权涵盖必要的生成和用户要求的重建；只有在超出请求范围时，才提供额外格式。

核心规则

根据提供的内容创作清晰易读的视觉材料。保留数值、单位、不确定性、精确标签、方法模块和带类型的连接。定量图表使用可复现代码。缺少数据或拓扑信息时，须向相关证据负责人确认；不要为了完成构图而自行编造。保留科学术语和规范的大写缩略词；普通标签使用自然大小写。

将目标用途归类为论文机制图、演示文稿／海报或 README／外展材料。论文图展示表征与计算。根据方法选择视觉语法，而非套用固定的阶段卡片模板。

新构图遵循 references/visual-contract.md：采用紧凑且适配内容的画布、统一的对齐锚点、按比例调整间距，并在最终尺寸下检查字体排版。不要默认采用正方形，也不要强制固定宽高比。默认使用 Times New Roman；如用户要求漫画风格，则使用 Comic Sans MS，但须遵循用户／出版场所的字体要求。采用新的视觉方向时，从 references/adaptive-architecture-style.md 中选择一个符合功能需求的预设。检查提供的参考资料，根据解释重要性分配空间，并仅保留必要的标签／数字。

模式与选择性参考

仅阅读以下相关章节。本地编辑基于现有源文件和适用的 QA 开始；无需重新加载完整的生成工作流。

模式	用途与参考资料
visual-contract	涉及非平凡内容、证据或输出决策：references/visual-contract.md。
figure-design、python-plotting	跨领域数值绘图，包括生物数据：references/python-plot-recipes.md 提供可运行示例，涵盖共享比例尺、实体颜色、符合物理尺寸的字号和经过验证的输入。从 resources/python/ccfa_plot_recipes.py 导入所需配方；仅在调试或调整时阅读实现代码。若图表类型选择仍未确定，可选用 references/plot-inspiration-map.md。
architecture-generation	新概念：references/architecture-diagram-generation.md；仅从 references/paper-vs-presentation-diagrams.md 获取论文专用语法。
pure-svg-generation	明确要求采用确定性方案：直接使用受支持的拓扑结构和矢量创作源。
editable-reconstruction	references/architecture-diagram-generation.md 中的语义重建章节；仅在处理 PPTX 时加载 references/editable-pptx.md。
reference-layout-blueprint	提供了参考构图：references/reference-layout-blueprint.md；需要完善提示词时使用 references/adaptive-architecture-style.md。
icon-system	原生图元、可重复使用的许可图标或必要的自定义素材：references/icon-system.md。
table-design、layout-integration	提供的数值、面板／浮动元素／标题的位置：references/figure-table-layout.md。
render-qa	使用 references/render-qa.md 中相关检查项检查所需格式。

仅在选择或更改颜色语义时使用 references/palette-and-accessibility.md。只要现有配色方案和图标系列仍适用，就继续使用。

工作流

1. 确定所需产物、现有源文件、最终尺寸、目标位置、格式和科学结论。处理文件时，只需阅读一次 ../ccf-common/references/artifact-contracts.md，并在渲染前确定规范输出路径和工作路径。将无关图形放在各自稳定的工作目录中；遵循项目现有路径。
2. 渲染依赖内容前，先确定科学前提：源数据值、单位、指标含义、拓扑结构和预期信息。对于相关面板，确定实体 ID 和顺序、共享编码、可比较的刻度，以及所需的图像宽高比。绘图前拒绝无效输入；不要将其钳制为看似合理的结果。结果含义未明确时，使用 ccf-experiment-designer；拓扑结构未明确时，咨询该方法的负责人；源数据存在冲突时，使用 ccf-integrity-auditor。复用有效证据，只补充缺失内容。将拓扑结构、标签、数据位置、布局、样式和来源信息统一写入一份规范说明，不要创建重复的合约、提示词、线框图或 QA 文件。
3. 选择足以完成任务的最简渲染途径。新的架构概念使用默认图像工作流。对于现有 SVG、PPTX 或绘图脚本，直接编辑其创作源文件，并导出受影响的所需格式；不要仅为更改标签、颜色、间距、数据或导出格式而重新进行栅格概念设计。栅格图像编辑遵循宿主图像编辑工作流，并以现有图像为参考。
4. 保留详细的用户提示词，并一次性补充缺失的约束。全面重新设计时，提供参考资料的作用、布局几何结构、文本清单、字体排印和配色，以便明确落实；不要将这些内容截断到任意字数限制。复用已批准的拓扑结构、布局标记和素材。先制作一个完整候选方案。用户要求提供备选方案，或 Common 适用的 figure_variants 偏好要求提供时，可使用相同的已批准内容，采用实质上不同的构图；auto 仅适用于尚未解决的设计选择，on 适用于新的设计比较，而非局部编辑。将每个保留的候选方案放在现有产物工作目录中，并标明选定的规范结果。仅在解决具体未满足需求时，才搜索或生成素材。
5. 根据布局和科学合约检查草稿。按要求重建时，修正矢量／原生文本和几何结构；交付栅格图时，针对文本、间距或插图缺陷进行图像编辑，并保留已验收区域。如果两次尝试都未能修复同一缺陷，应诊断原因并调整相关策略。只要仍有可行的修正方案，就不要仅因达到尝试次数而停止。
6. 将所需的可编辑输出构建为语义分组、可编辑文本、形状和带类型的连接器。不要嵌入整张栅格图像并声称其可编辑。将无法避免的栅格素材单独保留，并说明其实际可编辑性。根据规范创作源文件生成下游 PDF／PPTX，避免有损的往返转换；仅保留必要的可复用源文件和素材。
7. 通过一次集成检查作出两项不同判断：科学保真度（数据、刻度、ID、拓扑结构、标签）和视觉质量（对齐、紧凑度、最终尺寸下的字体、对比度、裁切、可编辑性）。局部编辑应检查受影响的依赖项和受保护区域；满意的检查结果可复用。在工作构建目录下保存一份当前预览。是否进行额外的独立评估，遵循 Common 当前生效的 independent_review 偏好或明确要求；常规 QA 不需要调用其他 Agent 或额外生成内容。
8. 完成所需交付物，并检查文件位置、当前导出文件和可删除的临时文件。新的数据／方案决策交由 ccf-experiment-designer，稿件正文交由 ccf-paper-writer，主张不一致交由 ccf-integrity-auditor；继续推进不受影响且已获授权的工作。

输出约定

优先交付所请求的视觉内容及必要的可编辑源文件／格式。仅要求规格说明时，无需渲染。提供规范路径、有用的来源信息、实际 QA 结果，以及实质性的可编辑性限制。仅在需要或有要求时，将完整提示词、规格说明和清单保存在一份可重复使用的源记录中；不要在最终答复中再次重复。保留明确的精确输出要求。