forked from bai/curriculum-project-hub
25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
---
|
|
name: lesson-project
|
|
description: 把项目根目录 outline.md 落成符合 cph 0.0.2 的结构化讲义工程，并用 cph check/build 验证和生成教师版、学生版 PDF。
|
|
---
|
|
|
|
# 把 outline.md 落成 cph 0.0.2 工程
|
|
|
|
只在当前项目 workspace 内工作。先完整阅读 `outline.md`，再依次阅读本 skill 的 `structure.md`、`templates.md`、`workflow.md` 和 `writing-style.md`。
|
|
|
|
## 不可违反的边界
|
|
|
|
- 当前唯一工程清单是 `manifest.toml`，版本契约是 `.cph-version`；不要创建旧格式 `project.toml`、`info.toml` 或根 `main.typ`。
|
|
- element 只允许 `segment`、`lemma`、`example`、`sop`，字段以 `structure.md` 为准。
|
|
- 不生成 commentary、hint、answer、instruction、handout、summary 等 cph 0.0.2 不支持的字段。
|
|
- 忠实于 outline；缺题面、公式或关键结论时询问用户，不擅自补写。
|
|
- 使用 `cph check .` 验证结构，使用 `cph build . --target student` 和 `cph build . --target teacher` 构建；不要直接调用 `typst compile`。
|
|
- 任一命令失败都保留完整错误并修复根因，不删除内容来糊绿。
|
|
|
|
## 完成标准
|
|
|
|
1. `cph check .` 为 0 errors。
|
|
2. 两个 `cph build` 命令退出码为 0。
|
|
3. 产物位于 `build/student.pdf` 和 `build/teacher.pdf`。
|
|
4. 简报列出落地的 element、仍需用户补充的内容和两份 PDF 路径。
|