deeptutor
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 25 GitHub stars
Code Uyari
- network request — Outbound network request in scripts/robust_fetch.py
- network request — Outbound network request in tests/test_robust_fetch.py
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Academic advisor due-diligence skill for Codex, Claude Code, and other agents | 学术导师调查评估
English | 简体中文
DeepTutor
学术导师综合调查评估系统
在选择研究生导师之前,用 AI 做一次深度尽职调查。DeepTutor 自动检索导师的学术成果、学生去向、社交舆情与实验室文化,生成一份独立的 HTML 评估报告,帮你做出更明智的读研决策。
功能特色
- 10 阶段调查流程 — 身份验证 → 学生追踪 → 发表分析 → 合作网络 → 经费分析 → 社交舆情 → 行业宏观趋势 → 多维评分 → 锐评 → 报告生成
- 中国/国际双轨策略 — 自动识别机构所在地区,切换对应的搜索引擎与评估维度
- 中国导师:知乎、小木虫、百度学术、保研论坛、小红书、考研帮
- 国际导师:Reddit、RateMyProfessors、GradCafe、LinkedIn、Glassdoor
- 港澳台导师:双轨混合,兼顾 PTT、LIHKG、Dcard
- 中英双语报告 — 中文提问生成中文报告,英文提问生成英文报告;当前渲染器明确支持这两种语言
- 5 种导师类型分类 — 学术型 / 项目型 / 半放养型 / 指导型 / 纯放养型
- 天花板法则 — 学生去向是最重要的评估信号:你的上限 = 师兄师姐的上限
- PUA/PUSH 风险评估 — 从公开、可核验的学生轨迹与多源材料中排查潜在风险,不把匿名单条评价当作事实
- 导师锐评(v1.1 新增) — 7问深度剖析 + Deal-Breaker一票否决机制,不骑墙、敢下结论
- 行业宏观趋势(v1.1 新增) — 领域生命周期定位(萌芽/上升/成熟/衰退/夕阳)+ 就业前景 + 技术颠覆风险
- 退休与稳定性风险(v1.1 新增) — 评估导师在学生就读期间是否稳定
- 多导师对比模式 — 并排对比多位导师,输出综合推荐
- 独立 HTML 报告 — 单文件交付,无外部依赖,可离线浏览
- Web 访问降级(v1.3 新增) — 可在获准时调用外部 Web-Rooter 做浏览器渲染;内置抓取器仅使用固定已校验公网 IP 的标准库 HTTP(S)
- 多平台兼容(v1.4 增强) — 同时支持 Claude Code (
SKILL.md)、Codex CLI / OpenCode / OpenClaw / Aider / Cline / Roo / GitHub Copilot CLI (AGENTS.md)、Cursor (.cursor/rules/)。一份内容、多入口,由 symlink 保证不漂移 - agents.md 规范支持(v1.4 新增) — 根目录
AGENTS.md遵循 agents.md 开源规范,任何兼容工具开箱即用 - HTML 报告生成脚本(v1.3 新增) — 模型只需输出 JSON,脚本自动渲染精美 HTML 报告
- 完整版/轻量版双模式(v1.3 新增) — 自动检测模型能力,低端模型跑 6 阶段精简版,高端模型跑完整 10 阶段
- 自包含 Python 脚本(v1.3 新增) — 内置抗反爬获取 + 社交搜索 + 报告生成,零外部依赖
安装方法
# 方法一:npx(推荐,全局安装)
npx skills add jiadizhunine/deeptutor -g
# 方法二:Git Clone(Claude Code)
git clone https://github.com/jiadizhunine/deeptutor.git ~/.claude/skills/deeptutor
# Codex 手动安装则使用:
# git clone https://github.com/jiadizhunine/deeptutor.git ~/.codex/skills/deeptutor
# 方法三:手动下载
# 从 GitHub Releases 下载最新版本,解压到 ~/.claude/skills/deeptutor/
使用方法
在 Codex、Claude Code 等支持的 Agent 中直接输入自然语言即可触发调查。Codex 中也可以显式调用 $deeptutor:
帮我调查一下北京大学生命科学学院的张教授
Investigate Prof. Smith at MIT Biology department
帮我对比这三个导师:A大学的王教授、B大学的李教授、C大学的Prof. Johnson
系统会自动识别语言和地区,启动对应的调查流程,最终生成一份独立的 .html 报告。
报告示例
两份示例均为合成数据,只展示报告结构与视觉效果,不对应真实人物,也不能作为择导依据。
评估维度
DeepTutor 从 11 个维度 对导师进行量化评估(中国版本):
| # | 维度 | 权重 | 说明 |
|---|---|---|---|
| 1 | 领域宏观趋势 | 10% | 生命周期定位、资金趋势、就业前景、技术颠覆风险 |
| 2 | 发表成果与质量 | 12% | 总产出、h-index、期刊层次分布 |
| 3 | 学生培养实绩 | 13% | 毕业生去向、学位完成时间、学生发表 |
| 4 | 平台与资源 | 12% | 经费、设备、合作网络、学科排名 |
| 5 | 独立性与成长空间 | 8% | 课题自主权、一作/通讯机会 |
| 6 | 职业轨迹与势头 | 5% | 职称晋升速度、奖项荣誉、学术影响力趋势 |
| 7 | PUA/PUSH 风险 | 10% | 网络舆情、学生流失率、毕业延期比例 |
| 8 | 时间自由度 | 8% | 是否允许实习/考公/副业、作息要求 |
| 9 | 毕业目标匹配 | 7% | 导师风格与你的职业目标的契合度 |
| 10 | 导师锐评 | 10% | 7问深度剖析、Deal-Breaker一票否决、直觉综合判断 |
| 11 | 退休与稳定性风险 | 5% | 官方任期/退休安排、tenure 状态、经费到期、接班安排 |
国际版本使用经过调整的维度体系(如"Work-Life Balance"替代"时间自由度"),详见 SKILL.md。
导师类型
| 类型 | 标签 | 特征 | 适合人群 |
|---|---|---|---|
| 学术型 | Research-Focused | 追求顶刊发表,学术要求高 | 志在学术深造、追求高水平论文的学生 |
| 项目型 | Grant/Project-Driven | 横向/纵向项目多,偏应用导向 | 想积累项目经验、偏工程方向的学生 |
| 半放养型 | Semi-Independent | 适度指导,给予一定自由度 | 有一定自驱力、希望灵活安排的学生 |
| 指导型 | Mentorship-Heavy | 手把手带,会议频繁,反馈及时 | 需要结构化指导、科研新手 |
| 纯放养型 | Hands-Off | 几乎不管,靠学生自己摸索 | 目标明确且自律的学生;否则风险极大 |
项目结构
deeptutor/
├── SKILL.md # 核心技能定义(详细版,Claude Code / agentskills.io 入口)
├── AGENTS.md # agents.md 规范精简版(Codex CLI / OpenCode / Aider / Cline 等入口)
├── .claude/skills/deeptutor/SKILL.md → ../../../SKILL.md # symlink,防止漂移
├── .agents/skills/deeptutor/SKILL.md → ../../../SKILL.md # symlink
├── .cursor/rules/deeptutor.mdc # Cursor IDE 适配(短指引)
├── .opencode/AGENTS.md → ../AGENTS.md # symlink
├── .openclaw/AGENTS.md → ../AGENTS.md # symlink
├── agents/openai.yaml # Codex 展示元数据与默认提示
├── README.md # 中文说明(默认)
├── README.en.md # English README
├── LICENSE # MIT 许可证
├── THIRD_PARTY_NOTICES.md # 第三方 MIT 版权与许可声明
├── scripts/ # 自包含工具脚本(零外部依赖)
│ ├── robust_fetch.py # 固定已校验公网 IP 的安全网页获取
│ ├── search_social.py # 中国社交平台导师评价搜索
│ └── generate_report.py # JSON → HTML 报告渲染器
├── references/ # 参考文档
│ ├── advisor_evaluation_framework.md
│ ├── chinese_academic_system.md
│ ├── international_academic_system.md
│ ├── publication_search_protocol.md
│ ├── report_template.md
│ ├── web_rooter_integration.md # Web 访问降级策略
│ └── lite_mode.md # 轻量版调查规范
├── tests/ # 标准库单元与安全回归测试
└── examples/ # 虚构报告演示
├── 张伟_北京大学.html
└── sarah_mitchell_MIT.html
v1.4 设计原则:
SKILL.md(详细版)和AGENTS.md(精简版)是仅有的两份真源,分别服务两类不同生态。所有.claude/、.agents/、.opencode/、.openclaw/下的同名文件都是 symlink,写一次同步全部,无 drift 风险。
本地验证
python3 -m py_compile scripts/*.py
python3 -m unittest discover -s tests -v
GitHub Actions 会在 Python 3.9 与 3.13 上运行同一组检查。
许可证
本项目采用 MIT 许可证 开源;第三方代码声明见 THIRD_PARTY_NOTICES.md。
隐私与负责任使用
- 只使用公开、与职业相关的信息,不搜集或披露私人联系方式、家庭信息、个人账号或访问控制后的数据。
search_social.py会把查询词发送给 Bing,并在无结果时尝试搜狗;两个请求路径都复用固定公网 IP 的内置抓取器,但仍不要在查询中放入私密或敏感信息。- 搜索摘要与匿名帖子只能作为线索;严重指控必须交叉核验,并明确区分事实、指控与推断。
- 不根据姓名、照片、发表速度等代理信息猜测年龄、健康、性别或其他敏感特征。
- 报告用于辅助尽职调查,不是学术不端裁定,也不能替代与在读生、毕业生的直接沟通。
致谢
- Designed for interoperable agent environments including Codex, Claude Code, Cursor, OpenCode, and OpenClaw
- Web access helpers adapted from Web-Rooter (MIT License; see third-party notices)
- Following agentskills.io specification
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi