README_ZH.md

MetForge — 大气科学 Skills

English · 简体中文

MetForge 是一组轻量、可复用的大气科学技能，为智能体补充数据获取、科学计算、科研绘图和数值模式诊断所需的领域判断，同时把通用任务规划、代码编写、工具调用和上下文管理交给宿主智能体。同一份 skills/ 源码可用于 Codex、Claude Code 和 Hermes。

快速开始

安装后，可以直接描述科研任务，也可以明确指定技能。Codex 使用 $metforge-data，Claude Code 使用 /metforge:metforge-data，Hermes 使用 /metforge-data；三者也都可以自然语言触发。下面的提示词可以直接复制使用：

使用场景	提示词
下载再分析资料	使用 $metforge-data 下载 DJFM 2000–2020、10°S–10°N、80°E–180°E 的 ERA5 850 hPa 逐小时 u、v 风场。先验证一个月，再扩展到完整时段。
检查和预处理本地数据	使用 $metforge-data 检查这些 NetCDF 文件的坐标、单位、日历和缺测值，并设计一个内存安全的 xarray 预处理脚本。
计算大气科学指数	使用 $metforge-analysis 计算 SPCZ 强度和倾角指数；运行前明确区域、权重、基准期、单位和验证方法。
趋势、滤波和统计分析	使用 $metforge-analysis 对连续逐日场去趋势并进行 20–100 天滤波，然后计算 EOF、回归图和滞后合成，并考虑时间自相关。
设计大气科学图件	使用 $metforge-figure 将这些 MJO 合成场设计为清晰的经度–时间图，统一色标和单位，并标出传播速度参考线。
审查已有图件	使用 $metforge-figure 审查这张多面板地图的科学可比性、色标、标签、投影伪影和导出质量，并优先修改最关键的问题。
诊断动力框架试验	使用 $metforge-model-diagnose 判断平衡流试验中 RMS 误差为何增长，并设计一个最小试验，区分空间离散失衡与增长的计算模态。
组合分析与可视化	使用 $metforge-analysis 计算诊断变量和统计量，再使用 $metforge-figure 生成支撑结论所必需的图件。

技能

技能	适用任务	示例
metforge-data	查找、下载、裁剪、验证并记录大气科学数据	“使用 $metforge-data 下载该区域的 ERA5 逐小时风场。”
metforge-analysis	计算指数、气象诊断变量、趋势、滤波、EOF、回归和合成	“使用 $metforge-analysis 计算该环流指数及其趋势。”
metforge-figure	设计、生成、修改和审查大气科学图件	“使用 $metforge-figure 将平衡流试验结果整理为可发表的对比图。”
metforge-model-diagnose	诊断动力框架、理想试验、平衡、守恒、收敛和误差增长	“使用 $metforge-model-diagnose 判断平衡流试验为何随积分时间漂移。”

skills/ 下的每个目录都是可独立安装的技能。技能可以按需协作，但不依赖中央调度器。

安装

Codex

克隆仓库并同步全部技能：

git clone https://github.com/yuanruichen/MetForge.git
cd MetForge
scripts/install-codex-skills.sh

在不修改现有安装的情况下检查版本是否一致：

scripts/install-codex-skills.sh --check

安装脚本默认写入 ${CODEX_HOME:-$HOME/.codex}/skills。可以使用 --dest PATH 指定其他目录。

Claude Code

将该仓库注册为 Marketplace，然后安装 MetForge 插件：

/plugin marketplace add yuanruichen/MetForge
/plugin install metforge@metforge

Claude Code 会从共享的 skills/ 目录发现四个技能，对应命令为 /metforge:metforge-data、/metforge:metforge-analysis、/metforge:metforge-figure 和 /metforge:metforge-model-diagnose。

Hermes

将 MetForge 添加为公开的 Skills Hub tap：

hermes skills tap add yuanruichen/MetForge

也可以直接从 GitHub 安装各个技能：

hermes skills install yuanruichen/MetForge/skills/metforge-data
hermes skills install yuanruichen/MetForge/skills/metforge-analysis
hermes skills install yuanruichen/MetForge/skills/metforge-figure
hermes skills install yuanruichen/MetForge/skills/metforge-model-diagnose

Hermes 会将第三方 tap 视为社区来源，并在安装时进行安全扫描。

设计原则

• 提供领域判断，不重复宿主智能体已经具备的任务编排能力。
• 在高成本计算前先验证最小可用结果。
• 明确记录变量、单位、坐标、假设、指标和证据。
• 根据实际运行环境、数据规模和计算成本选择直接运行或提交 Slurm。
• 每次下载、计算、模式试验或绘图阶段完成后追加处理记录。
• 保持原始数据不可变，保证派生结果可复现。
• 把科研图件视为可审查的科学论证，而不只是美化输出。
• 区分直接证据、科学解释和尚未解决的不确定性。

Codex、Claude Code 和 Hermes 共用同一组技能目录；平台专属文件只保存分发元信息。