架构图一键生成

解决的问题

在软件架构设计中，快速生成清晰的架构图是团队协作的关键。手动绘制不仅耗时，还容易忽略细节；而现有工具往往要求用户处理复杂的图形界面或脚本，增加了认知负担。ContextWeave 技能旨在解决这一问题，通过自然语言描述自动生成架构图，让开发者能专注于设计逻辑本身，减少工具带来的额外开销。

如何工作

技能基于三条核心不变式运作：

• 解引用一切：确保所有引用（如文件路径、专有名词）被显式转化为纯文本，因为云端后端无法访问本地环境。例如，若用户提到“参考 /path/to/file”，必须先读取文件内容并拍平为纯文本写入请求。
• 论证而非展示：图结构必须服务于逻辑论证，每条关系都可复述为明确语句，例如“组件A依赖组件B”，禁止用位置近似替代关系定义。
• 一图一主题：每个图只回答一个核心问题，避免在单一视图中堆砌过多细节，复杂需求时触发多视图处理。

具体执行分为六步：

1. 解析材料：识别用户需求中的核心问题和焦点，只读取相关文件并补全上下文。
2. 写出一句话重点：明确图要表达的主题，如“展示订单处理流程中的组件交互”。
3. 确定呈现方式与配色：使用参数如 --diagram_style（topology、logic、hybrid、mindmap）和 --morphology（container、flow、editorial）来设置。
4. 写入请求文件：创建 .cw_skill/requests/request_.md 文件，包含自包含的绘图意图。
5. 执行脚本：调用本地脚本与云端后端交互，脚本保存 .cw 并下载 SVG/HTML 产物。
6. 按固定格式回复：返回 JSON 对象，包含字段如 script、input_file、status 等。

关键参数包括：

• --diagram_style：决定图是关注组件关系（topology）、步骤流程（logic）、混合（hybrid）还是思维导图（mindmap）。
• --morphology：控制构图范式，如区域分组（container）、流向强调（flow）或文字说明（editorial）。
• --base_palette 和 --accent_targets：用于设置整体配色和局部高亮。

注意事项

技能有明确的边界和使用限制：

• 必须解引用：本地文件内容需先读取并拍平为纯文本，不能直接引用路径；专有名词需补全最小信息集（角色、层级、动作、上下游）。
• 支持图表类型：适用于架构图、流程图、思维导图等，但不支持精确像素级布局、手绘插画或复杂统计图表（如复杂折线图）。
• 安全与授权：首次联网前需简要说明数据类别和用途并获得同意；数据仅发送到官方服务 https://pptx.chenxitech.site，禁止遍历用户目录或要求 API Key。
• 多视图处理：当单图无法容纳时（如需展示全局、模块和细节），必须触发多视图判断并确认，不能擅自拆分。
• 反模式规避：避免如术语未释义直接出图、用元素靠近表示关系等错误做法，确保结构服务于逻辑论证。

通过遵循这些规则，技能能高效生成结构化图，帮助团队可视化复杂系统，但需注意其适用范围以避免滥用。