1679846776jmy-web/fusion_skills

10 stars 质量 63 趋势 26Apache-2.0

集成聚变研究的常用skill，与大模型形成更好的交互和使用体验。

概览

快速开始 · 安装 · 技能索引 · 体系架构 · 使用教程 · 贡献与开发 · English fusion_skills 是一套**的可复用科研技能库，在成熟的 nature-* 两层架构（静态/动态 + manifest 路由 + 按需加载）之上，注入了聚变领域的专业知识：装置参数、等离子体物理量定义、诊断分析流程、放电设计、聚变期刊格式等。所有技能共享一个 fusion-shared 知识库（术语双语对照、物理常数、参数定义、数据格式、装置库），一处更新、处处生效。 - ：fusion-writing → fusion-polishing → fusion-figure - ：fusion-academic-search → fusion-literature-pipeline → fusion-reader - ：fusion-reviewer → fusion-response → fusion-statistics - ：fusion-data → fusion-experiment-log → fusion-proposal - ：fusion-data-analysis → fusion-diagnostics → fusion-machine-ops 1. ，复用 nature-* 成熟的两层架构（静态层 + manifest 路由 + 按需加载）。 2. ，避免重复，一处更新处处生效。 3. ：在现有 skill 内增加 paper_type / journal 轴值，比新建 skill 更轻量。 4. ：数据分析、诊断分析、装置运营三个专属 skill 从零构建。 5. ：eqdsk 读取、剖面拟合、功率平衡等 Python 脚本在多个 skill 间共享。安装完成后，直接把论文、放电数据、审稿意见或任务描述交给 Agent。下面这些提示词可以直接复制使用：如果你不确定该用哪个技能，直接描述任务即可；如果已经知道技能名，可以在提示词中明确写"使用 fusion-data-analysis"或"使用 fusion-diagnostics"。 fusion_skills 是一组围绕 SKILL.md 组织的可复用技能包。

README

fusion_skills 是一套聚变领域专属的可复用科研技能库，在成熟的 nature-* 两层架构（静态/动态 + manifest 路由 + 按需加载）之上，注入了聚变领域的专业知识：装置参数、等离子体物理量定义、诊断分析流程、放电设计、聚变期刊格式等。

所有技能共享一个 fusion-shared 知识库（术语双语对照、物理常数、参数定义、数据格式、装置库），一处更新、处处生效。

1. 项目简介

本仓库把通用科研 skill 体系改造为聚变领域专属工具链，覆盖科研全流程：

写作链：fusion-writing → fusion-polishing → fusion-figure
文献链：fusion-academic-search → fusion-literature-pipeline → fusion-reader
审稿链：fusion-reviewer → fusion-response → fusion-statistics
数据链：fusion-data → fusion-experiment-log → fusion-proposal
分析链（全新）：fusion-data-analysis → fusion-diagnostics → fusion-machine-ops

核心理念：

不重写架构，复用 nature-* 成熟的两层架构（静态层 + manifest 路由 + 按需加载）。
聚变知识集中在 fusion-shared，避免重复，一处更新处处生效。
新增"轴值"而非新增 skill：在现有 skill 内增加 paper_type / journal 轴值，比新建 skill 更轻量。
只有无对应物的 skill 才新建：数据分析、诊断分析、装置运营三个专属 skill 从零构建。
脚本可复用：eqdsk 读取、剖面拟合、功率平衡等 Python 脚本在多个 skill 间共享。

2. 快速开始

安装完成后，直接把论文、放电数据、审稿意见或任务描述交给 Agent。下面这些提示词可以直接复制使用：

想做什么	直接这样说
读聚变论文 / 中英文对照	`把这篇 Nuclear Fusion 论文做成图文对应的中英文对照 Markdown reader，提取 I_p、B_t、n_e、q_95、β_N。`
起草聚变手稿章节	`根据这些放电结果和图件，帮我起草 Nuclear Fusion 风格的摘要和实验方法段。`
做聚变科研图	`根据这个径向剖面数据，生成投稿级的 Te/ne 剖面图和 q 剖面图。`
平衡/剖面/输运分析	`读取这个 G-file，做剖面拟合并计算功率平衡，检查能量守恒是否闭合。`
诊断数据分析	`对这个 Thomson 散射信号做温度/密度反演，给出误差传播。`
放电设计	`帮我设计一个 EAST H-mode 放电场景：给出 Ip/Bt/κ/δ/加热功率/密度目标。`
聚变文献检索	`检索托卡马克偏滤器脱靶的最新文献，按子领域关键词路由。`
预投稿审稿模拟	`从 Nuclear Fusion 审稿人视角评估这篇稿件，按等离子体物理/诊断/模拟/工程四类门控逐项检查。`
回复审稿意见	`根据这封返修邮件，为每位审稿人写逐点回复和 cover letter。`
聚变基金申报书	`帮我起草一份科技部聚变专项申报书的研究方案部分。`

