用途：把架构、数据流、流程、时序与状态说明转换成 Archify 图表，产出可维护的 JSON 源文件和适合放进 README 的 PNG 预览。Archify 本身是外部渲染器，本技能负责可复用流程与辅助脚本。
主要能力：支持五类图，按 JSON 后缀选择渲染器：architecture（系统组件与运行边界）、dataflow（数据流动与血缘）、workflow（维护流程、审批、CI/发布步骤）、sequence（调用时序与回退）、lifecycle（状态转换与重试/取消路径）。提供渲染脚本 render-archify-diagrams.mjs 和预览导出脚本 export-archify-previews.mjs，以及 assets/examples/ 下的最小示例。
用法：可用插件安装 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-dev-design@soia；也可单独安装 npx skills add soia-team/soia-open-dev-design-skills -g -a '*' -s soia-dev-archify-diagrams -y。运行时需提供 Archify：设置 ARCHIFY_BIN 或 ARCHIFY_ROOT、--archify-root，或使用已安装技能目录。渲染示例：node skills/soia-dev-archify-diagrams/scripts/render-archify-diagrams.mjs --dir assets/diagrams --output-dir assets/diagrams --png-only --theme light --width 1400 --height 1000 --scale 2。输出目录优先级为 --output-dir、ARCHIFY_OUTPUT_DIR、默认 ~/Downloads/soia-dev-archify-diagrams/。
适用场景：为仓库 README/文档生成图表（建议 assets/diagrams/，提交 JSON 与 PNG）；已确认的 SOIA proposal 写到 <workspace>/proposals/<proposal-id>/design/diagrams/。
限制：JSON IR 是唯一事实源；生成 HTML 仅作渲染检查中间物，--png-only 成功后删除；除非用户明确要求交互图，否则不提交 HTML。渲染前需跑 Archify 的 validate、render、check，并处理标签/节点碰撞等报错。私有配置放在 ~/.config/soia-skills/soia-dev-archify-diagrams/config.yml 或环境变量，不应写入仓库或日志。WorkBuddy 需单独安装。