中文 | English
10x Socratic AI Study OS for Agentic Coding & Knowledge Mastery
From Zero to Deep Mastery: Single-concept Immersion + 4 Visual Pedagogy Modes + Dual Inner-Assessment + 12 Structured Markdown Assets Silent Dump
💡 告别“向 AI 提问关掉窗口全忘光”的浅层学习！
Study_via_AI是专为 Google Antigravity、Claude Code、OpenAI Codex CLI、Cursor、Windsurf 等现代化 Agent 环境打造的自适应学习操作系统。拒绝大段填鸭，通过严谨状态机、单点通俗拆解、4 大现代化视觉教学模式、暗黑硬核考官（零讨好、0分死刑、手术刀解剖、满分降维示范）与 12 岁费曼反向审判，自动生成 12 份可直接归档沉淀的 Markdown 终身知识库。
直接复制以下一句话发送给 Google Antigravity / Claude Code / Codex / Cursor：
安装这个 skill https://github.com/lowellran/Study_via_AI
💡 后续若有版本更新，再次发送同一句话即可自动无损升级。
# Windows (PowerShell)
git clone https://github.com/lowellran/Study_via_AI.git "$env:USERPROFILE\.codex\skills\Study_via_AI"
# macOS / Linux
git clone https://github.com/lowellran/Study_via_AI.git ~/.codex/skills/Study_via_AInpx skills add lowellran/Study_via_AI -y -g安装完成后，在任意对话中直接输入：
使用 Study_via_AI 帮我学习 [主题名称 / 上传教材文档 / 粘贴文章链接]
跨会话断点续学（随时新开对话窗口，永不迷失进度）：
继续 [文件夹名称或主题名称] 的学习
在每个小知识点开讲前，系统会自动输出术语速记库并提供 4 大现代化视觉教学模式供你随心选择：
- 🖼️ 选项 1【AI 深度图解生图】：
- 模式 1A：导师直出高颜值彩色原理图与生活比喻图，并融入图文深度拆解。
- 模式 1B：导师提供两套精细 Prompt，强制阻塞等待用户外部生成回传后深度结合。
- ⚡ 选项 2【极速直接讲（现代平滑图解）】：
- 无需生图等待，采用现代彩色平滑矢量图（SVG/Mermaid）极速推进，全面废除粗糙生硬的 ASCII 字符画。
- 🌐 选项 3【全源真实实料与网络图文截取嵌入】：\r\n - 后台自动调用 Python 提取本地 PDF 讲义插图、截取本地视频关键帧、全网深挖权威教程原图直接内嵌！\r\n4. 🌟 选项 4【智能教学模式】（强烈推荐）：\r\n - 融合 1、2、3 全部优势，以内置基准讲义为标杆，大白话通俗比喻 + 随文智能嵌入最匹配的现代插图与时序卡片。\r\n\r\n> 🛡️ 工业级视觉防护体系：\r\n> - 防裂图沙箱规范：杜绝跨盘符链接（如 ile:///D:/...），统一收敛至会话沙箱目录引用；\r\n> - 防黑块截断质检：提取讲义/网络图片时后台执行 Pillow 完整性校验，拦截残缺文件并自动重拉无损原图；\r\n> - 生图 429 容灾兜底：若 AI 生图配额耗尽，秒级切换本地 Python Matplotlib/SVG 绘制深色科技蓝图（Dark Tech Blueprint），确保图文教学链条 100% 坚如磐石！
⚖️ 严格考纲锁死与反霸凌扣分铁律（Strict In-Scope Testing）：
- 考查范围 100% 锁死已授课范围：考题核心因果与参数必须完全源于当前 Plan 已讲内容，绝对严禁把后续未学 API 当作“常识”超纲突袭；
- 严禁信息不对称霸凌扣分：学员定性与因果推导完全自洽即给满分，严禁以“未写出没教过的专有 API/内部宏”为由无理扣分；
- 考官自纠与撤销扣分机制：若学员指出题目超纲，考官必须立即撤销不合理扣分、恢复满分评定，并以白话无条件补齐该物理机理！
| 核心维度 | 传统问答 / 总结类 Prompt | 纯大纲路线工具 | 🚀 Study via AI (学习操作系统) |
|---|---|---|---|
| 教学颗粒度 | 一次性输出长篇大论，认知过载 | 只生成章节标题，缺乏精讲 | 极小单点沉浸：一次对话仅讲透一个知识点，严格等待用户确认 |
| 视觉呈现 | 粗糙 ASCII 字符画或纯文本 | 无图或格式错乱 | 现代平滑矢量图/真实原图：全面告别 ASCII，支持 4 大视觉模式 |
| 自有资料锚定 | 脱离教材，纯靠通用知识发挥 | 仅粗暴提取大纲 | 精准溯源：精确指出教材第几章第几页 / 视频时间戳与实料截帧 |
| 内化考核深度 | 毫无考核或浅层提问，“假装看懂” | 仅提供自测题目，无即时纠错 | 暗黑硬核内化 (Zero Sycophancy)：封杀 AI 客套，0分死刑机制 + 原话手术刀解剖 + 导师级降维满分示范 (A/B/C) + 80分门禁与变式题压测 + 12岁费曼防复读童真质检 |
| 抗遗忘与上下文 | 长对话后规则遗忘、注意力漂移 | 无状态流转机制 | 机器状态头解耦：硬盘存储状态 > Context 记忆，杜绝漂移 |
| 成果资产化 | 聊天窗口关闭即丢失，零沉淀 | 仅生成零散日志 | 12 份标准 Markdown：带大纲树、对话实录与一页速查表 |
| 掌控自由度 | 被动顺着 AI 预设流程走 | 难以动态调整进度 | 全局驾驶舱：支持 /skip, /jump, /status, /mode |
stateDiagram-v2
[*] --> Phase0_Initialization: 用户输入（主题/文档/视频/链接）
Phase0_Initialization --> Phase1_Roadmap_Gen: 确认学习范围 & 建立专属文件夹
Phase1_Roadmap_Gen --> Phase2_Plan_Execution: 静默落盘 00_overview_and_roadmap.md
state Phase2_Plan_Execution {
[*] --> Term_Deconstruction: 输出专业术语速记库 + 4 大视觉呈现选项确认
Term_Deconstruction --> Single_Concept_Teaching: 启动 Plan N (现代平滑矢量图/真实插图深度讲解)
Single_Concept_Teaching --> QnA_and_Discussion: 严格单点互动（严禁自嗨越权，静默等待作答）
QnA_and_Discussion --> Single_Concept_Teaching: 答疑直至搞懂（推进下一知识点）
QnA_and_Discussion --> Dual_Validation: 当前 Plan 知识点全部学完
state Dual_Validation {
[*] --> AI_Examiner: 方法三：暗黑 AI 考官即时实战测试 (0分死刑/原话解剖/满分示范/80分变式门禁)
AI_Examiner --> Feynman_Loop: 考官测试通关 -> 方法六：12岁费曼反向审判 (黑话零容忍/防复读)
Feynman_Loop --> [*]: 费曼纠错通关
}
Dual_Validation --> Archive_Plan_Document: 原生工具静默写入 01~10 号实录
Archive_Plan_Document --> Update_Machine_State: 更新 00 首行 SYSTEM_STATE 与进度复选框
Update_Machine_State --> Display_Full_Cheatsheet: 前台输出成就卡片与完整一页速查表
Display_Full_Cheatsheet --> Next_Plan_Or_Finish: 阶梯晋级定位 & 询问继续
}
Phase2_Plan_Execution --> Phase3_Final_Synthesis: 10 次计划全部通关
Phase3_Final_Synthesis --> [*]: 全域总考官 + 全域大费曼 -> 静默落盘 255 号终极文档
学完整个课程后，系统将在你的专属学习目录下自动生成 12 份排版严谨、包含 [TOC] 大纲树的 Markdown 知识库：
📁 你的专属学习目录/
├── 📄 00_overview_and_roadmap.md # 机器状态头 + 5 级阶梯 + 20 小时计划与总进度
├── 📄 01_plan_01_<topic>.md # Plan 01 对话实录 + 附录：Plan 01 一页速查表
├── 📄 02_plan_02_<topic>.md # Plan 02 对话实录 + 附录：Plan 02 一页速查表
│ ...
├── 📄 10_plan_10_<topic>.md # Plan 10 对话实录 + 附录：Plan 10 一页速查表
└── 📄 255_final_synthesis_and_cheatsheet.md # 全域总考官与大费曼实录 + 全域大一统速查表 (Master Sheet)
| 开发环境 / AI Agent 平台 | 兼容性支持 | 说明与支持特性 |
|---|---|---|
| Google Antigravity | 🌟 完美原生支持 (推荐) | 自动识别 Skill、自动文件读写、静默落盘 12 份文档 |
| Claude Code | ✅ 完全支持 | 原生工具写入、跨会话断点续学、支持全局与项目级配置 |
| OpenAI Codex CLI | ✅ 完全支持 | 原生执行与自动化工作流 |
| Cursor / Windsurf | ✅ 完全支持 | 引入作为项目 Rules / Agent Skill 配置 |
| OpenCode / ZCode / OpenClaw | ✅ 完全支持 | 完整支持状态机与命令系统 |
| 普通网页端 (Web Chat) | 网页版因缺少本地磁盘写入权限，需由用户手动复制生成的 Markdown |
本仓库在 examples/ 目录中提供了三个真实领域的落地档案库：
- ⚙️ GD32F4 嵌入式固件开发与硬件驱动实战
- 包含：
00号 RCU 时钟树与外设 5 级阶梯路线图、01号真实工程代码精解、RCU/GPIO 考官打分实录与一页速查表。
- 包含：
- 💬 两性社交动态与博弈心理学实战
- 包含：
00号进阶大纲规划、01号进化心理学与奖品框架真实对话实录、双重价值符号拆解与一页速查表。
- 包含：
- 🎵 KTV 流行声乐发声与混声实战
- 包含：
00号声乐进阶阶梯规划、01号横膈膜呼吸支持与声带闭合真实对话实录与速查表。
- 包含：
学习过程中随时可以使用以下指令控制节奏：
/skip：跳过当前知识点讲解或考核，快速进入下一环节。/jump <01~10|255>：直接跳转到指定 Plan。(自带前序依赖安全气囊，跳级时会提醒确认)/status：调出当前学习进度与掌握度阶梯。/cheatsheet [01~10|255]：直接调出指定 Plan 或全域终极的一页速查表。/mode <quick|deep>：切换模式（quick极速突击 /deep深度攻坚）。
欢迎提交 PR 或 Issue！如果你觉得这个 Skill 对你的深度学习有所启发和帮助，请给这个项目点一个 ⭐ Star，这是对开源作者最大的鼓励！
本项目采用 MIT 许可证。