用途：把架构与流程说明转成受维护的 Archify 图，JSON IR 作为唯一源文件，PNG 预览便于 README 展示。支持架构图、数据流图、工作流/流程图、时序图、生命周期图，分别对应后缀 .architecture.json、.dataflow.json、.workflow.json、.sequence.json、.lifecycle.json。若 Mermaid 草图混合了组件与流程，应拆成两张图。
主要能力：配套脚本 render-archify-diagrams.mjs 会查找上述后缀文件，依次执行 archify validate、render、check，输出 HTML 预览；加 --png-only 时导出 PNG 并删除临时 HTML，不加则保留 HTML 便于浏览器排错。export-archify-previews.mjs 可对已有 HTML 导出 PNG。
安装：npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-archify-diagrams -y。配置路径约定为 ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-archify-diagrams/config.yml，可用 SOIA_DEV_ARCHIFY_DIAGRAMS_CONFIG_FILE 指定自定义路径；无私配置时可不创建 config.yml。敏感信息只能写入私有 config.yml、进程环境或 provider 登录态，不得进入仓库、vault 正文或日志。
用法：输出目录优先级为命令行 --output-dir、环境变量或配置 ARCHIFY_OUTPUT_DIR、安全默认 ~/Downloads/soia-dev-archify-diagrams/。README/文档用 --output-dir assets/diagrams；已确认的 SOIA proposal 用 <workspace>/proposals/<proposal-id>/design/diagrams；临时预览用默认目录。Archify 运行位置可通过 ARCHIFY_BIN、--archify-root、ARCHIFY_ROOT 指定，或使用已安装技能位置（如 ~/.claude/skills/archify 等）。若 Archify 不可用，可在技能仓库外克隆：git clone https://github.com/tt-a1i/archify.git <workspace>/archify，然后 cd <workspace>/archify/archify、npm install，并把 ARCHIFY_ROOT 指向该检出。可从 assets/examples 的最小 JSON 模板起步。
限制：不把架构 HTML 作为提交产物，除非用户明确要交互图；README 只嵌入已提交的 PNG。不要把 Archify 上游源码复制进技能仓库，不要硬编码维护者专属工作区路径，也不要根据当前目录推断 proposal 工作区。存在重叠报错时应修 JSON（如 labelDy、labelDx、labelAt、labelSegment 或调整行列/尺寸/视图框）后重渲染，不能忽略。第三方技能只声明依赖与安装方式，不直接改其文件。强依赖、可选依赖与第三方技能关系的完整清单以 SKILL.md 的“依赖 / 前置 / 资源 / 边界”说明为准；资料未提供具体收费、价格与平台支持信息。