该技能用于图表设计的品牌配置与客户档案管理。核心机制是:新项目绘制第一张图表前会触发强制样式检查——若项目的 style-guide.md 仍是默认配色(paper #f5f5f5、ink #2d3142、accent #eb6c36),技能会停下来询问用户,提供六个选项:从网站 URL 提取、从已安装技能提取、从本地文件夹或设计系统目录提取、手动粘贴色值、暂时沿用默认、加载已保存的客户档案。完成自定义或选择沿用默认后,该检查不再重复询问。
主要能力
品牌入门(onboarding)支持四种方式:
- 从网站提取,指令为“onboard diagram-design to https://yoursite.com”。流程为下载首页、提取主色板与字体栈、映射到五个语义角色(paper、ink、muted、accent、link),展示建议差异,经用户确认后写入 references/style-guide.md。映射关系包括:body 背景→paper、主文字色→ink、次要文字→muted、卡片容器→paper-2、品牌主色→accent、h1 字体→title、body 字体→node-name、code 字体→sublabel。提取时会自动对 ink 与 paper 执行 WCAG AA 对比度检查,若在 9–12px 字号下不达标会建议校正值并说明原因;同时生成保真收据,记录取样的 URL、各颜色角色、字体族与字重、字体来源 URL 及所有回退方案。
- 从已安装技能提取,指令为“onboard diagram-design from the <技能名> skill”。
- 从本地目录提取,指令为“onboard diagram-design from ./design-system”。
- 手动设置,指令为“set diagram-design tokens: paper #…, ink #…, accent #…”。
用户也可直接编辑 style-guide.md 中的 token 表;其后所有 39 种图表类型、注释原语和图库都按角色名引用颜色。
客户档案管理
档案库位于 ~/.diagram-design/profiles/,每个档案为 <slug>.md。项目根目录的 .diagram-design 标记文件仅一行,格式为 profile: <slug>。标记被视为不可信的仓库数据,只接受该语法;格式错误或指向不存在的档案时技能明确报错,不猜测、不自动修复。有标记的项目直接读取档案,不覆盖已安装的工作副本,因此多个工作区可并行使用不同品牌。
/profile 命令。在 Claude Code 中为 /diagram-design:profile,在 Factory Droid 或 Pi 中为 /profile。无参数时列出档案并按标记或工作副本标出当前活动项;/profile list 列出库;/profile save [name] 保存当前 style-guide 为档案;/profile load [name] 以复制覆盖方式加载档案;/profile switch <name> 与 load 同义;/profile show 查看当前档案;/profile update [name] 更新已有档案;/profile reset 恢复默认;/profile delete [name] 删除档案。未知动词或多余参数时输出合法用法并停止,不写入任何内容。
安全规则:覆盖已有档案、更改项目标记或删除档案前必须确认,即使由脚本调用也不可跳过;标记模式直接读取档案;复制覆盖式加载后需再次验证写入结果,目标不可写时建议改用标记流程;save/update 后需确认仅有一个元数据头且正文未变。命令原文强调:“Never claim a write succeeded without re-reading it.”
多客户使用示例
先执行 mkdir -p ~/.diagram-design/profiles 创建库,然后对每个客户执行 onboard diagram-design to https://client-a.com,再执行 /diagram-design:profile save client-a。最后在各项目仓库执行 echo 'profile: client-a' > /path/to/project-a/.diagram-design,其他客户同理。可用 ls ~/.diagram-design/profiles/ 与 cat /path/to/project-a/.diagram-design 检查。此后 project-a 中生成的图表自动使用 client-a 品牌。
限制与注意事项
全部流程为聊天内操作,除少量 mkdir/cat 命令查看磁盘文件外,没有 CLI 入门工具。档案在插件更新后仍保留,而工作副本 style-guide.md 不会。若样式已自定义但文件头缺少档案元数据(custom-unsaved 状态),技能会跳过检查并提示保存为档案,应接受该提示,因为插件更新可能覆盖工作副本。
完成标准:references/style-guide.md 已非默认 token(或用户有意选择沿用默认);多客户场景下档案库至少有一个 .md 且项目标记语法正确;/diagram-design:profile 能列出并正确标识当前活动档案。