如果你不确定该用哪个技能，直接描述任务即可；如果已经知道技能名，可以在提示词中明确写"使用 fusion-data-analysis"或"使用 fusion-diagnostics"。

3. 安装

fusion_skills 是一组围绕 SKILL.md 组织的可复用技能包。skills/ 下的每个顶层技能目录都是一个可安装单元；fusion-shared 是供其他技能读取的共享支持包，默认不作为独立触发技能计入技能索引。

3.1 `npx skills` 安装方式

需要先安装 Node.js 18 或更高版本。先查看仓库中可安装的技能名：

npx skills add 1679846776jmy-web/fusion_skills --list

把全部技能全局安装到 Codex（fusion-shared 会随全量安装一起加入）：

npx skills add 1679846776jmy-web/fusion_skills --global --agent codex --skill '*' --yes --copy

只为当前项目安装一个独立技能时，省略 --global。例如：

npx skills add 1679846776jmy-web/fusion_skills --agent codex --skill fusion-data-analysis --yes --copy

单独安装 fusion-data-analysis、fusion-diagnostics、fusion-writing 等依赖共享层的技能时，同时选择共享支持包：

npx skills add 1679846776jmy-web/fusion_skills --global --agent codex \
  --skill fusion-data-analysis --skill fusion-shared --yes --copy

检查全局安装结果并更新：

npx skills list --global --agent codex --json
npx skills update --global --yes

3.2 Claude Code 安装方式

推荐保留一个稳定的本地 clone，再用 subagent 或 slash command 指向真实的 skills/*/SKILL.md。这样不会破坏技能目录结构，也能继续读取 references/、static/、manifest.yaml、脚本、资产和 skills/fusion-shared/。

mkdir -p ~/ai-skills
cd ~/ai-skills
git clone https://github.com/1679846776jmy-web/fusion_skills.git

推荐方式：为常用技能创建 Claude Code subagent wrapper。以 fusion-data-analysis 为例：

mkdir -p ~/.claude/agents
cat > ~/.claude/agents/fusion-data-analysis.md <<'EOF'
---
name: fusion-data-analysis
description: Use for fusion equilibrium reconstruction, profile fitting, transport, MHD stability, and edge-plasma analysis.
---

When invoked, first read `~/ai-skills/fusion_skills/skills/fusion-data-analysis/SKILL.md` and follow it as the governing workflow.
Read supporting files from `~/ai-skills/fusion_skills/skills/fusion-data-analysis/` and `~/ai-skills/fusion_skills/skills/fusion-shared/` only when needed.
Do not replace this skill with a generic plasma-analysis response.
EOF

然后开启新的 Claude Code 会话，直接请求使用这个 subagent：

Use the fusion-data-analysis subagent to analyze this G-file equilibrium and check power balance.

安装其他技能时，把示例中的 fusion-data-analysis 换成对应目录名即可，例如 fusion-diagnostics、fusion-writing、fusion-machine-ops。

3.3 Codex 安装方式

git clone https://github.com/1679846776jmy-web/fusion_skills.git
cd fusion_skills

把仓库链接交给 Codex，让它执行安装，推荐提示词：

请从这个仓库安装 Codex skills：
https://github.com/1679846776jmy-web/fusion_skills.git

请 clone 仓库后，把 skills/ 下的完整技能目录复制到 Codex 的 skills 目录。
请保留 skills/ 下的完整目录结构，不要只复制 SKILL.md。
如果技能需要共享文件，也请一并安装 skills/fusion-shared。

关键规则：保留完整目录结构。请复制或引用整个技能文件夹，而不是只复制 SKILL.md，因为许多技能依赖 references/、static/、manifest.yaml、脚本、资产或共享文件。

安装脚本不会自动安装 Python 依赖。需要使用相关脚本时，再按需安装：

# fusion-data-analysis 的脚本为纯标准库，无需额外依赖
python -m pip install -r skills/fusion-academic-search/mcp-server/requirements.txt

fusion-academic-search 的 MCP 服务还需要单独配置 PUBMED_EMAIL，Scopus / ScienceDirect 等可选 provider 需要使用本机凭据配置，不要把 API key 写入仓库文件。

3.4 其他 Agent 场景

用于其他 agent 时，建议保留一个稳定的仓库 clone，再创建轻量 subagent、slash command 或 custom prompt wrapper，指向真实的 skills/*/SKILL.md，并保留 skills/fusion-shared/。

