Skip to content
Back to search

distillation-skills

SkillWorks with Claude CodeGitHub

Claude Code 学术研究技能合集 — 深度调研 · 论文写作 · 同行评审 · 人物思维蒸馏

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dubaoxu--distillation-skills/badge.svg)](/listings/dubaoxu--distillation-skills)

HTML

<a href="/listings/dubaoxu--distillation-skills"><img src="/api/listings/dubaoxu--distillation-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 221 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. > **许可说明**:本仓库包含多种许可,学术 skill 依 CC BY-NC 4.0 发布,非全仓库 MIT;授权未明确的两个旧目录当前仅保留说明页。来源、改动和未核实事项见 [许可范围清单](THIRD_PARTY_NOTICES.md)。
  2. # Distillation Skills
  3. 学术研究与思维框架技能仓库。本次更新重点是 **Academic Research Skills v4.0.0**:将调研、写作、评审、编排合并为一个 skill,结合 Zotero、Obsidian,并提供 Claude Code / Codex 项目级入口。
  4. ## 新用户从这里开始
  5. **论文调研、写作、评审与修订,只安装 [academic-research-skills](academic-research-skills/README.md) 这一个 skill。**
  6. - 唯一推荐的学术入口:[academic-research-skills/SKILL.md](academic-research-skills/SKILL.md)。
  7. - 安装时运行该目录的 `scripts/setup_research.py`;不要把整个仓库复制进软件的技能目录,也不要逐个安装四个内部协议目录。
  8. - `paper-writing-agent` 是保留的旧版论文协调器,不是新版的必需依赖;新项目请使用统一入口。
  9. - `nuwa-skill` 与 `automation-control-framework` 是其他用途的可选内容,不随新版学术 skill 自动安装。
  10. - 根目录 `docs/` 与 `push-to-github.*` 是仓库资料和维护脚本,不是 skill 入口;新版安装说明以学术目录的 [快速开始](academic-research-skills/QUICKSTART.md) 为准。
  11. - 各目录的许可证与原作者署名继续适用,不能用根目录许可替代子目录许可。
  12. 部分旧目录因授权范围待确认已移出当前版本,只保留说明页。GitHub 显示的文件时间是该路径最近一次修改时间,未修改的目录保留原时间,不影响新版安装。
  13. ## 仓库内容
  14. | 内容 | 用途 | 许可说明 |
  15. |---|---|---|
  16. | [Academic Research Skills](academic-research-skills/README.md) | 单一入口的学术研究与论文工作流 | [CC BY-NC 4.0](academic-research-skills/LICENSE) |
  17. | [女娲 Skill](nuwa-skill/) | 人物思维方式蒸馏 | 参见目录内许可 |
  18. | [Paper Writing Agent](paper-writing-agent/) | 原有论文写作协调材料 | 当前仅保留授权待确认说明页 |
  19. | [自动化控制框架](automation-control-framework/) | 自动化与控制领域知识框架 | 当前仅保留授权待确认说明页 |
  20. 本次融合对象是 Academic Research Skills 原有的四个核心 skill;其他目录保留其原有用途。
  21. ## v4.0.0 更新
  22. - **四合一入口**:调研、写作、评审、编排融合为 `academic-research-skills`,按任务选择内部模式。
  23. - **两种论文方向**:支持综述与实验/方法类论文;综述可选叙述性、系统性或范围综述。
  24. - **Zotero 文献接入**:使用当前环境已有的实时工具,或导入 Better BibTeX JSON;修复导出对象的 `items` 数组兼容问题。
  25. - **Obsidian 协作**:导入选定目录的文献笔记,保留引用键、个人注释和材料来源。
  26. - **Claude Code / Codex**:提供跨平台项目级安装脚本,每个工具只生成一个同名 skill 入口。
  27. - **项目续接**:配置文件记录论文类型与材料路径,现有 Material Passport 保留阶段状态。
  28. ## 支持的工具与接入方式
  29. | 工具 / 环境 | 本 skill 的用途 | 接入条件与范围 |
  30. |---|---|---|
  31. | Codex(本地客户端 / CLI / IDE) | 运行统一研究、写作、评审流程 | 安装项目级 skill;需要能读取本地文件,运行脚本时需 Python |
  32. | Claude Code | 同一套流程与项目材料 | 使用 `--target claude` 安装;可与 Codex 共用项目 |
  33. | Zotero | 提供文献条目、引用键、摘要及已授权读取的材料 | 实时读取依赖另行配置的 Zotero MCP / 连接工具;也可使用离线导出 |
  34. | Better BibTeX for Zotero | 导出带引用键的文献记录 | 离线适配器读取 **Better BibTeX JSON**,不是 Better CSL JSON |
  35. | Obsidian | 导入选定目录的文献笔记,记录研究决策和草稿 | 普通 Markdown / YAML 文件即可;无需 Obsidian 社区插件,不自动同步整个 vault |
  36. | Semantic Scholar / OpenAlex / Crossref | 文献元数据查询与交叉核验 | 仓库含客户端;需要网络,鉴权、配额和限流依服务而定;元数据核验不等于原文支持核验 |
  37. | Markdown / BibTeX | 保存草稿、研究笔记与参考文献信息 | 根据现有文件和引用键工作;不自动将 Zotero 条目键当作 BibTeX 键 |
  38. | Pandoc / LaTeX 工具链(可选) | 按任务转换 DOCX、LaTeX 或 PDF | 需额外安装相应工具;未安装时提供 Markdown 和转换说明 |
  39. 安装 skill 只添加工作流程,不会同时安装 Zotero、Better BibTeX、MCP 服务、Pandoc 或 LaTeX,也不会自动获取这些服务的账号权限。
  40. ## 多平台兼容:DeepSeek Harness 等
  41. 统一 skill 使用 `SKILL.md` 与本地参考文件组织工作流,可接入具备相应 Skills 加载、文件访问和脚本执行能力的宿主。
  42. | 平台 | 安装与接入方式 | 当前验证状态 |
  43. |---|---|---|
  44. | Codex | 使用 `--target codex` 生成 `.agents/skills/academic-research-skills/SKILL.md` | 安装入口和脚本测试通过;完整论文流程待实测 |
  45. | Claude Code | 使用 `--target claude` 生成 `.claude/skills/academic-research-skills/SKILL.md` | 安装入口和脚本测试通过;完整论文流程待实测 |
  46. | DeepSeek Harness | 默认文件系统 Skills 提供器支持项目 `.agents/skills`,可复用 `--target codex` 生成的共享目录入口;也可将完整 skill 目录放入 `.dsh/skills` | 按官方目录规范接入,尚未在 Harness 中实测 |
  47. | 其他支持 Agent Skills 的软件 | 将完整 skill 目录放到该软件规定的技能目录,保留内部协议、脚本与参考文件 | 需核对该宿主的加载规则、工具权限和运行时能力;未逐一验证 |
  48. ### DeepSeek Harness 接入
  49. 在源码的 `academic-research-skills` 目录执行(参数名称 `codex` 代表现有安装器使用的共享 `.agents/skills` 目标,不限制模型厂商):
  50. ```sh
  51. python scripts/setup_research.py install --project "/path/to/project" --target codex
  52. ```
  53. 随后在 DeepSeek Harness 打开该项目,确认已启用本地 Skills 文件系统提供器和技能调用能力,查看技能目录是否出现 `academic-research-skills`,再请求它读取研究材料。若已经为 Codex 创建同一入口,可直接共用,无需重复安装。
  54. DeepSeek Harness 默认也可扫描 `<projectRoot>/.dsh/skills`。手动安装时将整个 `academic-research-skills` 文件夹复制进去;不只复制入口文件,也不要把四份内部协议分别安装。项目根目录按其提供器规则识别;存在 Git 仓库时注意入口所在位置是否与它识别的项目根一致。关闭默认扫描或使用自定义目录的环境,需要按宿主配置调整。
  55. 以上目录与提供器要求依据 [DeepSeek Harness 官方 Skills 文档](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/skill/skill-filesystem/README.md)。支持的宿主不等于对应厂商的所有聊天产品:DeepSeek 网页聊天不因此自动获得本地技能、Zotero 或 Obsidian 访问能力。多角色隔离、原文读取、网络检索和格式转换仍取决于具体运行环境。
  56. ## GPT / Codex 的 Skills 安装流程
  57. GPT 是模型;本地 skill 需要由支持 Skills 的客户端加载。本仓库优先提供 Codex 的本地项目级安装方式。
  58. ### 1. 准备源码与依赖
  59. 先安装并登录可用的 Codex 客户端或 CLI,准备 Git 和 Python 3.10+。下面的命令在系统终端执行:
  60. ```sh
  61. git clone https://github.com/Dubaoxu/distillation-skills.git
  62. cd distillation-skills/academic-research-skills
  63. python -m pip install -r requirements-dev.txt
  64. ```
  65. 如果使用下载的 ZIP,解压后进入包含 `SKILL.md` 和 `scripts/` 的 `academic-research-skills` 目录。此 v4.0.0 改版在推送前仅存在于本地预览;上述 GitHub 克隆方式在改版推送后才会取得新版。
  66. ### 2. 安装到实际工作项目
  67. Windows PowerShell 示例(替换为你自己的目录):
  68. ```powershell
  69. python scripts/setup_research.py install --project "E:/Research/my-paper" --target codex
  70. Test-Path -LiteralPath "E:/Research/my-paper/.agents/skills/academic-research-skills/SKILL.md"
  71. ```
  72. macOS / Linux 示例:
  73. ```sh
  74. python scripts/setup_research.py install --project "$HOME/Research/my-paper" --target codex
  75. test -f "$HOME/Research/my-paper/.agents/skills/academic-research-skills/SKILL.md"
  76. ```
  77. 需要 Claude Code 共用时,将 `--target codex` 改为 `--target both`。安装器输出创建的入口路径;每个工具只有一个 `academic-research-skills`。
  78. ### 3. 打开项目并调用
  79. 在 Codex 中打开第 2 步指定的工作目录并新建会话。CLI 用户可先切换到该目录,再运行 `codex`。通过技能选择器选择该 skill,或在提示中明确使用:
  80. ```text
  81. $academic-research-skills
  82. 读取当前项目的研究材料,先列出已有证据和待补材料,再制定论文计划。
  83. ```
  84. Codex CLI / IDE 可通过 `/skills` 或输入 `$` 查看技能。客户端界面可能有所不同,详见 [OpenAI Skills 官方指南](https://learn.chatgpt.com/docs/build-skills)。先用一次范围明确的小任务检查加载情况,再进入完整论文流程。
  85. ### 4. 可选:所有项目共用
  86. 项目级入口更方便控制范围。如果希望手动安装到用户级,可以将**整个** `academic-research-skills` 目录复制到 `~/.agents/skills/academic-research-skills/`,保留 `shared/`、`scripts/` 和四个内部协议目录;不要只复制 `SKILL.md`。本仓库安装脚本本身只负责项目级入口。目录约定参考 [OpenAI 官方安装说明](https://developers.openai.com/api/reference/cli)。
  87. ### ChatGPT 桌面、网页与自定义 GPT
  88. 支持独立 Skills 的 ChatGPT 桌面环境可按其提供的技能管理能力使用;网页等环境的分发方式可能需要插件。本仓库当前交付的是本地 skill,尚未发布为 OpenAI 插件,也未验证在各 ChatGPT 界面中的直接导入流程。请以 [官方 Skills 指南](https://learn.chatgpt.com/docs/build-skills) 和账号实际可用入口为准。
  89. 把 ZIP 上传到普通聊天或自定义 GPT 知识库,不代表已经安装可运行的 skill;本地 Python、Zotero 和 Obsidian 访问还需要运行环境提供对应能力。
  90. ### 加载排查与更新
  91. - 找不到 skill:核对打开的项目目录和入口文件路径,然后新建会话;确认目录没有被多嵌套一层。
  92. - 找得到入口但读不到协议:项目入口引用固定源码位置;若移动或删除源码,需重新配置该入口。
  93. - 报旧入口或文件已存在:检查并备份已有安装,再迁移旧四个入口;安装器不会覆盖用户文件。
  94. - 报缺少模块:在运行脚本所用的同一个 Python 环境执行依赖安装命令。
  95. - Zotero 不可用:先确认当前环境已配置相应实时工具;没有实时连接时,选择离线导出。
  96. - 更新:在源码仓库执行 `git pull --ff-only`(存在本地修改时先处理修改),保持源码路径不变;完整复制安装需要同步更新整份目录。更新后新建会话。
  97. ## 通用安装(Claude Code / Codex)
  98. 需要 Python 3.10+。在终端运行:
  99. ```sh
  100. git clone https://github.com/Dubaoxu/distillation-skills.git
  101. cd distillation-skills/academic-research-skills
  102. python -m pip install -r requirements-dev.txt
  103. python scripts/setup_research.py install --project "/path/to/your/project" --target both
  104. ```
  105. 将 `/path/to/your/project` 换成实际项目目录。Windows 中文路径和含空格路径请加引号。仅安装一个工具时,使用 `--target claude` 或 `--target codex`。
  106. 安装结果:
  107. ```text
  108. project/
  109. ├── .agents/skills/academic-research-skills/SKILL.md
  110. └── .claude/skills/academic-research-skills/SKILL.md
  111. ```
  112. 每个工具发现的是同一个 skill。入口引用此源码目录,请保留源码位置。安装器不会覆盖已有入口;若检测到原四个 skill 的旧入口,会提示先迁移,避免出现五个并存的入口。当前改版使用本地脚本安装,不使用上游 marketplace 安装命令。
  113. ## 开始使用
  114. 直接告诉工具你要做什么:
  115. ```text
  116. 使用 academic-research-skills,结合我的 Zotero 文献和 Obsidian 笔记,
  117. 围绕研究问题进行文献梳理,然后制定论文大纲。
  118. ```
  119. 也可以只做一个阶段:
  120. - “评审这篇实验论文,重点检查方法、数据与结论是否一致。”
  121. - “根据这些材料写系统综述大纲,标出尚缺的检索与筛选记录。”
  122. - “根据审稿意见修改论文,并整理逐条回复。”
  123. - “读取项目配置和 passport.yaml,继续上次的论文流程。”
  124. 无需切换四个独立 skill;单阶段请求也不会强制启动完整流程。
  125. ## 初始化论文项目
  126. 系统综述:
  127. ```sh
  128. python scripts/setup_research.py init --directory "/path/to/project/my-review" --paper-type review --review-kind systematic --title "论文题目"
  129. ```
  130. 实验/方法类论文:
  131. ```sh
  132. python scripts/setup_research.py init --directory "/path/to/project/my-paper" --paper-type empirical --title "论文题目"
  133. ```
  134. 综述类型可选 `narrative`、`systematic`、`scoping`。可添加 `--vault "/path/to/vault"` 记录 Obsidian 位置;这不会自动扫描或修改整个笔记库。
  135. ## 能力与验证边界
  136. - Zotero 实时接入依赖当前工具环境;离线适配器不提供自动双向同步。
  137. - 文献元数据、摘要、个人笔记与原文证据分别处理,不把导入成功等同于引文核验通过。
  138. - 不虚构实验、数据或系统综述筛选数量;缺失证据会保留为待完成项。
  139. - 模拟评审不等于真实期刊评审;独立盲审所需的隔离调用必须由运行环境实际提供。
  140. - 当前相关测试 **265 项通过**;1 项因 Windows 符号链接权限未运行。统一入口、内部引用和解压后安装已验证;尚未完成两种工具中的真实论文全流程与实时 Zotero 联调。
  141. ## 文档与反馈
  142. - [学术 skill 说明](academic-research-skills/README.md)
  143. - [统一入口文件](academic-research-skills/SKILL.md)
  144. - [快速开始](academic-research-skills/QUICKSTART.md)
  145. - [版本记录](academic-research-skills/CHANGELOG.md)
  146. - [提交问题](https://github.com/Dubaoxu/distillation-skills/issues)
  147. ## 致谢与许可
  148. 学术研究部分基于 [Imbad0202/academic-research-skills](https://github.com/Imbad0202/academic-research-skills),原作者 Cheng-I Wu;女娲部分来源与作者说明参见其目录。感谢原作者及相关开源项目。
  149. 仓库各部分许可可能不同,请分别查看目录内 LICENSE 和文件声明。根目录许可不替代学术研究部分的 CC BY-NC 4.0 等独立许可。v4.0.0 是本仓库整合版编号。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.