ContextWeave 绘图请求客户端
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_60157edd/errt。
技能介绍
问题:把绘图请求变成后端能执行的语义
用 LLM 画架构图、流程图、思维导图,失败往往出在请求本身:一句话里带着本地文件路径("参考 /path/to/x")、未释义的缩写、"基于上一张图改"这类悬空引用。后端运行在云端沙盒里,看不到本地文件、会话历史和任何上下文,只接收纯文本。结果要么是"仅列词成框"的空壳图,要么是后端关键词推错图类型。
核心设计:三条不变式
- 解引用一切:本地文件先用工具读出并拍平写入
# Request;术语要补全角色、层级、动作、上下游关系;修改已有图时把现有 CW 文本放进input_file的# CW段,并从上一轮返回的 JSON 中复用session_id。 - 论证而非展示:每条边都必须能复述成明确语句(如 "A 依赖 B"),做同构校验——去掉文字标签后,结构本身仍要能传达核心逻辑。
- 一图一主题:先定抽象层级(宏观骨架 / 中观交互 / 微观逻辑),装不下就拆成 layers 或 scenarios,且拆分前必须先输出方案并阻塞等待用户确认。
工作流程
- 解析需求并拍平所有文件引用。
- 挖掘展示意图:图类型、构图范式、配色不明确时先向用户澄清,再显式传
--diagram_style与--morphology,而不是把风格决策丢给后端关键词猜测。 - 判断单图还是拆分:scenarios 复用同一
session_id做增量覆盖,不复制拼接整份图形。 - 把结构化意图落盘到
.cw_skill/requests/request_*.md,调用generate_contextweave.cjs。 - 按固定 JSON 格式回复,脚本自动落盘
.cw并下载 SVG/HTML。
注意点
- 展示意图只能到语义级:可以说"基础设施用蓝色系""高亮订单链路",但不能承诺具体 hex 值、坐标或字号——布局与渲染归后端引擎。
- 绘图与 Link 注入必须分两步走,禁止合并成一次请求。
- 长耗时场景主动轮询
recompile_contextweave.cjs;彻底失败后引导用户留邮箱,并走submit_feedback.cjs上报。 - 使用内置匿名凭据,不向用户索要 API Key。
使用场景
- 把仓库里散落的设计文档读平,生成一张覆盖模块职责与调用关系的架构图
- 把需求里没解释的术语补全后,画一张论证依赖链路的拓扑图
- 把用户给出的代码片段转换成单主题的可视化逻辑图
- 给已有的流程图加一轮修改,并在同一会话里追加链接属性
适合人员
- 需要把本地代码和文档转成可论证架构图的后端工程师
- 要在白板前解释复杂逻辑、担心图变成词汇堆砌的架构师
- 希望 agent 主动读文件而不是追问路径的技术作者
- 需要在提交前确认拆分方案的系统设计者