canxiangcc/aminer-open-skill

---

aminer-open-skill 面向科研全流程收录基于 AMiner 学术数据的可复用技能，强调真实学术数据、可验证证据链与可直接使用的科研产物。

目录

• 1. 快速开始
• 2. 安装
  • 2.1 npx skills 安装（推荐）
  • 2.2 Claude Code 插件安装
  • 2.3 手动安装（Codex / OpenClaw / 其他 Agent）
  • 2.4 Python 依赖
  • 2.5 配置 Token
  • 2.6 Token 与计费注意事项
• 3. 技能索引
  • 3.1 按科研阶段选技能
  • 3.2 易混技能怎么选
  • 3.3 完整技能列表
• 4. 设计原则与仓库结构
• 5. 反馈与联系
• 6. Star 历史

1. 快速开始

安装并按需配置 Token 后（见 2. 安装），可以直接把论文、主题、审稿意见或任务描述交给 Agent。下面这些提示词可以直接复制使用：

以下 7 个科研工作流技能也可以在 AMiner 网页版直接使用，无需安装：

如果你不确定该用哪个技能，直接描述任务即可；如果已经知道技能名，可以在提示词中明确写“使用 aminer-free-academic”。以 Claude Code 插件方式安装时，带 commands/ 的技能还可以用 slash command 直接调用（插件命令带插件名前缀）：

/aminer-deep-search:aminer-deep-search topic: "多模态智能体" target-size: 200

2. 安装

skills/ 下每个目录都是一个独立的可安装技能。无论用哪种方式，都要保留完整技能目录（SKILL.md、scripts/、references/ 等），不要只复制 SKILL.md。安装后再按 2.5 配置 Token。

2.1 npx skills 安装（推荐）

需要 Node.js 18 或更高版本，无需全局安装 CLI。先查看可安装的技能名：

npx skills add AMinerOrg/aminer-open-skill --list

按需安装到当前项目（省略 --global）或用户全局（加 --global）。--agent 取值如 claude-code、codex、openclaw、cursor、trae：

# 只装免费入口，装到当前项目的 Claude Code
npx skills add AMinerOrg/aminer-open-skill --agent claude-code --skill aminer-free-academic --yes

# 装多个技能到 Codex 全局
npx skills add AMinerOrg/aminer-open-skill --global --agent codex \
  --skill aminer-free-academic --skill aminer-academic-search --yes

# 装全部技能
npx skills add AMinerOrg/aminer-open-skill --global --agent claude-code --skill '*' --yes

查看与更新：

npx skills list --global
npx skills update --global --yes

npx skills 只管理技能文件，Python 依赖见 2.4；slash command 需要 2.2 插件安装。

2.2 Claude Code 插件安装

本仓库自带插件清单 .claude-plugin/marketplace.json（市场名 aminer-open-skills），每个技能是一个插件。在 Claude Code 中执行：

/plugin marketplace add AMinerOrg/aminer-open-skill
/plugin install aminer-free-academic@aminer-open-skills

其他技能把 aminer-free-academic 换成 技能列表 中的名字即可；也可以只执行第一行，再用 /plugin 打开界面勾选。拉取新版：

/plugin marketplace update aminer-open-skills

插件方式会同时注册技能自带的 slash command（commands/ 目录），命令带插件名前缀，例如 /aminer-daily-paper:aminer-dp、/aminer-deep-search:aminer-deep-search。

2.3 手动安装（Codex / OpenClaw / 其他 Agent）

git clone https://github.com/AMinerOrg/aminer-open-skill.git ~/ai-skills/aminer-open-skill

把需要的 skills// 整个目录放进 Agent 的技能目录：

推荐用软链接代替复制，之后在 clone 目录里 git pull 即可更新：

ln -s ~/ai-skills/aminer-open-skill/skills/aminer-free-academic ~/.codex/skills/aminer-free-academic

手动安装不会注册 slash command（命令文件依赖插件环境变量 CLAUDE_PLUGIN_ROOT），直接用自然语言触发技能即可。

2.4 Python 依赖

技能脚本需要 python3。多数技能只用标准库；下列技能需要额外安装依赖：

7 个科研工作流技能（aminer-topic-advisor-selection / aminer-paper-deep-reading / aminer-journal-paper-write-review-revise / aminer-experiment-to-paper / aminer-degree-thesis-proposal-to-defense / aminer-grant-application / aminer-patent-tech-intelligence）只依赖标准库，无需额外安装。

