WenyuChiou/ai-research-skills · 上手攻略
- 仓库：WenyuChiou/ai-research-skills
- 链接：https://github.com/WenyuChiou/ai-research-skills
- 分类：AI 工具链 · 研究工作流
- 作者：Tom
- 更新：2026-09-01
是什么
ai-research-skills 是一个 SKILL.md 技能目录，面向研究者和 AI Agent 构建者。它收录了 17 个可移植的 SKILL.md 规范，覆盖文献检索、文献整理、研究设计、项目记忆化、手稿写作、跨 Agent 委托等完整研究流程。支持 Claude Code、Codex CLI、Cursor、Windsurf、Gemini CLI、OpenClaw 等多种 AI 宿主。
⚠️ 注意：ai-research-skills 本质上是一个技能清单注册表，而非单一代码仓库——每个技能的源代码实际分布在各自独立的仓库中（research-hub、academic-writing-skills、zotero-skills 等）。
解决什么问题
- 痛点 1：AI 写代码很强，但做学术研究时缺乏结构化工作流——文献管理、研究设计、数据分析、手稿写作各自孤立，无法形成可审计的完整链路
- 痛点 2：每个 AI 工具（Claude Code / Codex / Cursor）有自己的 skill 加载方式，没有统一标准
- ai-research-skills 的方案：提供 17 个标准化 SKILL.md，每个 skill 有明确输入/输出/适用阶段，组成 8 阶段研究生命周期
8 阶段生命周期： 1. Discover lit（文献发现） 2. Organise & compare（整理比较） 3a. Frame（研究问题建模） 3b. Plan（研究计划） 4. Build model（建模） 5. Run & validate（运行验证） 6. Visualise（可视化） 7. Draft manuscript（起草手稿） 8. Submit, respond, wrap up（投稿与收尾）
快速安装
Claude Code 最快路径（30 秒）
# 安装市场插件
claude plugin marketplace add WenyuChiou/ai-research-skills
# 安装 12 个核心研究技能
claude plugin install research-workspace@ai-research-skills
# 验证安装
claude plugin list
# 确认 research-workspace@ai-research-skills 显示 ✔ enabled
⚠️ 注意：上述两条命令需要分开执行（Windows cmd.exe 下尤需注意）；若 plugin list 未出现 research-workspace，说明第二条未执行，需重跑。
分步增量安装
# 步骤 1：市场 + 12 个 research-hub 技能（必须）
claude plugin marketplace add WenyuChiou/ai-research-skills
claude plugin install research-workspace@ai-research-skills
# 步骤 2：手稿写作技能（可选，含润色、证据审计）
claude plugin install academic-writing-skills@ai-research-skills
# 步骤 3：Zotero CRUD 操作（可选，需先在 Zotero Desktop 开启本地 API）
claude plugin install zotero-skills@ai-research-skills
# 步骤 4：多 CLI 委托（可选，需先安装 codex / agy CLI）
claude plugin install codex-delegate@ai-research-skills
claude plugin install antigravity-delegate@ai-research-skills
# 步骤 5：文献流水线自动化（可选，需要 Python）
pip install research-hub-pipeline
research-hub setup --persona researcher
research-hub doctor
research-hub auto "agent-based modeling" --max-papers 3 --no-nlm
一键安装脚本
# macOS / Linux / git-bash
bash scripts/install-all.sh
# Windows PowerShell
pwsh scripts/install-all.ps1
⚠️ 脚本安装前建议检查脚本内容，确认无恶意操作后再执行。
手动 clone（非 Claude Code 用户）
git clone https://github.com/WenyuChiou/ai-research-skills.git
cd ai-research-skills
# 然后按 docs/install.md 的说明，将对应 SKILL.md 加载到你的 AI 宿主
核心用法
17 个技能速览
| 技能名 | 阶段 | 功能 |
|---|---|---|
| research-hub | 1, 2, 4, 5 | 搜索 arXiv/Semantic Scholar/CrossRef/PubMed，写笔记到 Obsidian |
| zotero-skills | 1, 2 | Zotero 条目增删改查、标签管理、去重 |
| literature-triage-matrix | 2 | 按方法/数据/论点/局限性比较论文，不需要读完全部 PDF |
| gap-to-topic | 2 | 选题三门决策（gap 是否存在？贡献是否清晰？可行性如何？） |
| notebooklm-brief-verifier | 2 | 验证 NotebookLM 摘要与源文件包的一致性 |
| research-design-helper | 3a | Socratic 对话，5 段式产出 design_brief.md |
| research-context-compressor | 3b, 5 | 生成 project_manifest.yml、experiment_matrix.yml 等机器可读文件 |
| research-project-orienter | 3b | 新 AI 会话或跨会话时，快速生成项目方向备忘录 |
| codex-delegate | 跨阶段 | 委托 Codex CLI 执行测试 harness、批量编辑等代码任务 |
| antigravity-delegate | 跨阶段 | 委托 Antigravity 执行有边界的 fixture 维护 |
| research-hub-multi-ai | 跨阶段 | 多 AI 路由协调，写 multi_ai_plan.md |
| academic-writing-skills | 7 | 大纲起草、正文撰写、证据审计、科学审稿 |
⚠️ 注意：上表为部分核心技能节选，完整 17 个技能清单见仓库 README 或 docs/pipeline.md。
research-hub pipeline 命令示例
# 设置研究者角色
research-hub setup --persona researcher
# 运行诊断（检查环境是否就绪）
research-hub doctor
# 自动抓取文献并写笔记
research-hub auto "transformer attention mechanism" --max-papers 5 --no-nlm
⚠️ research-hub CLI 需要 pip install research-hub-pipeline，且 --no-nlm 表示不使用 PubMed NLM 接口（某些地区可能需要代理）。
跨 Agent 委托示例
# 前提：已安装 codex CLI
claude plugin install codex-delegate@ai-research-skills
# 在 Claude Code 对话中触发 Codex 委托
# "请用 Codex 写一个针对这个模型的测试 harness"
# → Claude Code 调用 codex-delegate skill → 生成代码交回
典型适用场景
- 硕博研究生：有完整研究流程（开题→文献→设计→实验→写作）需要 AI 辅助但不想每步都重新配置 prompt
- 研究团队：多人协作时，每个成员加载相同的 SKILL.md 规范，保证研究上下文传递一致性
- AI Agent 开发者：构建研究类 Agent 时，直接复用 17 个标准化 skill 作为构建模块，而非从零设计
- 跨工具迁移：已在用 Claude Code，想迁移到 Codex 或 Cursor 时，skill 文件格式保持兼容，减少重配置成本
坑与注意
⚠️ 这是一个注册表，不是 monorepo：README 明确说明每个 plugin 的源代码在各自独立仓库。clone 本仓库只能看到 skill 索引和安装脚本，不能当成完整代码库使用。
⚠️ OpenClaw 支持"未发布验证"：README §"OpenClaw" 写明"not release-verified here yet"，即 OpenClaw 用户使用 SKILL.md 格式时，可能存在兼容性问题，建议先测试再正式用于重要任务。
⚠️ Python 环境要求：pipeline 自动化部分（research-hub CLI）需要 Python ≥3.9，非 Python 用户只能使用 skill 规范，无法使用自动化 CLI。
⚠️ Zotero 本地 API：zotero-skills 需要 Zotero Desktop 开启本地 API（默认端口 23119），未开启则 CRUD 功能全部失效，详见 docs/setup-guide.md §C。
⚠️ Windows PowerShell：Windows 用户需分开执行两条 plugin 命令，不能合并为一行，否则可能只有第一条生效。
⚠️ marketplace 验证局限：claude plugin list 只验证 Claude Code marketplace 安装状态，不反映 Codex/Cursor/OpenClaw 等其他宿主是否真正加载了 SKILL.md。
与同类对比
| 工具 | 类型 | 技能数 | 跨宿主 | 研究生命周期覆盖 |
|---|---|---|---|---|
| ai-research-skills | SKILL.md 目录 | 17 | ✅ Claude/Codex/Cursor/Gemini/OpenClaw | 8 阶段全链路 |
| LangChain Agents | 代码框架 | 框架内置 | ⚠️ 需适配 | 无特定研究阶段 |
| AutoGPT / BabyAGI | 通用 Agent | 0 | ❌ | 无结构化研究流 |
| Zotero + note 插件 | 文献管理 | 0 | ⚠️ 仅 Zotero | 仅 Stage 1 |
| 科研 AI 助手（类似工具） | 单点 AI | 1-3 | ⚠️ 单一宿主 | 部分阶段 |
ai-research-skills 的核心优势是标准化与可移植性——17 个 SKILL.md 是纯文本规范，跨 AI 宿主迁移成本极低，适合需要多工具协作的研究者。
一句话推荐结论
如果你需要一套跨 AI 工具的标准化研究工作流，从文献检索到手稿写作全程可追溯、可复用，ai-research-skills 是目前最完整的 SKILL.md 技能目录——⚠️ 但它是一个技能规范注册表而非独立应用，且 OpenClaw 兼容性尚未发布验证，使用前建议先小范围测试。
Sources: GitHub README, docs/pipeline.md, docs/install.md, docs/for-agent-harness-builders.md · 字数：~2,400 CJK