Stephen-studying/defense-beating-simulator
GitHub: Stephen-studying/defense-beating-simulator
一个可移植的 Agent Skill,通过证据链审查、连续追问和材料修复帮助用户为项目答辩做系统性准备。
Stars: 0 | Forks: 0
# 针对性答辩模拟器
**项目答辩证据链审查与连续追问 Agent Skill**
先核对“项目说法有没有证据”,再模拟评委追问,最后给出稳妥回答和材料修复动作。
[](LICENSE)
[](SKILL.md)
[](#兼容性)
[](#项目验证)
[核心能力](#核心能力) · [实际案例](#实际案例) · [快速开始](#快速开始) · [安装](#安装) · [仓库结构](#仓库结构) · [English](README.en.md)
## 30 秒看懂
`defense-beating-simulator` 不是普通的“答辩问题生成器”。它先审查 README、PPT、报告、代码结构、数据说明和结果图中的证据链,再决定哪些问题值得追问。
项目说法 → 材料证据 → 证据缺口 → 答辩风险 → 连续追问 → 稳妥回答 → 材料修复
默认结果直接在对话中反馈,不会擅自生成一批 Markdown 文件。只有用户明确要求导出时,才使用 `assets/` 中的模板生成材料包。
## 核心能力
| 能力 | 具体作用 |
| --- | --- |
| Claim-Evidence Matrix | 逐条核对项目说法与 README、PPT、报告、代码或图表证据 |
| 高风险缺口 | 找出最容易被追问的数据、贡献、创新、边界与复现问题 |
| 连续追问链 | 围绕同一缺口连续追问 2–4 层,而不是堆一串散题 |
| 防守型回答 | 承认真实边界、说明已有依据、突出本人贡献,不替用户编造事实 |
| 材料修复 | 明确应该补 README、PPT、报告、演示脚本还是简历表述 |
| 回答评分 | 按正面回应、技术细节、证据、贡献边界和表达清晰度评分 |
完整审查固定按以下顺序输出:
1. 项目一句话定位
2. Claim-Evidence Matrix
3. 高风险缺口(最多 5 项)
4. 连续追问链
5. 防守型回答策略
6. 材料修复清单
7. 答辩速查卡
### 证据标签
| 维度 | 标签 | 含义 |
| --- | --- | --- |
| 证据状态 | `Material-supported` | 材料明确支持 |
| 证据状态 | `Material-implied` | 材料仅间接暗示 |
| 证据状态 | `Material-missing` | 材料出现了该说法,但没有给出支撑 |
| 风险依据 | `Material-derived` | 风险直接来自材料矛盾、遗漏或限制 |
| 风险依据 | `Risk-inferred` | 根据答辩经验推断,不能当作材料事实 |
### 提问强度
| 等级 | 适合阶段 | 提问方式 |
| --- | --- | --- |
| 先热个身 | 初次梳理项目 | 先确认定位、材料和基础理解 |
| 开始挑刺 | 常规答辩准备 | 系统追问数据、方法、结果、贡献和边界 |
| 严刑拷打 | 正式答辩前压测 | 集中攻击最高风险缺口,进行多层连续追问 |
“严刑拷打”只提高问题锋利度,不降低证据标准,也不包含人身攻击。
## 实际案例
以“校园综合能源系统源网荷储展示平台”为例。材料说明网页展示光伏、负荷、储能 SOC 和能量流,数据来自典型工况与课程假设,尚未提供真实校园数据、后端接口或优化模型。
| Claim / 项目说法 | Evidence / 材料依据 | Evidence status / 证据状态 | Gap / 缺口 | Risk basis / 风险依据 | Risk |
| --- | --- | --- | --- | --- | --- |
| 网页能够展示源网荷储典型日运行状态 | 项目摘要中的功能说明 | `Material-missing` | 只有功能自述,缺少运行截图与复现步骤 | `Material-derived` | Medium |
| 项目属于“仿真平台” | 项目名称与简介 | `Material-missing` | 未说明 SOC、功率平衡和调度结果如何计算 | `Material-derived` | High |
| 数据来自典型工况与课程假设 | 项目摘要中的数据说明 | `Material-supported` | 缺少参数来源表和构造规则 | `Material-derived` | High |
连续追问会从“数据是不是实测”继续追到“构造数据能支持什么结论”“换成真实数据需要重算哪些参数”“当前架构能否接入真实接口”。稳妥口径会明确:当前版本是课程设计场景下的运行展示与辅助分析平台,适合说明系统关系和典型趋势,不等同于工程级实时调度系统。
[查看完整校园能源示例](examples/campus-energy-system/expected-output-chat.md) · [查看 YOLO 缺陷检测示例](examples/yolo-pv-defect-detection/expected-output-chat.md)
## 快速开始
基础审查:
请使用 defense-beating-simulator 审查我的项目答辩材料。
重点检查:项目定位、数据来源、个人贡献、创新点,以及 README / PPT / 报告中缺少的证据。
默认直接在对话中反馈,不要生成文件。
高压审查:
请用“严刑拷打”强度模拟答辩老师。
先做 Claim-Evidence Matrix,再指出高风险缺口,并围绕每个缺口连续追问 3 层。
最后给出稳妥回答和材料修改建议,不要替我编造材料中没有的信息。
回答评分:
下面是老师的问题和我的回答。请先指出回答依赖了哪些材料证据,再按 100 分制评分,
标出夸大或回避问题的句子,给出一版更稳妥的回答,并补一个最可能的追问。
## 适用范围
适合:
- 课程设计、毕业设计、综合实践项目
- 科研原型、竞赛项目、算法实验项目
- 保研复试、简历项目、技术面试
- GitHub 项目展示、README 和可复现性检查
不适合:
- 单纯润色演讲稿或生成通用面试题
- 没有项目材料的职业规划建议
- 与项目证据链无关的学术科普
- 替代导师、老师或真实评委的最终判断
## 兼容性
这是一个可移植的 `SKILL.md` 项目,不绑定单一 Agent。只要 Agent 支持技能目录,或能够按要求读取本地指令文件,就可以使用。
| Agent / 方式 | 默认目录 | 安装参数 |
| --- | --- | --- |
| Codex | `~/.codex/skills` | `codex` |
| 共享 Agent Skills | `~/.agents/skills` | `agents` |
| Claude Code | `~/.claude/skills` | `claude` |
| Gemini CLI | `~/.gemini/skills` | `gemini` |
| GitHub Copilot CLI | `~/.copilot/skills` | `copilot` |
| 项目内共享 | `<项目>/.agents/skills` | `project` |
目录依据可查阅 [Claude Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)、[Gemini CLI Agent Skills](https://geminicli.com/docs/cli/using-agent-skills/) 和 [GitHub Copilot Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) 官方文档。
不同 Agent 的自动发现规则仍可能随版本变化。如果技能没有被自动触发,请明确提到 `defense-beating-simulator`,或让 Agent 依次读取:
AGENTS.md → SKILL.md → references/中与项目类型对应的文件
`generic` 参数作为旧命令兼容别名保留,实际与 `agents` 一样安装到 `~/.agents/skills`。
## 安装
先克隆仓库并进入目录:
git clone https://github.com/Stephen-studying/defense-beating-simulator.git
cd defense-beating-simulator
Windows PowerShell:
# Codex
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Agent codex -Force
# Claude Code;也可改为 agents / gemini / copilot
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Agent claude -Force
macOS / Linux:
# Codex
sh install.sh --agent codex --force
# 共享 Agent Skills;也可改为 claude / gemini / copilot
sh install.sh --agent agents --force
Gemini CLI 也可以使用原生命令从仓库安装:
gemini skills install https://github.com/Stephen-studying/defense-beating-simulator
项目内安装必须显式指定另一个项目的技能目录:
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 `
-Agent project -Destination "D:\YourProject\.agents\skills" -Force
安装脚本只复制运行所需的 `SKILL.md`、Agent 入口、`references/`、`assets/` 和许可证,不会把测试、示例、CI 或开发缓存复制到用户技能目录。
## 仓库结构
defense-beating-simulator/
├── SKILL.md # 唯一规范:触发、流程、证据标签和安全边界
├── AGENTS.md # 通用 Agent 入口与安装目录说明
├── CLAUDE.md # Claude Code 薄入口
├── GEMINI.md # Gemini CLI 薄入口
├── agents/openai.yaml # Codex 展示与默认调用信息
├── references/ # 通用规则与五类项目专用追问库
├── assets/ # 用户明确要求导出时使用的模板
├── examples/ # 校园能源、YOLO 和 GitHub 审查示例
├── evals/ # 触发、结构与防夸大回归用例
├── scripts/ # 包结构验证与回答结果检查
├── tests/ # 标准库单元测试
├── install.ps1 # Windows 安装器
└── install.sh # macOS / Linux 安装器
## 项目验证
仓库验证不依赖第三方 Python 包:
python scripts/validate_skill.py
python -m unittest discover -s tests
保存一次 Agent 回答后,可用回归规则检查输出结构:
python scripts/evaluate_response.py --eval-id explicit_01 --response response.md
GitHub Actions 会在 Linux 和 Windows 上验证 Skill 结构、Python 打包、单元测试与安装脚本的实际复制结果。
## 安全边界
- 不编造数据来源、实验结果、代码功能或部署状态。
- 不把展示型 Demo 说成真实部署系统。
- 不把课程假设数据说成实测数据。
- 不把团队成果全部说成个人成果。
- 不把模型微调或模块替换包装成原创模型。
- 不保证答辩通过,输出只是准备辅助,不能替代导师反馈和真实评委判断。
## GitHub 信息建议
建议 About 描述:
A portable Agent Skill for evidence-first project defense review, follow-up questioning, answer scoring, and material repair.
建议 Topics:
agent-skills academic-defense defense-preparation project-review
interview-prep red-team codex claude-code gemini-cli github-copilot
## 许可证
[MIT License](LICENSE)标签:AI合规, Cutter, 提示词工程, 答辩模拟, 策略决策点, 辅助工具, 防御加固, 项目审查