python3 -m pip install -r skills//requirements.txt

baseline-finder 也提供独立 CLI；按其 SKILL.md 将技能目录本身安装到隔离环境，可同时安装依赖并注册 baseline-finder 命令。

structured-reference-audit 还需要可访问的 GROBID 服务，或已有的 TEI 文件。

2.5 配置 Token

在 AMiner 控制台生成 Token，然后在 AI 助手使用的环境中配置 AMINER_API_KEY：

export AMINER_API_KEY=""

本地 Claude Code、Codex 等对话式会话可以使用仓库提供的快速配置工具：

Windows：       tools\setup-aminer-token.cmd
PowerShell：    .\tools\setup-aminer-token.ps1
macOS/Linux：   ./tools/setup-aminer-token.sh

OpenClaw 使用自己的环境配置：

openclaw config set env.vars.AMINER_API_KEY ""

独立 CLI、CI 和定时任务需要在各自运行环境中配置 Token。并非所有技能都需要 Token，配置前先查看 技能列表 的 Token 列。

2.6 Token 与计费注意事项

• 不要打印、记录或提交 AMINER_API_KEY。
• aminer-exp-extraction 调用的是智谱 BigModel API：请为它配置 BIGMODEL_API_KEY（可回退 OPENAI_API_KEY），它不使用 AMiner Token。
• AMiner 免费接口仍需 Token。建议先用 aminer-free-academic，仅在必要时调用计费 API。
• 部分任务会产生 API 费用。执行大规模检索或高成本调用前，应先查看预估成本。
• tools/ 下的配置工具只面向本地对话式环境。OpenClaw、CLI、CI 和定时任务需要单独配置。
• 如果需要直接集成 API 而不是使用 Skill，请参考 AMiner 开放平台文档。

3. 技能索引

3.1 按科研阶段选技能

3.2 易混技能怎么选

3.3 完整技能列表

当前 skills/ 下包含以下 21 个可触发技能。点击技能名查看完整技能定义。

4. 设计原则与仓库结构

4.1 共享设计原则

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

1. 引文真实性红线：检索到才写入，宁可说「未检索到」也绝不编造凑数；每条结果三态标注（已核实 / 存疑 / 查无）。
2. 学术数据优先：论文、学者、机构、期刊、专利等学术查询优先走 AMiner 开放平台；免费接口先行，计费调用先估算成本再执行。
3. 先分诊再动手：看似相同的请求实为多种任务类型，先判别类型，再按对应的输出契约执行。
4. 首答即全部：首答按请求类型给出完整产物，不靠反问澄清续命。
5. 失败显式报错：零产出的静默失败绝不发生；失败时保住已输入材料，同句重发即断点续传。
6. 交付自带下一步：每次交付末尾给出可继续的维度、待办或下一节提示。
7. 约束解析并回显：字数、条数、年份窗、模板等写进指令就是验收标准，动笔前解析回显，配额未满明说缺口。
8. 跨会话状态：同一稿件、课题或名单跨周回炉是常态，续作继承增量而不是从头重写。
9. 载体优先：引导用户贴自己的真材料（稿、数据、意见、模板）——看贴了什么，不只听说了什么。

4.2 仓库目录结构

aminer-open-skill/
├── .claude-plugin/marketplace.json   # Claude 插件清单
├── tools/                            # 本地会话的 Token 快速配置脚本
└── skills/
    ├── /
    │   ├── SKILL.md                  # 技能定义：frontmatter + 规则 + 工作流，触发后由 agent 加载
    │   ├── SKILL.zh.md               # 中文镜像（部分技能提供）
    │   ├── commands/                 # slash command（部分技能提供）
    │   ├── scripts/                  # 调用 AMiner 开放平台的工具脚本
    │   ├── references/               # 提示词与参考规则
    │   ├── evals/                    # 评测样例
    │   └── requirements.txt
    └── ...

4.3 关于贡献

本仓库技能目前由 AMiner 团队内部维护，暂不接受外部提交新技能。欢迎通过 GitHub Issues 反馈问题和需求。

5. 反馈与联系

• 使用问题与 Bug：GitHub Issues
• 邮件：[email protected]
• API 接入与计费：AMiner 开放平台

6. Star 历史

参考

• AMiner 控制台
• AMiner 开放平台文档
• Claude 插件清单
• MIT License