将完整技能目录复制到你的 prompt library 或项目中。
保留 SKILL.md、manifest.yaml、static/、references/、脚本、资产和需要的 skills/fusion-shared/ 文件。
如目标 agent 有自己的格式要求，可调整 frontmatter 和正文结构。

4. 使用教程

完整的使用教程（安装、各链路的典型工作流、常见问题）见：

中文教程：docs/fusion-skills-tutorial.md
English tutorial：docs/fusion-skills-tutorial_EN.md

5. 技能索引

当前 skills/ 下包含以下可触发技能；skills/fusion-shared/ 是共享内容目录，不计入技能索引。点击技能名或"详情页"进入每个 skill 的单独说明页面。

技能	状态	用途	触发词	详情页
`fusion-writing`	Beta	起草或重建聚变手稿章节（实验/模拟/诊断/材料），准备首次投稿材料包	“fusion writing”, “写摘要”, “写引言”, “实验方法段”, “submission package”, “聚变论文写作”	详情
`fusion-polishing`	Beta	将学术文本润色、重构或翻译为聚变期刊风格英文，并扫描术语/单位/符号漂移	“fusion polishing”, “润色”, “聚变术语”, “physics notation”, “论文英文”	详情
`fusion-figure`	Beta	生成投稿级聚变科研图：磁面图、径向剖面、时间演化、稳定性图、H-mode 转换图、偏滤器排热图、中子产额图	“fusion figure”, “剖面图”, “磁面图”, “publication plot”, “聚变绘图”	详情
`fusion-academic-search`	Beta	聚变文献多源检索（INIS/ITER/PPPL/NF 在线版）、子领域关键词路由、期刊分级	“search papers”, “查文献”, “INIS”, “ITER publications”, “聚变文献检索”	详情
`fusion-reviewer`	Beta	从聚变审稿人视角模拟评审，按等离子体物理/诊断/模拟/工程四类门控逐项检查	“fusion reviewer”, “预投稿评审”, “审稿门控”, “reviewer report”	详情
`fusion-response`	Beta	解析返修邮件，为审稿人写逐点回复、cover letter、标红稿，回显四类门控	“response to reviewers”, “rebuttal”, “审稿意见回复”, “修回信”	详情
`fusion-statistics`	Beta	放电间重复性、系综平均、诊断不确定度传播、剖面拟合误差估计	“fusion statistics”, “shot-to-shot”, “不确定度”, “剖面拟合误差”, “统计审查”	详情
`fusion-data`	Beta	准备数据可用性声明、IMAS/MDSplus/eqdsk 元数据管理、聚变数据 FAIR 原则	“Data Availability”, “数据可用性”, “IMAS”, “MDSplus”, “FAIR”	详情
`fusion-experiment-log`	Beta	记录放电日志：shot 体系、机器参数 YAML frontmatter、诊断配置	“放电日志”, “shot number”, “实验日志”, “discharge log”	详情
`fusion-literature-pipeline`	Beta	自动化聚变文献发现管线：关键词集、期刊评分权重、子领域分类	“literature pipeline”, “每日文献”, “文献推送”, “聚变文献订阅”	详情
`fusion-reader`	Beta	生成带来源锚点、图文对应、公式渲染的聚变论文全文 reader，提取等离子体参数	“fusion reader”, “全文翻译”, “读论文”, “参数提取”, “聚变论文阅读”	详情
`fusion-proposal`	Beta	起草 DOE OFES / EUROfusion / 科技部聚变专项申报书	“proposal”, “开题报告”, “研究方案”, “OFES”, “聚变专项申报”	详情
`fusion-data-analysis`	Draft	平衡重建、剖面拟合、输运分析、MHD 稳定性、边缘等离子体分析（含 eqdsk/拟合/功率平衡脚本）	“平衡重建”, “剖面分析”, “功率平衡”, “EFIT”, “eqdsk”, “G-file”, “输运分析”, “ELM”	详情
`fusion-diagnostics`	Draft	8 种主要诊断（Thomson/ECE/CXRS/Bolometry/中子/MSE/反射仪/朗缪尔探针）的标定→反演→不确定度分析	“Thomson scattering”, “ECE”, “CXRS”, “Bolometry”, “中子诊断”, “MSE”, “诊断分析”	详情
`fusion-machine-ops`	Draft	装置参数、放电场景设计、运行空间映射、破裂分析与缓解、安全边界	“放电设计”, “运行空间”, “破裂”, “VDE”, “逃逸电子”, “Greenwald 极限”	详情

