IcyCreamDAS/shidi-skill

师弟 · shidi — 科研愿望实现器 🧑‍🔬
你的 Agent Skill 里的实验室小师弟 —— 想法进，文件出

License
Version
GitHub stars
Agent
Zero-Dep
PRs Welcome

师兄说想法，师弟跑断腿。 — 你出想法，师弟跑腿。

shidi 不是填模板的自动化——它是一条跑在 AI IDE 里的完整科研工作流：把脑海中的想法丢给它（文献调研 / 实验方案 / 作图 / 精读 / 数据整理），它在你的机器上跑完脏活累活，交付真实可用的文件，数据留在本地，不锁任何平台或模型。

shidi 是一条活在 AI IDE 里的完整科研工作流——不是提示词模板。把想法交给它（文献调研 / 实验方案 / 作图 / 论文精读 / 数据杂活），它返回真实可交付的文件。你的数据留在本地。不锁定任何平台或模型。

它不是放养型的。 师弟是一个你一边忙别的、一边顺手使唤的 skill：喊一嗓子"师弟，帮我……"，它该问就问、该跑就跑，跑完把文件递到你手上。

它也不是放养型的——师弟就是一个你一边忙别的、一边顺手使唤的 skill：喊一嗓子"师弟，帮我……"，它该问就问、该跑就跑，跑完把文件递到你手上。

为 AI for Science 与科研 Agent 而生 — 面向 AI4S 场景、理工科研究生与所有用 Agent 辅助科研的人：文献调研、实验方案、作图、精读，从"聊天答案"变成可交付、可交叉验证的文件。
为 AI for Science 工作流、理工科研究生以及所有用 Agent 辅助科研的人而生——交付可交叉验证的文件，而不是聊天答案。

最新动态 ·
交付物 ·
为什么用 shidi ·
快速开始 ·
示例预览 ·
防护机制

👀 Demo · 示例预览

下图是结构示例（内容脱敏）——真实交付按你的课题动态生成，每次跑完都是新文件。
下图是结构示例（内容脱敏）——真实运行会针对你自己的课题生成全新文件。

✨ What's New · 更新日志

- 2026-08 — 📥 PDF 批量下载（OpenAlex/Unpaywall 自动定位 OA 直链，失败分类报告，不静默跳过）· 批量 PDF 下载，并如实报告失败情况
- 2026-08 — 📄 多格式报告（Markdown → HTML → PDF，Edge 无头打印，零依赖）· MD → HTML → PDF 渲染，零依赖
- 2026-08 — 🔍 PDF 抽取层（文本型转 Markdown 省上下文，扫描件自动标 needs_vision 走视觉路径）· PDF 抽取层：文本型转 Markdown，扫描件走视觉路径
- 2026-08 — 🗂 分角度中间报告（多角度并行调研每角度落盘独立文件，汇总只读文件、主上下文不炸）· per-angle intermediate reports for parallel multi-agent research

📤 Deliverables · 交付物

每一单活都交付实打实的文件——不是聊天记录里的文字。
Every job ends in real files — not chat text.

📄 Final Report 最终报告（~/shidi-output/）
Markdown / Word · 完整方案或调研报告
shidi_<主题>_v3_20260814.md
├── 一、任务背景与选定方案
├── 二、实验原理（文献锚定）
├── 三、操作步骤和细节
├── 四、注意事项
├── 五、漏洞清单（不掩饰）
├── 六、文献总结（按角度分组）
├── 七、参考文献（阅读深度 ✅/⚠/❌ 标注）
└── 八、变更记录（v1→v2→v3）

✅ Cross-Verification Brief 交叉验证任务书（~/shidi-verify/）
交给另一个 LLM 的"任务书"，也是自查清单
shidi-verify_<主题>_v3_20260814.md
├── 1. 任务说明
├── 2. 原始问题（一字不改）
├── 3. 完整输出（含阅读深度）
├── 4. 验证重点（逐项检查清单）
└── 5. 输出格式要求

每次交付都长这样。你可以拿去给另一个 LLM 做独立交叉验证，验证意见逐条回应，回环迭代到满意为止。
Every delivery looks like this. Take the brief to another LLM for independent verification — every comment gets an adopt/reject + reason, loop until you're satisfied.

✨ Why shidi · 为什么用它

| 直接跟模型聊天 | 师弟 shidi |
|:--|:--|
| 答案在聊天记录里 | 交付文件：报告 / 任务书 / 图 / 数据 CSV，可直接归档、引用、发给别人 |
| 你盯着一步步催 | 完整工作流内置（检索→评分→阅读→报告→验证），问完三个参数就开跑 |
| 幻觉靠自觉 | 六维评分、DOI 三级去重、不编造红线、阅读深度标注，验证任务书强制输出 |
| 换个模型就换套行为 | 纯 SKILL.md + Markdown，Claude Code / Codex / OpenClaw 都能用 |

Left: chatting with a raw model. Right: shidi — file-based deliverables, built-in workflow, anti-hallucination guardrails, agent-agnostic.

🚀 Capabilities · 它能干什么

