师弟 · shidi — 科研愿望实现器 🧑‍🔬

Your junior lab mate in an Agent Skill — ideas in, files out

中文 | English

师兄说想法，师弟跑断腿。 — You bring the ideas, shidi does the legwork.

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

shidi is a complete research workflow living inside your AI IDE — not a prompt template. Hand it an idea (literature research / experiment design / figures / paper reading / data chores), and it returns real deliverable files. Your data stays local. No platform or model lock-in.

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

It's not fire-and-forget, either — shidi is meant to be bossed around while you do something else. Yell "shidi, help me with …", and it asks when it must, runs the rest, and hands you the files.

为 AI for Science 与科研 Agent 而生 — 面向 AI4S 场景、理工科研究生与所有用 Agent 辅助科研的人：文献调研、实验方案、作图、精读,从"聊天答案"变成可交付、可交叉验证的文件。 Built for AI for Science workflows, grad students and researchers using agentic AI — deliverable, cross-verifiable files instead of chat answers.

What's New · Deliverables · Why shidi · Quick Start · Demo · Guardrails

👀 Demo · 示例预览

下图是结构示例(内容脱敏)——真实交付按你的课题动态生成,每次跑完都是新文件。 Screenshots below are illustrative (content redacted) — real runs produce fresh files for your own topic.

✨ What's New · 更新日志

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

📤 Deliverables · 交付物

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

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

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 · 为什么用它

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

🚀 Capabilities · 它能干什么

🧭 Flow · 流程图

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

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

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

    I -->|是| J["用户上传 PDF<br/>User uploads"]
    J -->|补充文献| H

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

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

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

🚀 Quick Start · 快速开始

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

然后直接说 / then just say：

师弟，帮我查一下 XX 主题的文献，要 20 篇
师弟，设计一个 XX 实验方案
师弟，把这个数据画成图
师弟，帮我把这篇论文精读一下

只喊"师弟"也行——它会先跟你确认任务类型再开工。兼容任何支持 SKILL.md 规范的 agent（Claude Code / Codex / OpenClaw / OpenCode 等）。 Just "shidi" works too — it confirms the task type before starting. Compatible with any agent that follows the SKILL.md spec.

[!IMPORTANT]

这是执行者，不是许愿池 An executor, not a genie

harness + model = agent——师弟只拥有工作流，模型决定天花板。更重要的是：师弟不替你做决定——角度选择、参数确认、方向取舍全部返回给你。脏活累活它拿走，但那个"想法"和"判断"，永远是师兄你的。 shidi owns the workflow, the model sets the ceiling. And it never decides for you — angle selection, parameters, trade-offs all bounce back to you. It takes the grunt work; the ideas and judgment stay yours.

🤖 Persona · 人设

• 称呼你为师兄（默认；你表明女性身份时称师姐）calls you "senior" by default
• 低年级师弟口吻：谦逊有分寸、自然亲近——"师兄，这是我做的 XXXX，你看要不要 XXXX" a humble, slightly cheeky junior — "here's what I made, what do you think?"
• 被你指出问题时略带崇拜（"还是师兄眼尖"），但科研判断就事论事 praises you when corrected, never bends on science
• 人设仅在"师弟"触发时生效 persona activates only on the trigger word

整个过程中你输入的轮次会比较多——只有保留了师弟没事就爱问问题的特性，你才知道你用的确实是师弟 skill :) Yes, it asks a lot of questions — that's how you know it's really shidi.

⚙️ Dependencies · 依赖

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

🛡 Guardrails · 防护机制

1. 六维评分每维封顶，总分重算 capped six-dim scoring, recomputed totals
2. 主题匹配 <10 分一票否决 topic-match <10 → veto
3. DOI / arXiv ID / URL 三级去重 triple dedup
4. 不编造：无法核验的引用/DOI/数据一律标"未验证" no fabrication — unverifiable claims are labeled "unverified"
5. 阅读状态透明：全文 ✅ / 仅摘要 ⚠ / 不可获取 ❌ honest reading-depth labels
6. 交叉验证意见逐条回应（采纳/不采纳+理由），不盲从 every verification comment gets adopt/reject + reason

📜 Credits · 致谢

设计理念借鉴 nature-skills（袁一哲团队）：Router 分层、六维评分、检索降级链、论文卡片等机制。 Design ideas borrowed from nature-skills (Yuan1z0825 team): routing, scoring, search fallback, paper cards.

📄 License · 许可证

MIT License — 随便用，记得请师弟喝奶茶 🧋 Free to use — just buy shidi a bubble tea.