fusion-shared 是共享内容目录（术语、常数、参数、数据格式、装置库、期刊格式），不计入技能索引。

6. 体系架构

fusion-shared (共享知识库)
├── core/           术语表、物理常数、参数定义、数据格式、装置库、一致性检查
└── journal-formats/  7 种聚变期刊格式（NF/PPCF/PoP/FED/PST/NME/FST）
     │
     ├── 改造的 12 个通用 skill
     │   ├── fusion-writing / fusion-polishing / fusion-figure        (写作链)
     │   ├── fusion-academic-search / fusion-literature-pipeline / fusion-reader  (文献链)
     │   ├── fusion-reviewer / fusion-response / fusion-statistics    (审稿链)
     │   └── fusion-data / fusion-experiment-log / fusion-proposal    (数据链)
     │
     └── 3 个全新聚变专属 skill
         ├── fusion-data-analysis    (平衡/剖面/输运/MHD/边缘分析)
         ├── fusion-diagnostics      (8 种主要诊断分析)
         └── fusion-machine-ops      (装置参数/放电设计/破裂分析)

7. 贡献与开发

7.1 共享设计原则

所有技能都遵守以下原则：

优先使用一手来源：规则基于装置官方文档、期刊指南、标准物理定义或明确本地来源，而不是泛泛审美偏好。
显式胜过隐式：每条规则都应说明理由，而不是只给断言。
感知任务上下文：实验/模拟/诊断/材料论文使用不同逻辑。
输出优先：每个技能都应返回能直接使用的产物，例如可粘贴文本、.svg、脚本或具体建议。
可扩展：每个技能自包含在自己的目录中，新增技能不应要求修改既有技能。
聚变知识集中在 fusion-shared：不要在每个 skill 里重复术语/常数/参数定义。

7.2 仓库目录结构

skills/
├── fusion-shared/              # 当技能引用 ../fusion-shared 时需要保留
├── fusion-/
│   ├── README.md
│   ├── README_EN.md
│   ├── SKILL.md
│   ├── manifest.yaml     # router-style 技能会包含
│   ├── static/           # router-style 技能会包含
│   └── references/...
└── fusion-data-analysis/
    ├── README.md
    ├── README_EN.md
    ├── SKILL.md
    ├── scripts/...
    └── references/...

7.3 新增技能流程

创建技能目录 skills/fusion-/。
添加必需文件：SKILL.md（必需）、README.md（必需）、README_EN.md（必需）、references/*.md（复杂技能推荐）。
编写中英文 README：每个新增技能都必须同时提供 README.md 和 README_EN.md，中英文一一镜像。
配置 SKILL.md frontmatter（name、description）。
更新上方技能索引表格。
设置状态标签：Draft（规则已定义，未在真实案例测试）/ Beta（已在示例测试）/ Stable（已在真实内容验证）。

7.4 校验

提交前至少做这些检查：

# 校验全库结构（SKILL.md/manifest 一致性、无悬空引用）
python scripts/validate_fusion_skills.py

# 校验术语变体
python skills/fusion-shared/scripts/check_consistency.py

8. Star 历史

欢迎为本项目点 Star，这是对我们持续维护的最大鼓励。

在 GitHub 查看完整 README

安装

npx skillfish add 1679846776jmy-web/fusion_skills

新手？先看 mcpskill.org 教程 →