SKILL 安装教程

01开始前的准备

SKILL 是一份可复用的任务说明，核心文件是 SKILL.md，也可能包含脚本、参考资料和模板。安装后，Codex 会在需要时读取这些说明，按技能约定处理你的任务。

• 已安装并登录 Codex，能在桌面端、本地 CLI 或 IDE 扩展中开始任务。
• 准备好一个本地工作目录，用来放置稿件、图表和输出文件。
• 能够访问该技能的 GitHub 仓库；先阅读项目 README 中的功能与依赖说明。

本教程面向本地使用。安装技能文件与配置其外部服务是两步：仅使用 SKILL 不代表已配置检索接口、绘图服务或其他依赖。

02获取与安装 SKILL

方式一 · 让 Codex 协助安装

如果技能列表中已有 skill-installer，先选中它。Codex 桌面端可以从技能列表选择；CLI / IDE 扩展可使用 /skills 或输入 $ 选择技能。然后发送下面的安装请求：

请从 https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-citation 安装 nature-citation，保留技能目录内的配套文件，并告诉我安装位置和需要配置的依赖。

安装结束后，确认 Codex 返回的安装目录和文件清单，再跳到安装检查。如果找不到安装器，使用下面的手动方式即可。

方式二 · 从 GitHub 手动获取

1. 打开项目仓库，选择 Code → Download ZIP，下载并解压仓库。
2. 进入解压目录中的 skills/nature-citation，确认里面有 SKILL.md。
3. 复制整个 nature-citation 文件夹，按下一节放到技能目录。请保留配套文件，并遵守仓库的开源许可。

这个仓库包含多个技能，请只复制所选技能的完整文件夹。不要只复制 SKILL.md 而漏掉它引用的资源。

03放入正确的目录

手动安装时，选择自己的系统与使用范围。个人目录中的技能可以跨项目使用；项目目录中的技能随项目组织。

%USERPROFILE%\.agents\skills

%USERPROFILE%\.agents\skills\
└── nature-citation\
    ├── SKILL.md
    ├── scripts/       （如有，完整保留）
    ├── references/    （如有，完整保留）
    └── assets/        （如有，完整保留）

Codex 在项目中会从当前工作目录向上查找 .agents/skills，直到 Git 仓库根目录。上面的项目示例将技能放在根目录，方便团队统一管理。查看官方目录规则

04确认安装与依赖

1. 检查层级。打开 nature-citation 后应直接看到 SKILL.md，避免多套一层同名文件夹。
2. 检查格式。SKILL.md 开头需要 YAML 元信息，包含 name 与 description。保留上游文件内容，文件名大小写不要改动。
3. 查看技能列表。重新打开技能选择器，搜索 nature-citation。Codex 会自动发现技能变更；若没有出现，重启 Codex 后再检查。
4. 补齐运行条件。让 Codex 阅读此技能及 README，列出需要的运行环境、脚本依赖或服务凭据，再按项目说明配置。不同技能的要求可能不同。

请检查已安装的 nature-citation：读取它的 SKILL.md 和引用的说明文件，告诉我功能、所需输入、运行依赖与缺少的配置。先做检查，不要执行正式任务。

05在 Codex 中调用

$nature-citation
为这段引言中的各项论点寻找近五年 CNS 及子刊的支撑文献，解释证据匹配程度并导出 RIS。

把任务说完整，结果更容易使用

准备输入

待补引用的段落或论点清单，以及期刊范围、年份和引用格式要求。

说明目标

写明研究主题、目标期刊或章节、语言、篇幅，以及希望保留的事实与术语。

约定输出

论点与文献对应表、引用插入建议、可导入文献管理器的文件。 可补充保存路径与文件格式。

使用 nature-citation，为这段引言中的各项论点寻找近五年 CNS 及子刊的支撑文献，解释证据匹配程度并导出 RIS。
材料位于当前项目的 inputs/ 目录。请先确认材料是否齐全；缺少信息时向我提问，将结果保存到 outputs/。

先把实际材料放入 inputs/，或在提示词中改成自己的路径。Codex 也可能按任务描述自动匹配技能；需要指定某个技能时，优先通过选择器或 $ 名称显式调用。生成结果应结合原始数据、文献和稿件逐项核对。

06常见问题