
如何把 Diagram Design 从独立 npx skills add 安装迁移到 Codex 市场安装【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design如果你的 Diagram Design 是用独立命令npx skills add装进 Codex 环境的这份拷贝和官方 Codex marketplace 安装是两个互不相干的来源。README 在 Install 一节的迁移说明中直接指出既有的独立npx skills add拷贝不会自动开始跟随 Codex marketplace需要一次性手动迁移。迁移完成后后续的版本更新marketplace version bumps会走 Codex 的原生更新路径不再需要重新安装。独立拷贝为什么不会自动跟着市场走README 原文文档示例One-time migration:an existing standalonenpx skills addcopy will not start following the Codex marketplace automatically. Remove that standalone copy, then use the Codex marketplace commands above. … Future marketplace version bumps then flow through each clients native update path.由此可以确定三件事迁移是一次性操作删除旧拷贝 走 marketplace 两条命令不做迁移的话Codex 侧不会把独立拷贝纳入 marketplace 的刷新流程迁移后升级由 Codex 自身负责这是本次迁移要换到的核心收益。删除独立拷贝前确认品牌 token 不丢这一步只在你做过品牌 onboarding 时才关键。已存为命名 profile的品牌样式存放在~/.diagram-design/profiles/在插件安装目录之外。README 明确说明 saved profiles 在更新后仍然保留带.diagram-designmarker 的项目不受影响profiles.md 也要求 profile 永远不要放进已安装的插件目录因为those directories may be replaced during updates。反过来如果你只是直接改过安装目录里的references/style-guide.mdworking copyREADME 提醒过这类改动may be replaced by package updates——独立拷贝一旦删除这份未保存的定制就随之消失。所以如果定制只存在于安装目录内的 style guide 而没有存成命名 profile在删除前先让 agent 把当前样式保存为一个命名 profile保存流程与项目 marker 规则见 profiles.md。已经存了 profile 或项目带profile: slugmarker 的迁移不需要动它们。迁移步骤1. 删除独立的 npx skills add 拷贝按 README 的指示执行Remove that standalone copy。副作用说明这一步删除的是npx skills add在你本机安装的那份 skill 文件~/.diagram-design/profiles/profile 库和各项目根目录的.diagram-designmarker 与插件安装目录相互独立不受影响。2. 添加 Codex marketplace 并安装插件codex plugin marketplace add cathrynlavery/diagram-design codex plugin add diagram-designdiagram-design3. 立即刷新可选并开启新会话Codex 在启动时会刷新已配置的 Git marketplace。如果想立刻拉到最新运行codex plugin marketplace upgrade diagram-design然后 start a new session。不执行这条 upgrade 也没关系新会话启动时 Codex 同样会刷新 marketplace。验证迁移已生效跑一次内置 doctor 诊断doctor 是只读诊断不安装依赖、不修改文件、不做破坏性 git 操作在任意项目目录下运行都正常它从已解析的安装位置而不是当前工作目录定位 Diagram Design。在 Codex 会话里用自然语言请求即可例如run the Diagram Design doctor它的行为契约定义在 doctor 参考命令入口是 commands/doctor.md。输出契约固定为三部分摘要行Doctor summary: PASS|WARN|FAIL (pass pass, warn warn, fail fail)每个检查一行[PASS]/[WARN]/[FAIL]仅当存在 warn/fail 时输出Next actions段必查项包括Python 解释器要求 ≥ 3.10、Playwright 是否可用PNG 导出依赖缺失时标warn并给出精确的修复提示pip install playwright playwright install chromiumdoctor 本身从不自动安装、以及解析出的安装根目录下SKILL.md是否存在——解析不到SKILL.md时文档给出的建议是重装或更新 Diagram Design。文档给出的示例输出仅示例不是固定预期值Doctor summary: WARN (6 pass, 2 warn, 0 fail) [PASS] Python 3.11.9 found at /usr/bin/python3 [WARN] Playwright package not found in active interpreter [PASS] scripts/verify-drawio-import.py present ... Next actions - Install PNG export dependencies: pip install playwright playwright install chromium - Re-run: /diagram-design:doctor --strict生成一张图并跑 self-check按 README Quickstart 的例子在 Codex 里直接提请求例如Make me an architecture diagram of my app: frontend, backend, database, Redis cache.agent 应选定类型并产出一个自包含的.html文件。然后在已安装 skill 目录下对该文件运行file换成生成文件的路径python3 scripts/self_check.py fileREADME 的 Its working if… 一节把对生成文件打印OK列为工作正常的标准之一从仓库 checkout 运行时对应路径是python3 skills/diagram-design/scripts/self_check.py file脚本本体见 self_check.py。检查加载行为README 还给出了两条可以肉眼验证的标准常规请求如 make me a flowchart时agent 只加载SKILL.md加且仅加一个类型 reference渲染前 agent 先说明选定的类型、尺寸预设和将被裁掉的内容再出图产物是一个双击即可离线打开的单文件.html。边界与限制本文只覆盖 Codex 客户端。README 同一段迁移说明里还要求如果你有个人 Claude Cowork 拷贝需卸载后从组织 marketplace 重装——那是另一客户端的独立操作不影响这里的路径。安装目录内references/style-guide.md的直接改动不会跨 marketplace 更新保留README 原文may be replaced by package updates长期个性化应落在命名 profile 或项目 marker 上。迁移完成后若上游已合并新版本用codex plugin marketplace upgrade diagram-design加新会话即可立即拉取无需再走本文的完整迁移流程。【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考