SuperAPI AI 工具集

illustrate

设计与创作

查看项目

更新于 10-16 07:47

技能介绍

用途

Illustrate 是绘图流程的统一入口:/illustrate <idea>。它按顺序运行三个引擎并报告结果。它自身不持有规则——简报、绘制约束和检查清单分别位于 diagram-brief、mermaid-draw / illustration-draw 和 diagram-review 中。

运行环境与前置条件

该技能在分叉的子代理中运行,因此 $ARGUMENTS 必须携带全部内容:想法、已知的目标位置、个人观点以及任何文件路径。

如果此处缺少某个技能,请先安装全部技能:

npx skills add Paldom/diagram-skills

步骤

1. 简报(Brief)

对 $ARGUMENTS 运行 diagram-brief。如果输入只是一个标题,让它声明假设,而不是停滞。它写入 diagram-design/<slug>/brief.md;将该路径显式传递给下一步——绝不要让绘制技能默认拾取更早的简报。

2. 绘制(Draw)

使用简报路径运行路由后的技能——Markdown 目标用 mermaid-draw,feed、文章、幻灯片用 illustration-draw。该技能拥有整个变更预算(三次修复,含重新生成)和评审(一次通过,在 FIX 或 REDRAW 后最多一次复查,且始终跟随全新的 lint 和渲染)。不要在此处再次评审。

一并传入设计系统(--design-system path 来自简报,否则使用 $DIAGRAM_DESIGN_SYSTEM 或 ./design-system.md 解析结果)。如果路由是交接(/design、FigJam、drawio-skill、archify、diagram-design),则输出简报和设计系统路径,并附带路由器中的交接指令,然后停止。

3. 动画(Animate)

仅当简报的 Motion 行或 $ARGUMENTS 要求 GIF、视频或动画时才执行:对已评审的 SVG 运行 diagram-animate(宽幅从左到右的图表走 pipeline,否则走 reveal),并查看其帧。在它一次性的 --allow-install 之前先询问。

报告

在一个块中报告:要点和假设、制品路径(源文件、SVG、PNG、若做动画则为 GIF/MP4)、使用的设计系统、评审结论及残留发现,以及被省略的内容。绝不 commit 或 push。

从其他 harness 或其他模型运行

同一流水线可通过 acpx(Agent Client Protocol CLI;全局标志放在代理名称之前)以无头模式运行。将请求写入文件并用 -f 传递——绝不要把用户文本拼接进带引号的 shell 字符串。在一个一次性目录中运行:非交互式会话无法提示权限,因此写入需要 --allow-all,这仅在没有任何可损坏内容时才能接受。

mkdir -p /tmp/illustrate && cd /tmp/illustrate
printf '%s\n' '/illustrate <idea, destination, take>' > ask.md
acpx --approve-all --timeout 1200 claude exec -f ask.md

离开机器的内容:请求、会话在该目录中读取的文件,以及适配器自行附加的任何内容(其会话元数据;如果在仓库内运行则为项目上下文,这也是该目录为空的原因)。

注意事项

  • 分叉不会继承对话。先前说过但不在 $ARGUMENTS 中的内容在此次运行中不存在。
  • 每个请求只有一个控制器:此技能负责编排;绘制技能在其预算内变更和评审;此处不重新打开循环。
  • 交接是有效结果,而非失败——请明确说明。