Vensim skill

Skill 1837620622/vensim-system-dynamics-skill/skills/vensim-skill

Vensim 系统动力学建模 AI Skill：.mdl 草图自动排版 + 信息箭头平滑弧线。基于官方 Sketch Format 解析，Graphviz 半固定布局，保留方程与对象 ID。适用于 SFD/CLD 课程作业、政策分析、论文图表。

Install

npx -y skills add 1837620622/vensim-system-dynamics-skill --skill vensim-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when the user needs Vensim/system-dynamics CLD/SFD modeling, .mdl sketch audit/repair/layout, simulation, nodata diagnosis, scenario comparison, or charts for coursework, policy, management, population, or supply-chain models.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.4 KB, as published. Nobody here has run it

Vensim 系统动力学通用技能

本技能定位为 Vensim .mdl Sketch 审计、保守自动布局、仿真诊断与论文图表辅助工具。目标是形成“检查 → 修复 → 仿真 → 出图 → 对比 → 回到 Vensim 复核”的闭环流程。

中文课程论文、政策仿真和管理研究模型默认使用中文业务变量。Vensim 控制变量和函数名保持原生英文；业务变量、图题、坐标轴、图例、CSV 表头、变量表和说明文档优先使用中文。留学生作业或用户明确要求英文时才切换英文变量。

兼容性（全球 IDE / AI 编程助手）

本技能是纯 CLI 工具（skill.sh + Python 标准库），不依赖 MCP 协议、不绑定特定 IDE 插件。任何能执行 shell 命令、能读取项目文件的 AI 编程助手均可使用，跨 macOS / Windows / Linux。设计目标兼容以下主流工具：

云订阅型：Claude Code、Cursor、Windsurf、Codex CLI、Antigravity、Amp、Mistral Vibe
免费 / 云托管型：Gemini CLI、GitHub Copilot（CLI 与 VS Code Chat）、Amazon Q Developer、Kiro、Qwen Code
开源 BYOK 型：OpenCode、Aider、Cline、Continue.dev、Goose、Roo Code、OpenClaw、Zed、iFlow、Kimi Code CLI、BLACKBOX
IDE 内置 / 插件型：VS Code、JetBrains 全系（IntelliJ/PyCharm 等）AI Assistant、Trae、通义灵码、CodeGeeX、Baidu Comate、Replit AI
自主 Agent 型：Devin、OpenHands、Bolt.new、v0、Lovable

兼容性说明放在正文中，frontmatter 仅保留技能发布与加载需要的标准字段。

跨平台入口：macOS/Linux 用 ./skill.sh，Windows 用 skill.cmd（cmd/PowerShell）或 Git Bash/WSL 下的 ./skill.sh；两入口命令一致，自动检测 python3/python/py。Python 脚本用 pathlib+shutil.which+subprocess（不依赖 shell），读文件兼容 UTF-8 BOM 与 GB 编码，CSV 用 newline="" 避免 Windows 双换行。

能力边界

已支持：

Sketch 对象 ID 与 Arrow 引用审计；
方程区语义审计：重复定义、未定义引用、未使用变量、缺失单位；
普通变量节点的分层（dot）或力导向（neato）布局；
普通信息箭头（≤1 控制点）的基础弧线化，多控制点箭头保持原样；
保留原方程区、保留对象数量、保留 Arrow 起止对象；
纯 Python 仿真引擎对常见结构（INTEG / LOOKUP / IF THEN ELSE / SMOOTH / DELAY）的 Euler 积分仿真与 CSV 导出；
matplotlib 折线图与多场景对比图；
缺失单位补齐与断裂草图箭头修复；
nodata 诊断：默认严格模式下遇到不支持函数、变量缺失或求值失败会中止并指出根因；明确传入 --keep-going 时才按兼容模式继续输出。

暂不承诺：

全部 Vensim 函数的解析与仿真；
原生 Vensim 语法检查与完整单位量纲推导；
无交叉、无穿框的完全自动布线；
Control Panel、敏感性分析和论文图表的自动生成。

最终质量门槛仍需回到 Vensim：布局后请在 Vensim 中执行 Check Model 与 Units Check。

图面质量规则

同一模块变量尽量放近，不跨半个页面连线；
长距离来源引用优先用 Shadow Variable，但 Shadow 只能发出箭头，不能作为结果接收入箭头；
一个变量最多保留 3-5 条直接可见箭头，超过就拆 View 或移入参数表；
主路径从左到右，反馈路径从右下绕回左上；
交叉线超过 3 条就拆子系统；
箭头不能压在变量文字上；
图中变量名用精炼中文，完整解释放变量表；
常量参数默认放“参数表”，不要全部画到图里；
截图前统一字体、字号、线宽和缩放比例；
最终以能解释模型机制为准，不以把所有变量画出来为准。

Vensim 中灰色 <变量名> 是 Defined 变量未展开 causes 的提示，通常不是仿真错误。处理方式是补充子系统 View、使用 Shadow Variable 做长距离来源引用，或把常量参数移入参数表。

工具入口

布局与审计：vensim_system_dynamics/tools/vensim_autolayout.py（inspect / audit / layout）
仿真与绘图：vensim_system_dynamics/tools/vensim_engine.py（simulate / graph / compare / units / check / fix）
便捷封装：skill.sh（根目录）
建模规范与流程：vensim_system_dynamics/OPERATIONS_GUIDE.md
示例模型：vensim_system_dynamics/examples/

快速使用

./skill.sh doctor                                 # 检查环境
./skill.sh audit vensim_system_dynamics/examples/population_demo.mdl     # 审计草图与方程语义
./skill.sh quick vensim_system_dynamics/examples/population_demo.mdl     # 一键 inspect + audit + layout
./skill.sh simulate vensim_system_dynamics/examples/population_demo.mdl --var Population --var Births
./skill.sh graph vensim_system_dynamics/examples/population_demo.mdl --var Population --output pop.png
./skill.sh check vensim_system_dynamics/examples/population_demo.mdl     # 全面检查
./skill.sh fix broken.mdl --output fixed.mdl      # 自动修复

详细说明见 README.md 与 vensim_system_dynamics/OPERATIONS_GUIDE.md。