前言¶
学位论文答辩前，常见做法是请同学互评或自己对照 checklist 改稿。这类方式往往只有单一视角，很难还原答辩委员会里「方法论老师盯实验、创新老师挑对比、写作老师看结构」的分工。若希望 Agent 按固定流程拆论文、并行给出差异化意见，并把录音里的导师风格沉淀下来，需要一套可复用的 Skill 约定，而不是每次手写长提示词。
下面介绍 SkillHub 上的 JoyDefense（坐标 @user_654514e9/joy-defense，包内 Skill 标识为 defense-thesis）。它把「解析论文 → 多导师并行评审 → 汇总报告」写成标准 SKILL.md 工作流，并附带可选的本地解析与转写脚本。
这是什么¶
JoyDefense 是社区来源（community）的 Agent Skill，当前版本 1.0.0，由发布者 user_654514e9 维护。SkillHub 分类为 it-ops-security，但包内 meta.json 将领域标为学术场景（domain: academic，use_case: thesis_defense_review），实际定位是：输入一篇论文，模拟多位导师从判断、管理、人格风格三个维度审阅，并输出差异化报告。
官方入口：
- API / 资源地址：https://api.skillhub.cn/user_654514e9/joy-defense
- SkillHub 页面：https://www.skillhub.cn/skills/user_654514e9/joy-defense
页面公开元数据中 description / summary 为空，具体能力以安装后的 SKILL.md 与 tools/ 为准。标签 requires_api_key=false，主流程不依赖第三方 API Key；语音转写走本地 Whisper 时需自行安装依赖。
核心功能¶
以下能力均来自包内 SKILL.md 与 tools/README.md。
多顾问协调流程¶
- 论文输入：文件路径或粘贴文本。
- 结构解析：拆出标题、摘要、研究问题、创新点、方法、结果、图表、写作质量、参考文献等字段，供后续评审使用。
- 并行评审：对每位已注册导师分别生成 Judgment（判断）、Management（管理关注点）、Persona（风格与互动偏好）三部分。
- 整合输出：汇总各导师意见，并给出共识点、分歧点与最高优先级修改项；还可包含针对各导师的追问与应答策略。
内置三位导师（可扩展）¶
| 代号 | 侧重 | 追问风格（文档描述） |
|---|---|---|
| zhang | 方法论 / 实验设计 | 统计严谨性、可重复性；精确、数据驱动 |
| li | 创新性 | 新颖性与文献对比；直接挑战创新点 |
| wang | 写作 / 结构 | 清晰度、逻辑与图表；建设性建议 |
通过 /add-advisor、/remove-advisor、/list-advisors、/update-advisor 管理导师列表；/update-advisor {代号} --input 与 --audio 可把录音转写与论文上下文蒸馏进对应导师档案（每次只更新一位导师）。
本地工具（可选）¶
tools/thesis_parser.py：从.txt/.md/.pdf解析论文为结构化 JSON（PDF 需pdfplumber或PyPDF2）。tools/audio_transcriber.py：本地 Whisper 转写答辩录音，输出 JSON，供advisor_updater.py使用。tools/advisor_updater.py：合并导师评审风格并备份到versions/。
未经过蒸馏、且 is_trained: false 的导师，会回退到 prompts/generic_advisor_style.md 中的通用评审风格。
触发方式¶
Skill 文档列出的触发短语包括：
/defense-thesis- 「帮我审这篇论文」「多导师审阅」「模拟答辩委员会评审」
allowed-tools 为 Read、Write、Edit、Bash；user-invocable: true。
安装与启用¶
安装须使用 SkillHub CLI，并用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能无法被识别。完整说明见 https://skillhub.cn/install/skillhub.md。
1、检查或安装 CLI¶
command -v skillhub && skillhub --version
未安装时可执行（节选官方推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 JoyDefense¶
社区包需带 namespace，与 SkillHub 检索结果一致：
skillhub install joy-defense --namespace user_654514e9 --dir <你的 Agent skills 目录>
常见路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装成功后，目录形如 @user_654514e9/joy-defense/，内含 SKILL.md、advisors/、prompts/、tools/。
也可让 Agent 按官方提示安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_654514e9/joy-defense`。
安装后按所用客户端要求刷新或重启，使新 Skill 被加载。
3、可选：Python 工具依赖¶
若使用 PDF 解析或本地转写，在 Python 3.8+ 环境中按需安装：
pip install pdfplumber PyPDF2 whisper
# audio_transcriber 另需系统已安装 ffmpeg
典型用法¶
场景一：多导师审阅一篇论文¶
在已启用 Skill 的 Agent 对话中，提供论文路径或正文，并使用触发语（如「模拟答辩委员会评审」）。Agent 应按 SKILL.md 执行解析 → 并行三位导师评审 → 输出含共识与分歧的汇总报告。
场景二：用录音更新某位导师风格¶
先转写录音（示例来自 tools/README.md，路径请改为你本机安装目录）：
python tools/audio_transcriber.py --input /path/to/presentation.wav --output /path/to/result.json --model base
再更新指定导师档案（SKILL.md 示例）：
python tools/advisor_updater.py --advisor zhang --input thesis.pdf --audio review.txt
对话侧也可使用：
/update-advisor zhang --input <论文文本> --audio <录音文本路径>
系统会确认「这是哪位老师的审阅意见」，仅更新所选导师的 judgment.md、management.md、persona.md 等文件。
场景三：仅解析论文结构¶
python tools/thesis_parser.py --input /path/to/thesis.pdf
stdout 为结构化 JSON，供人工检查或接入后续流程。
适用场景与注意¶
适合谁
- 准备学位论文答辩、希望提前获得多视角书面反馈的学生或研究者。
- 需要把真实答辩录音里的提问风格沉淀为可复用「导师 persona」的团队（需自行维护导师代号与档案）。
限制与注意
- SkillHub 列表页未提供详细简介，安装前难以从网页 alone 判断能力边界；建议安装后阅读
SKILL.md。 - 分类 it-ops-security 与包内学术标签不一致，检索时勿仅凭分类过滤。
tools/README.md中部分示例路径为作者本机路径，使用时应改为你的joy-defense安装目录。- Whisper 与 PDF 依赖需本地自行安装；大模型审阅质量仍取决于所用 Agent 与模型，Skill 提供的是流程与提示结构，不替代正式学术评议。
- 据 SkillHub 抓取元数据（2026-10-21）：下载约 964 次，安装计数 0，评分字段 100000（平台内部展示值）；以 SkillHub 页面实时数据为准。
结尾¶
JoyDefense 把「多导师、分维度、可蒸馏」的答辩审阅流程固化成 Agent Skill，并配上可选的论文解析与录音转写工具，适合在答辩前做结构化预演。若需安装或查看坐标，请访问 SkillHub 页面：https://www.skillhub.cn/skills/user_654514e9/joy-defense ，资源地址：https://api.skillhub.cn/user_654514e9/joy-defense 。
