ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

如何用 academic-research-skills-codex 在 5 分钟跑通第一个学术研究任务

如何用 academic-research-skills-codex 在 5 分钟跑通第一个学术研究任务

如何用 academic-research-skills-codex 在 5 分钟跑通第一个学术研究任务

【免费下载链接】academic-research-skills-codexCodex-native Academic Research Skills suite for human-in-the-loop academic research workflows项目地址: https://gitcode.com/gh_mirrors/ac/academic-research-skills-codex

academic-research-skills-codex(下称 ARS-Codex,当前包版本3.24.0)是一个 Codex 原生的学术研究技能插件:两条命令装完,深度研究、文献综述、论文写作、模拟同行评审、研究筛选、实验规划 6 个工作流,一句$academic-research-suite调用即可开工。下面先看装好之后的一次真实调用长什么样、预期输出是什么,再倒推安装命令。

装好之后长什么样:先做这个冒烟演示

先看预期效果。开启一个全新的 Codex 对话,输入:

/skills

看到只有1 条academic-research-suite(或ARS-Codex)条目,说明它以单一路由技能注册成功;你不应该看到独立的academic-paper、deep-research条目——它们都打包在这一个技能里。

接着贴上这段提示词:

Use $academic-research-suite. I want to write a paper on AI adoption in higher education quality assurance. I do not yet have a clear research question.

看到它先进入deep-research的 Socratic 模式,抛出澄清式追问帮你收敛研究问题、而不是立刻甩给你一篇大纲,说明路由正常工作。"人类掌舵、AI 执行细节"的节奏贯穿所有工作流。

两条命令装完 ARS-Codex

打开终端,贴入下面两行添加插件市场并安装:

codex plugin marketplace add Imbad0202/academic-research-skills-codex --ref main codex plugin add ars-codex@ars-codex

完成后开新对话跑一遍/skills验证。不想用插件市场,也可以把技能直接放进技能目录:

git clone https://gitcode.com/gh_mirrors/ac/academic-research-skills-codex cp -r academic-research-skills-codex/skills/academic-research-suite ~/.codex/skills/

看到~/.codex/skills/academic-research-suite/下出现SKILL.md和ars/目录,说明复制成功。前置条件只有两项:能正常启动 Codex CLI(或 Codex Desktop);插件默认输出 Markdown,没有强制依赖,走直接复制路线时环境里有python3更方便(引用核验等工具链里有配套脚本)。

装完没反应先看这里

别慌,大多是两个坑:

  • 旧对话缓存旧技能。/skills里看不到 ARS 条目时,开一个全新对话再试。
  • 看到academic-paper、deep-research等独立条目,说明重复注册:删掉旧的~/.codex/skills/academic-research-suite再复制一次。

另有两条无害警告,不代表安装失败:⚠️[features].codex_hooks is deprecated——ARS 日常使用不依赖 hooks,方便时更新 Codex 配置即可;hooks need review before they can run——这些 hooks 只作为上游溯源元数据保留,Codex 不会安装它们。

路由会分流的 6 个工作流,和 ars-* 别名

所有请求都走 skills/academic-research-suite/SKILL.md 这一个入口,按意图分流,每个工作流目录下都有WORKFLOW.md定义文件:

工作流什么时候用
deep-research研究问题打磨、文献综述、系统综述、Meta 分析、事实核查
academic-paper大纲、初稿、摘要、修改、引用格式、AI 使用披露
academic-paper-reviewer稿件评审、模拟同行评审、编辑决定信、复审
academic-pipeline带完整性门禁的"研究→写作→评审→修改"端到端全流程
sr-screener研究筛选、裁决、排除审计(仅在显式请求时启动)
experiment-agent代码实验规划、人类研究方案、统计解读、可复现性验证

高频别名(ars/commands/ 下共 16 条):ars-plan写作规划、ars-outline仅出大纲、ars-reviewer完整模拟评审、ars-full启动端到端流水线。用法形如Use $academic-research-suite: ars-plan my paper on AI governance in universities.

💡 效果最好的调用是四要素句式:目标 + 现有材料 + 现在要什么 + 约束,例如 "Goal: write a journal article. Current materials: I have a literature matrix and rough findings, but no outline. Output needed now: paper architecture and missing-evidence checklist. Constraints: English, APA 7."

从一个话题到全流程:进阶入口

  • 想看真实流水线,读 examples/codex/full-pipeline-heqa-scope-transformation/README.md:6 个阶段、两次完整性门禁(Stage 2.5/4.5),各阶段判定都在stages/目录里。
  • 安装细节与完整别名表见 ars/docs/SETUP.md,管道架构见 ars/docs/ARCHITECTURE.md。
  • 📌 可选的完整运行时适配器(planner、agent-team 模板、hook 包)在skills/academic-research-suite/codex/下,默认关闭,细节见 CODEX_FULL_RUNTIME_ADAPTER.md。
  • 更新插件:执行codex plugin marketplace upgrade ars-codex和codex plugin add ars-codex@ars-codex两行,再开新对话。

现在就把那两条安装命令跑起来。

【免费下载链接】academic-research-skills-codexCodex-native Academic Research Skills suite for human-in-the-loop academic research workflows项目地址: https://gitcode.com/gh_mirrors/ac/academic-research-skills-codex

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进