polyu-courseware-noteslisted
Install: claude install-skill TGKllbod/polyu-courseware-notes
# PolyU 课程课件整理(polyu-courseware-notes)
> **关于本 skill**:由一名 PolyU 学生的真实工作流沉淀而成。下文出现的课程代码(QRST7890/ABCD1234/EFGH5678/IJKL9012/MNOP3456)**仅作案例举例,可整体替换为你自己的课程代码**;`§` 编号与课程代码配套出现,改动时一并调整。
> **工作区**:默认 `~/PolyU`,可用环境变量 `POLYU_HOME` 指定。
> 适用工作区:`~/PolyU`(个人的课程材料库)。
> 语言默认:中文为主(说明/汇总类),课程知识笔记英文为主 + 生僻词中文括注。
> 场景:用户下载新课件放入根目录或 Downloads 后说「继续整理」,或在已有笔记上要求更新/拆分/导出 Word。
## 一、输出布局(硬规则)
1. **每门课一个文件夹**(如 `ABCD1234_Policy_Research_Method/`),原始课件/大纲按原名归档进去;同名 `.pptx`(可编辑源)与 `.pdf`(导出)可同时保留。课件出新版本时保留旧版并改名标注(如 `… (v1, 日期, 独有内容说明).pdf`),避免丢失旧版独有页(评分细则等)。
2. **复习笔记 = 两种形态,职责分离**:
- `复习笔记.md` —— **全课程可维护总源**:含课程结构/考核/GenAI 等课程级小节 + 各讲知识点小节(按讲顺序递增编号,如 `## 4. Lecture 1 — …`、`## 5. Lecture 2 — …`)。
- `<课程代码>_复习笔记-第N讲.docx` —— **成品,一讲一个文件**。**严禁**把所有讲(或把多讲新增内容)合并进单个 `复习笔记.docx`/一个长文档。已有合并文件需拆掉。
3. 新讲到达时的固定动作:在 `复习笔记.md` 追加该讲小节 → 重新生成**该讲**的 docx(见 §五),不去动其他讲的 docx。
4. 课程级信息(考核构成/DDL/出勤/GenAI 红线/教师信息/上课时间地点)**不进复习笔记 docx**,放在课程 `README.md` 与根目录各汇总文件(`DDL汇总.md`、`出勤规定汇总.md`、`AI使用红线速查.md`、`README.md`、`课程总览.docx`、`会话交接快照.md`)。
5. 文件名约定:
- 复习笔记成品:`<课程代码>_复习笔记-第N讲.docx`(N 为课件讲号,中文「讲」与 "Lecture" 等价)。
- 原始课件:保留下载原名,不翻译、不改扩展名。
- 各课程 README 内「文件夹内容」清单须与实际文件一一对应。
6. **工作区边界:只在 `~/PolyU` 内读写(实践确定的边界规则)**:
- **禁止**扫描 `~/Downloads` 根目录、`~` 家目录或其他工作区外路径来"找新文件",即使只是列目录看文件名。
- 用户说"放了新文件/新课件"时,**只在工作区内查找**(`PolyU/` 根目录与各课程文件夹);**若未找到,先问用户要路径,或请其把文件移进 `PolyU`**,不要自行到工作区外搜索。
- 背景:`workspace-write` 策略只拦"修改"、不拦"读取"(实测:工作区外 `touch` 返回 `Operation not permitted`,但工作区外读取正常),因此必须靠自觉遵守,而不能指望沙箱兜底。