# Run Julia

> 包装 Julia 调用：执行 model/03_solve/<model>/run.jl 并解读输出。当用户说"跑 Julia"、"run.jl"、"SequenceJacobian"、"求 HA 模型"时调用。

- Skill: `allblueuk/run-julia` (Agent Skill)
- Install (CLI): `npx skillmds@latest add allblueuk/run-julia`
- Raw SKILL.md: https://api.skillmd.com/api/skills/allblueuk/run-julia/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: allblueuk (https://skillmd.com/u/allblueuk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/allblueuk/run-julia

---


# run-julia — Julia 求解调用包装

## 触发场景

- "跑 model/03_solve/<model>/run.jl"
- "用 Julia + SequenceJacobian 求 HA 模型"
- "测试某个 Julia 求解脚本"
- "Julia 报错看不懂"

## 输入契约

| 字段 | 类型 | 说明 |
|---|---|---|
| `jl_file` | path | `model/03_solve/<model>/run.jl` |
| `project` | path? | 默认仓库根 `Project.toml` |
| `precompile` | bool | 默认 true（首次跑） |

## 步骤清单

1. 跑 `bash scripts/run_julia.sh <jl_file>`。
2. 把控制台输出实时镜像到 `logs/<model>_julia_<ts>.log`。
3. 解析输出：策略函数、稳态分布、雅可比、IRF。
4. 失败时摘录关键 Stacktrace 并定位到 `.jl` 行号。
5. 后处理产物保存到 `output/checkpoints/<model>_*.json`（用 `JSON3.write`）。
6. 调用 `numerics-reviewer` 子 agent。

## 输出契约

| 文件 | 必产 | 说明 |
|---|---|---|
| `logs/<model>_julia_<ts>.log` | ✅ | |
| `output/checkpoints/<model>_*.json` | ✅ | 检查点 |

## 不允许的操作

- 在 `run.jl` 中硬编码绝对路径（用 `joinpath(@__DIR__, ...)` 或读 `model/_utils/setup_paths.jl`）
- 跳过 `Pkg.activate()` 导致依赖漂移
- 把 `Float64` 与 `Float32` 混用而不显式转换

## 失败回退

| 症状 | 处理 |
|---|---|
| 包版本不匹配 | `Pkg.instantiate()`；commit `Manifest.toml`（如 spec 要求） |
| OOM | 减小网格或在 `_utils/setup_paths.jl` 调高内存上限 |
| 雅可比缓存与稳态不同步 | 强制重算雅可比并清缓存 |