kingwty1-star/school-weekly-ppt-skill 是一个面向 Codex 的学校周报 PPT skill，GitHub 仓库入口是 https://github.com/kingwty1-star/school-weekly-ppt-skill。它的用途很明确：把一份 Markdown 学习周报转成蓝色正式风格的技术汇报 PPTX，并保留可编辑的公式、变量、箭头、阴影和重点标注。

下载入口优先走 GitHub 仓库页。需要离线保存时，用仓库页面右上角的 Code 菜单下载 ZIP；需要本地留一份源码时，用 git clone https://github.com/kingwty1-star/school-weekly-ppt-skill.git。这不是独立网页生成器，真正的安装路径在仓库里的 skills/school-weekly-ppt 子目录。

安装时把 path 指到 skill 子目录

Codex 自带 skill installer 时，安装命令不要只写仓库名，还要带上 --path skills/school-weekly-ppt。这个路径对应仓库里的 skill 本体，里面有 SKILL.md、agents/openai.yaml、references/visual-style.md 和 scripts/build_school_weekly_ppt.mjs。

python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py 
  --repo kingwty1-star/school-weekly-ppt-skill 
  --path skills/school-weekly-ppt

Windows 下安装脚本一般在用户目录的 .codexskills.systemskill-installerscripts 里。安装后重启 Codex，让 $school-weekly-ppt 被重新发现；没有重启时，后面的触发句可能识别不到这个 skill。

第一次测试用一份真实周报 Markdown

这个 skill 的输入不是散乱主题，而是一份 .md 周报。准备文件时，至少要有周次、学习主题、3 个进展点、学习路径、一个机制或公式、问题修正和下周计划。没有公式也能做周报 PPT，但如果材料里有变量、模型或算法，机制页会成为整套 PPT 的重点页。

首次触发可以写成这样：

使用 $school-weekly-ppt，根据 notes/inbox/本周学习周报.md 制作汇报 PPT

英文环境也可以写 Use $school-weekly-ppt to create a blue PowerPoint from this Markdown school weekly report.。触发后检查它是否读取到了目标 Markdown，以及是否按 7 到 9 页周报结构拆分，而不是把 Markdown 每一段原样塞进幻灯片。

跑完后看 PPTX 和预览目录

默认产物会落到 outputs/final/ 一类输出目录，文件名通常带有“学习周报.pptx”；预览图会放在 outputs/ppt-work/<workdir>/preview/ 下面。检查时先确认 PPTX 存在，再打开预览 PNG，看中文是否溢出、蓝色技术风是否统一、机制页里的公式变量是否真的用可编辑形状和箭头表达。

脚本 scripts/build_school_weekly_ppt.mjs 更适合普通 Markdown 周报的第一版。当周报里有复杂公式、控制模型、物理意义或变量关系时，先让它生成基础 PPTX，再单独补机制页的结构，会比把所有细节直接丢给一次生成更稳。

入口和测试连起来以后再扩大范围

kingwty1-star/school-weekly-ppt-skill 的价值不在“随便输入一句话做 PPT”，而在把周报材料整理成可展示的学习汇报：封面、核心进展、学习路径、周内细节、机制图、知识图谱、问题修正和下周计划。仓库入口、ZIP 下载、安装路径、重启识别、Markdown 触发、PPTX 和预览目录连起来以后，再把它用到正式周报会更省返工。