soia-dev-archify-diagramslisted

# soia-dev-archify-diagrams Use this skill to turn architecture and process explanations into polished Archify diagrams with maintainable JSON source files and README-friendly PNG previews. The skill owns the reusable workflow and helper scripts. Archify itself remains an external renderer. ```text soia-dev-archify-diagrams/ ├── SKILL.md ├── scripts/ │ ├── render-archify-diagrams.mjs │ └── export-archify-previews.mjs └── assets/examples/ ├── minimal-architecture.architecture.json ├── minimal-dataflow.dataflow.json └── minimal-workflow.workflow.json ``` ## 客户可读说明 ### 这个技能可以做什么 Draw, improve, validate, or publish Archify architecture / data-flow / sequence / lifecycle diagrams with JSON IR and PNG previews | 客户想要 | 技能会做 | 客户能看到 | |---|---|---| | 完成本技能覆盖的工作 | 读取用户请求、必要上下文和本技能正文流程，执行最小可靠步骤 | 客户会看到执行计划、命令输出摘要、代码/文档变更、验证结果和风险说明。 | | 缺少依赖、权限、配置或 key | 停止需要外部状态的动作，明确指出缺什么 | 安装命令、申请地址、配置路径或需要客户确认的问题 | | 执行完成 | 汇总成功、跳过、失败、文件变更和验证结果 | 一段可复制进工单/日志的完成回执 | ### 客户如何使用 1. 用自然语言说明目标，并提供必要输入：文件、URL、repo、workspace、proposal、vault 或平台账号状态。 2. Agent 先判断是否命中本技能，再检查依赖、配置、权限和风险动作。 3. 能 dry-run 或预览的动作先给预览；涉及删除、覆盖、发送、发布、写远端状态时先征求客户确认。 4. 执行后验证真实输出，不用“看起来成功”代替证据。 5. 最终回复必须给客户可见总结：做了什么、日志摘要、文件变化、问题和下一步。 ### 依赖与安装 安装本技能（单个技能）： ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-archify-diagrams -y ``` 配置约定： ```text ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-archify-diagrams/config.yml SOIA_DEV_ARCHIFY_DIAGRAMS_CONFIG_FILE=<custom-config-path>