| name | teachany-pbl |
| description | Decompose a PBL project goal via teachany.cn into a knowledge-path PNG and editable link. Use for 项目式学习拆解、知识路径图谱、PBL 拆解、课标对齐项目路径. Not for generic lesson plans or interactive courseware HTML. |
| compatibility | Python 3.9+, playwright + chromium, network access to www.teachany.cn |
TeachAny PBL
将项目任务（+ 可选学段/学科/产出）拆解为：
- PNG 长图 — 结构化蓝图 + 知识路径图谱
- 编辑链接 —
https://www.teachany.cn/pbl?handoff=...（或 ?pbl=...），打开即为已拆解项目页
拆解由 teachany.cn 六阶段管线完成（LLM + 多课标索引）。禁止自行编造知识点节点或用手写列表代替 CLI 产出。
何时不用
- 只要普通教案、无项目交付物 → 不用本 skill
- 要生成交互课件 HTML → 用 TeachAny courseware skill
- 无法访问 teachany.cn / Playwright 安装失败 → 见 references/fallback.md
Workflow
- 从用户话术中提取参数（见 references/parameters.md）；缺省用默认值，不必逐项追问。
deliverable=other 时加 --deliverable-custom "自定义产出名"。
- 在 本 skill 目录（
SKILL.md 所在处）执行 CLI：
python3 scripts/pbl-decompose.py \
--goal "用户的项目任务原文" \
--grade junior \
--subject science \
--deliverable design-proposal \
-o ./pbl-output
- 首次缺依赖：
pip install playwright && playwright install chromium
- 读取输出 JSON（路径见下），向用户回复 PNG、
summary 统计、edit_url。
- 不要在 CLI 已跑过的情况下由 Agent 再次自动重试同一命令；仅当 Playwright 完全不可用时走 fallback。
- 耗时通常 3–8 分钟（复杂项目可能接近 10 分钟），告知用户耐心等待。
输出文件（-o 目录下）
| 文件 | 说明 |
|---|
{slug}.png | 长图（slug 由 --goal 生成） |
{slug}.json | 元数据：image、edit_url、handoff_source、summary |
edit_url 优先含 ?handoff=；若为 ?pbl= 亦可编辑；仅 ?goal= 表示 handoff 失败，需说明用户打开后须再点「拆解项目路径」。
回复模板
## PBL 拆解结果
**项目**：{goal}
- **图谱节点**：{nodeCount}（课标 {matched} · 外部 {external}）
- **继续编辑**：[在 TeachAny 打开]({edit_url})
可在 TeachAny 对话修改拆解、调整知识点、一键制作课件。
环境支持时展示 PNG 长图。
示例
用户：「初中科学，设计水火箭并安全发射，要工程原型」
python3 scripts/pbl-decompose.py \
--goal "设计一款水火箭并完成安全发射" \
--grade junior --subject science --deliverable engineering-prototype \
-o ./pbl-output
参考