| Capability 能力 | 说明 Description |
|:--|:--|
| 📚 文献调研 Lit research | 三参数一次问完 → 发散 3×3=9 角度 → 顶刊定向检索+降级链 → 六维评分 → 分级阅读 → PDF 批量下载 → 文件报告 |
| 🧪 实验方案设计 Experiment design | 自由发散方案 → 文献支撑 → 原理/步骤/注意事项/漏洞清单（不掩饰） |
| 📈 科研作图 Figures | CSV/TXT/Excel → 清洗 → 计算（numpy/scipy/sympy）→ 出版级渲染，附 Origin 复刻说明 |
| 🔬 论文精读 Paper reading | source-map 六步精读 → 16 节论文卡片 → 术语表 |
| 🔄 交叉验证门（灵魂） Cross-verification | 必出验证任务书 → 交给另一个 LLM 独立验证 → 回环迭代 |
| 📋 实验记录 Lab notes | 实验 ID / 批次 ID 标准化，YAML frontmatter 归档 |

🧭 Flow · 流程图

flowchart TD
A["确定选题Decide topics"] --> B["调研文献Research"]
B --> C["三参数{数量, 领域, 特殊要求}"]
C --> D["开始搜索Search (T1→T2→T3)"]
D --> H["整合结果Merge & score"]
H --> E["学习、阅读Read (✅/⚠/❌)"]

E -->|输出| F["文献总结 ①Lit summary"]
E -->|输出| G["参考文献 ②③PDF or DOI+GB/T 7714"]

F --> I{"需要补全文?More full-texts?"}
G --> I

I -->|是| J["用户上传 PDFUser uploads"]
J -->|补充文献| H

I -->|否| K["输出最终报告Final report"]
I -->|否| L["交叉验证任务书Verify brief (always)"]
K --> M{"交叉验证?Verify?"}
L --> M

M -->|是| N["另一个 LLM 验证Independent check"]
N -->|补检/修订| D

M -->|否| O["结束Done ✓"]

🚀 Quick Start · 快速开始

git clone https://github.com/IcyCreamDAS/shidi-skill.gitbash
cp -r shidi-skill/skills/shidi ~/.claude/skills/

然后直接说 then just say：
text
师弟，帮我查一下 XX 主题的文献，要 20 篇
师弟，设计一个 XX 实验方案
师弟，把这个数据画成图
师弟，帮我把这篇论文精读一下

只喊"师弟"也行——它会先跟你确认任务类型再开工。兼容任何支持 SKILL.md 规范的 agent（Claude Code / Codex / OpenClaw / OpenCode 等）。
只喊"师弟"也行——它会先跟你确认任务类型再开工。兼容任何支持 SKILL.md 规范的 agent。

[!IMPORTANT]
这是执行者，不是许愿池 执行者，而非许愿池
harness + model = agent——师弟只拥有工作流，模型决定天花板。更重要的是：师弟不替你做决定——角度选择、参数确认、方向取舍全部返回给你。脏活累活它拿走，但那个"想法"和"判断"，永远是师兄你的。
师弟只拥有工作流，模型决定天花板。而且它从不替你做决定——角度选择、参数确认、方向取舍全部返回给你。脏活累活它拿走，但那个"想法"和"判断"，永远是师兄你的。

🤖 Persona · 人设

- 称呼你为师兄（默认；你表明女性身份时称师姐）默认称你为"师兄"
- 低年级师弟口吻：谦逊有分寸、自然亲近——"师兄，这是我做的 XXXX，你看要不要 XXXX" 一个谦逊、略带俏皮的师弟——"师兄，这是我做的 XXXX，你看要不要 XXXX？"
- 被你指出问题时略带崇拜（"还是师兄眼尖"），但科研判断就事论事 被你指出问题时会夸你，但在科学问题上绝不让步
- 人设仅在"师弟"触发时生效 人设仅在触发词"师弟"出现时激活

整个过程中你输入的轮次会比较多——只有保留了师弟没事就爱问问题的特性，你才知道你用的确实是师弟 skill :)
是的，它会问很多问题——这才说明你用的确实是师弟。

⚙️ Dependencies · 依赖

- 零外部依赖 零外部依赖：纯 SKILL.md + Markdown，无需安装任何包
- 可选增强 可选：作图分支 numpy/scipy/matplotlib/pandas/sympy（3D 用 pyvista）；PDF 抽取层 pdf-inspector
- 检索降级链 检索降级链：WebSearch → 开放学术 API（OpenAlex/Crossref/arXiv，无需 key）

🛡 Guardrails · 防护机制

1. 六维评分每维封顶，总分重算 六维评分每维封顶，总分重算
2. 主题匹配 <10 分一票否决 主题匹配 <10 分一票否决
3. DOI / arXiv ID / URL 三级去重 三级去重
4. 不编造：无法核验的引用/DOI/数据一律标"未验证" 不编造——无法核验的引用/DOI/数据一律标"未验证"
5. 阅读状态透明：全文 ✅ / 仅摘要 ⚠ / 不可获取 ❌ 阅读深度标注透明
6. 交叉验证意见逐条回应（采纳/不采纳+理由），不盲从 每条交叉验证意见都给出采纳/不采纳+理由

📜 Credits · 致谢

设计理念借鉴 nature-skills（袁一哲团队）：Router 分层、六维评分、检索降级链、论文卡片等机制。
设计理念借鉴 nature-skills（袁一哲团队）：Router 分层、六维评分、检索降级链、论文卡片等机制。

📄 License · 许可证

MIT License — 随便用，记得请师弟喝奶茶 🧋 随便用——记得请师弟喝奶茶。