AI工具

academic-research-skills 实操：安装、文献综述、引用核验与卸载

在 Claude Code 中安装 academic-research-skills，运行一份小型文献综述，检查引用和输出文件，并处理插件未发现、Shell hook 报错及安全卸载。

academic-research-skills 把研究规划、文献综述、论文写作、审稿和修订拆成 Claude Code Skills。它能减少资料整理工作，但不会替研究者决定问题、方法或结论。

下面用一个小型研究问题跑通安装、输出和引用核验，重点检查它是否真的生成了可追踪材料，而不是只返回一段流畅摘要。

安装前检查

项目推荐 Claude Code 3.7.0 或更高版本的插件安装方式：

1
2

claude --version
git --version

如果要导出 DOCX 或 PDF，还需要 Pandoc、Tectonic 等可选工具；只生成 Markdown 时不必先安装全部排版依赖。

推荐的插件安装方式

在 Claude Code 中依次执行：

1
2

/plugin marketplace add Imbad0202/academic-research-skills
/plugin install academic-research-skills

重新启动 Claude Code 后运行：

1

/ars-plan

成功标准是进入围绕研究主题和文章结构的引导对话。如果命令不存在，先检查插件是否安装成功以及客户端版本，不要立即把整个仓库复制进一个嵌套的 Skill 目录。

该仓库包含多个独立 Skill，各自拥有 SKILL.md。错误地放成 .claude/skills/academic-research-skills/<skill>/SKILL.md，可能导致 Claude 无法按预期发现它们。

建立一个最小研究目录

示例问题：远程办公是否影响软件团队的代码评审周期？

1
2
3
4
5
6

remote-review-study/
├── input/
│   └── scope.md
├── output/
├── verified-sources.csv
└── research-log.md

scope.md 写清楚边界：

1
2
3
4
5
6
7
8

# Research scope

- Population: professional software development teams
- Intervention: remote or hybrid work
- Outcome: pull request review time
- Time range: 2020-2026
- Allowed sources: peer-reviewed papers and official datasets
- Exclude: unsourced blog posts and vendor marketing claims

运行文献综述

可以先运行单次综述命令：

1

/ars-lit-review "remote work pull request review time software teams"

随后补充约束：

1
2
3
4
5

读取 input/scope.md。
先输出检索式、纳入标准和排除标准，再整理候选文献。
每条候选文献必须包含标题、作者、年份、DOI 或稳定 URL。
无法验证 DOI 时标记 unverified，不得生成替代 DOI。
把结果写入 output/literature-review.md 和 verified-sources.csv。

不要一开始就运行整套论文流水线。先用 5 到 10 篇候选文献检查来源质量，能更快发现检索和引用问题。

验收输出文件

完成后检查：

1
2

find output -maxdepth 2 -type f -print
git diff -- output verified-sources.csv research-log.md

PowerShell：

1
2

Get-ChildItem -LiteralPath '.\output' -Recurse -File
git diff -- output verified-sources.csv research-log.md

合格输出至少包含检索范围、候选来源、纳入/排除理由、未验证项目和生成日期。如果只有一篇没有出处的综述正文，说明流程尚未通过。

引用失败案例怎么处理

假设输出出现：

1
2

Smith et al. (2024) found that remote teams reduced review time by 23%.
DOI: 10.0000/example.2024.12345

核验步骤：

  1. 访问 DOI 解析器或 Crossref 检索 DOI。
  2. 比对标题、作者和年份。
  3. 打开论文原文，确认“23%”对应相同指标和研究对象。
  4. 任一环节失败，就把该记录标记为 unverified，不得用于结论。

verified-sources.csv 可使用：

1
2

title,authors,year,doi,url,status,checked_at,notes
Example paper,Smith et al.,2024,10.0000/example.2024.12345,,unverified,2026-08-02,DOI did not resolve

模型可能给出真实存在的论文，却把另一篇论文的结果归到它名下。因此“DOI 能打开”只是第一关，还要核对具体主张。

让审稿 Skill 攻击结论

当文献表通过人工抽查后，再运行审稿流程。要求审稿人重点寻找：

  • 检索范围是否遗漏反对证据；
  • review time 的定义是否跨研究一致；
  • 相关性是否被写成因果关系；
  • 样本是否只来自少数开源项目；
  • 未验证来源是否进入正文。

审稿输出应保存成独立文件，不要直接覆盖原稿。这样才能比较修改前后的证据变化。

Windows 下 Shell hook 报错

项目包含可选 Shell hook。没有 Git Bash 时，PowerShell 不能直接运行 .sh launcher，可能出现每次调用都记录 hook 错误的情况。

处理办法是安装 Git for Windows 并确认 Git Bash 可用，或按项目文档关闭该可选 guard。不要把 hook 报错误判为所有研究 Skill 都失效；先用 /ars-plan 和输出文件验证核心能力。

更新与回滚

插件更新前记录当前版本和一次可用输出。更新后用同一个小主题复测，比较命令是否存在、文件结构是否改变、引用核验规则是否仍然生效。

如果新版异常，先保存日志和插件版本，再通过 Claude Code 插件管理界面卸载并重装。不要删除整个 .claude 目录，其中可能还有其他项目配置。

安全卸载

通过插件管理命令或界面卸载 academic-research-skills，然后重启 Claude Code，确认 /ars-plan 不再注册。研究项目中的 Markdown、CSV 和日志属于用户文件，不应随插件一起删除。

如果采用手动 symlink 安装，只删除指向该仓库的四个链接，并在操作前确认目标确实是符号链接，避免误删真实目录。

使用边界

  • 未验证引用不能进入最终论证。
  • 涉及受试者或敏感数据时仍需遵守伦理审查和数据政策。
  • Skill 的质量门禁不能替代领域专家复核。
  • 不应用“写作风格调整”掩盖 AI 使用或规避学术诚信要求。
  • 最终作者必须能够解释方法、数据和每条主要结论。

参考资料：