AGENT SKILL
qifa
把论文(本地 PDF、arXiv URL、arXiv LaTeX 源码、本地 LaTeX 工程、DOCX、网页文章)和/或代码库(本地路径、git URL)做成 PPT 式可视化讲解网页课程:chapter 到 slide 到 step 三级、16:9 网页、课堂口语讲稿与可开关字幕、术语卡、公式分步、代码走读、图表放大、可选视频嵌入,并带自动质检与有界修复。当用户要求把论文或代码库做成讲解课件、教学网页、PPT 式课程、可视化讲义,或要求讲透某篇论文/某个仓库时使用。默认 production 模式:开头一次确认、中途不打断;仅当用户明确要求运行开发模式或停在某个阶段时进入 development 模式。
- License 许可
- MIT
- 最近更新
- 2026-10-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- qifa
- license
- MIT
- description
- 把论文(本地 PDF、arXiv URL、arXiv LaTeX 源码、本地 LaTeX 工程、DOCX、网页文章)和/或代码库(本地路径、git URL)做成 PPT 式可视化讲解网页课程:chapter 到 slide 到 step 三级、16:9 网页、课堂口语讲稿与可开关字幕、术语卡、公式分步、代码走读、图表放大、可选视频嵌入,并带自动质检与有界修复。当用户要求把论文或代码库做成讲解课件、教学网页、PPT 式课程、可视化讲义,或要求讲透某篇论文/某个仓库时使用。默认 production 模式:开头一次确认、中途不打断;仅当用户明确要求运行开发模式或停在某个阶段时进入 development 模式。
02 资源文件 91
- 参考文档agents/openai.yaml276 B
- 资产文件assets/presets/beginner-tutorial.yaml288 B
- 资产文件assets/presets/code-onboarding.yaml309 B
- 资产文件assets/presets/research-course.yaml300 B
- 资产文件assets/themes/classroom-clean/theme.json278 B
- 资产文件assets/themes/classroom-clean/tokens.css504 B
- 资产文件assets/themes/engineering-blueprint/theme.json326 B
- 资产文件assets/themes/engineering-blueprint/tokens.css526 B
- 资产文件assets/themes/scientific-editorial/theme.json309 B
- 资产文件assets/themes/scientific-editorial/tokens.css485 B
- 资产文件assets/web-template/index.html296 B
- 资产文件assets/web-template/package.json516 B
- 资产文件assets/web-template/public/media/.gitkeep—
- 资产文件assets/web-template/src/App.tsx6.4 KB
- 资产文件assets/web-template/src/components/ChartZoom.tsx915 B
- 资产文件assets/web-template/src/components/CodeWalkthrough.tsx952 B
- 资产文件assets/web-template/src/components/FormulaSteps.tsx1.3 KB
- 资产文件assets/web-template/src/components/GlossaryCard.tsx1.4 KB
- 资产文件assets/web-template/src/components/SlideRenderer.tsx1.7 KB
- 资产文件assets/web-template/src/components/Stage.tsx1.3 KB
- 资产文件assets/web-template/src/components/Subtitle.tsx707 B
- 资产文件assets/web-template/src/components/VideoEmbed.tsx853 B
- 资产文件assets/web-template/src/content/course.json902 B
- 资产文件assets/web-template/src/content/custom/CodeFlow.tsx5.8 KB
- 脚本assets/web-template/src/content/custom/focus.ts3.2 KB
- 脚本assets/web-template/src/content/custom/index.ts835 B
- 资产文件assets/web-template/src/content/custom/PointFlow.tsx8.1 KB
- 资产文件assets/web-template/src/content/narrations.json60 B
- 脚本assets/web-template/src/content/sentences.ts1.6 KB
- 脚本assets/web-template/src/hooks/useCourseCursor.ts4.5 KB
- 脚本assets/web-template/src/hooks/useStageScale.ts1.1 KB
- 资产文件assets/web-template/src/main.tsx301 B
- 资产文件assets/web-template/src/styles/base.css13.0 KB
- 资产文件assets/web-template/src/styles/tokens.css590 B
- 脚本assets/web-template/src/types.ts1.1 KB
- 资产文件assets/web-template/tsconfig.json508 B
- 脚本assets/web-template/vite.config.ts376 B
- 参考文档references/chapter-design.md3.2 KB
- 参考文档references/code-analysis.md3.3 KB
- 参考文档references/curriculum-design.md3.0 KB
- 参考文档references/development-workflow.md2.9 KB
- 参考文档references/highlight-rules.md3.1 KB
- 参考文档references/intake.md4.1 KB
- 参考文档references/narrative-design.md5.1 KB
- 参考文档references/paper-analysis.md2.8 KB
- 参考文档references/production-workflow.md4.4 KB
- 参考文档references/quality-rubrics.md3.0 KB
- 参考文档references/schemas/chapter-plan.schema.json2.2 KB
- 参考文档references/schemas/course-outline.schema.json2.9 KB
- 参考文档references/schemas/project.schema.json3.4 KB
- 参考文档references/schemas/qa-report.schema.json2.3 KB
- 参考文档references/schemas/run-state.schema.json1.6 KB
- 参考文档references/schemas/source-model.schema.json3.3 KB
- 参考文档references/schemas/visual-plan.schema.json1.6 KB
- 参考文档references/visual-design.md6.9 KB
- 参考文档references/web-implementation.md7.9 KB
- 脚本scripts/build_site.py12.8 KB
- 脚本scripts/check_site.py6.8 KB
- 脚本scripts/estimate_duration.py3.4 KB
- 脚本scripts/highlight_audit.py8.0 KB
- 脚本scripts/lib/__init__.py36 B
- 脚本scripts/lib/deps.py2.4 KB
- 脚本scripts/lib/io.py2.1 KB
- 脚本scripts/lib/minischema.py6.2 KB
- 脚本scripts/lib/miniyaml.py9.7 KB
- 脚本scripts/lib/paths.py2.5 KB
- 脚本scripts/lib/workbench.py6.0 KB
- 脚本scripts/pipeline.py27.4 KB
- 脚本scripts/validate_course.py13.7 KB
- 脚本scripts/validate_sources.py9.0 KB
- 脚本scripts/validate_stage.py6.0 KB
- 脚本scripts/visual_audit.py8.2 KB
- 参考文档tests/cases/dynamicvla-paper.yaml1015 B
- 参考文档tests/cases/openpi-repo.yaml894 B
- 参考文档tests/cases/pir2-paper.yaml1.1 KB
- 参考文档tests/cases/sam2-paper.yaml1.0 KB
- 参考文档tests/cases/tempo-paper.yaml1.0 KB
- 参考文档tests/expected-invariants/openpi-repo.md3.9 KB
- 参考文档tests/expected-invariants/pir2-paper.md2.0 KB
- 参考文档tests/expected-invariants/README.md226 B
- 参考文档tests/fixtures/workspaces/tiny-course/.qifa/run-state.yaml1.0 KB
- 参考文档tests/fixtures/workspaces/tiny-course/00-intake.md528 B
- 参考文档tests/fixtures/workspaces/tiny-course/plan/chapter-plan-C01.json1.9 KB
- 参考文档tests/fixtures/workspaces/tiny-course/plan/course-outline.json1.2 KB
- 参考文档tests/fixtures/workspaces/tiny-course/plan/visual-plan.json344 B
- 参考文档tests/fixtures/workspaces/tiny-course/project.yaml572 B
- 参考文档tests/fixtures/workspaces/tiny-course/script/01-C01.md3.2 KB
- 参考文档tests/fixtures/workspaces/tiny-course/source/source-model.json762 B
- 脚本tests/fixtures/workspaces/tiny-course/source/tiny-repo/pkg/main.py189 B
- 参考文档tests/README.md891 B
- 脚本tests/test_validation.py22.2 KB
03 SKILL.md 正文
QiFa
把论文和/或代码库做成 PPT 式可视化讲解网页课程。本文件是入口:先读"核心约束",按"路由"读对应 reference,再执行。
核心约束(不可协商)
- 默认 production 模式:开头一次确认需求(见
references/intake.md),之后全程不向用户提问;只有用户明确说"开发模式 / 停在某阶段 / 测试某阶段"时才进入 development。 - 生成由 Agent 完成,脚本无 LLM:
scripts/pipeline.py只做初始化、状态、校验、汇总;每阶段"产出 →validate→advance"。 - 每阶段产物必须过确定性校验才能推进;
blocker最多修复 2 次(advance失败即计一次),仍失败则终止并说明;warning降级发布并写入review/qa-report.md。 - 不修改用户仓库:代码库一律只读;本地路径不复制,git URL 只做浅克隆。
- 不夸大来源:论文贡献以原文为依据,不确定就标注不确定性;引用必须真实存在(论文编号 + 页码,代码
path:符号)。 - 视觉/动效登记制:任何动画、视频、图示必须在
plan/visual-plan.json登记教学目的;无登记不得进课件。不设数量配额。 - 范围守卫:不做 TTS/配音、录屏与视频合成、练习与自测、代码沙箱、后台类 Web App、修改用户仓库。
- 修改本 Skill 后必须运行
python3 tests/test_validation.py并保持通过。
路由
| 任务 | 先读 | 再执行 |
|---|---|---|
| 生产模式流程与阶段循环 | references/production-workflow.md |
scripts/pipeline.py |
| 开发模式、阶段评审与反馈固化 | references/development-workflow.md |
tests/cases/*.yaml |
| 开头确认、默认配置、相关性判断 | references/intake.md |
pipeline.py init |
| 论文解析与资产提取 | references/paper-analysis.md |
validate_sources.py |
| 代码库 digest 与讲法 | references/code-analysis.md |
validate_sources.py |
| 课程目标、先修、章节与时长预算 | references/curriculum-design.md |
validate_course.py |
| slide/step 结构与覆盖检查 | references/chapter-design.md |
validate_course.py |
| 讲稿、字幕、术语表 | references/narrative-design.md |
validate_course.py、estimate_duration.py |
| 主题、视觉与视频嵌入 | references/visual-design.md |
validate_course.py |
| 网页实现与构建 | references/web-implementation.md |
build_site.py、check_site.py |
| 质检 rubric、严重级与修复 | references/quality-rubrics.md |
pipeline.py report |
| 定制视觉的高亮判定与检查 | references/highlight-rules.md |
highlight_audit.py |
| 数据结构 | references/schemas/*.schema.json |
validate_stage.py |
工作流(production)
- intake:收集输入与 5 项确认;能推断的不问;缺失字段用默认值并记录。
pipeline.py init建工作区;写00-intake.md。 - source-analysis:按
paper-analysis.md/code-analysis.md抽取并写source/source-model.json;论文与代码混合时先判定相关性(relevance),不相关按 intake 记录的用户选择处理。 - curriculum:写
plan/course-outline.json(学习目标、先修、章节、时长预算)。 - chapter-design:写
plan/chapter-plan.json(章节 → slide → step,讲点与可选引用)。 - narrative:写
script/NN-<chapter-id>.md(按 slide 锚点的课堂口语讲稿)+ 术语表。 - visual-storyboard:写
plan/visual-plan.json(登记每个视觉的教学目的与资产)。 - web-generation:
build_site.py从assets/web-template生成presentation/,再补章节数据与定制 TSX;npm run build必须通过。 - automated-review:
pipeline.py report汇总确定性检查 + 按quality-rubrics.md做语义评审;blocker 修复最多 2 次。 - package:确认三个启动脚本与
README-learner.md就绪;工作区根交付。
每阶段完成即:
python3 <skill>/scripts/pipeline.py validate <stage>
python3 <skill>/scripts/pipeline.py advance --stage <stage>
资源索引
references/:方法与规则(按路由读取,不必全部加载)。references/schemas/:7 个数据结构的 JSON Schema;写产物前先读对应 schema。scripts/:pipeline.py(状态与编排)、validate_stage.py、validate_sources.py、validate_course.py、build_site.py、check_site.py、estimate_duration.py、visual_audit.py、highlight_audit.py;scripts/lib/为共享工具。assets/presets/:research-course、code-onboarding、beginner-tutorial三套预设。assets/themes/:scientific-editorial(默认)、engineering-blueprint、classroom-clean。assets/web-template/:精简 Vite + React + TS 底座(16:9 舞台、slide/step 游标、字幕层、token 契约)。tests/:P0 回归(test_validation.py+fixtures/workspaces/,零 LLM 零网络)与 P1 案例(cases/*.yaml、expected-invariants/)。
维护
- 本文件保持精简(不超过 500 行);细节一律放
references/。 - 目录与文件名仅用小写字母、数字、连字符;frontmatter
name必须与目录名一致。 - 每次人工评审的结论必须固化到 reference / schema / validator / template / tests 之一(见
development-workflow.md),否则视为未完成。