Require buildable projects, mockup fidelity and page hierarchy (0.9.3)

This commit is contained in:
2026-10-31 19:37:26 +08:00
parent e858fa130d
commit 25be7ebb86
10 changed files with 91 additions and 21 deletions
+4
View File
@@ -4,6 +4,8 @@
工程把正文、页面源、数据、素材、模板源、必要工具和依赖说明放在同一目录。Git 可追踪这些输入;设备相关绝对路径、缓存和导出物在运行时重建。一次工程固定一个 template 版本和一个 theme,页面顺序由 `pages` 数组表达,重排页面无需更换页面 ID。
用户要求使用本Skill时,必须使用本工程工具创建可构建项目,或继续使用已有的有效工程;单页、小样重建和修改任务也适用,不以需要Git协作或跨设备迁移为前提。选定template/theme后先初始化工程,再在其中维护页面源和真实builder。禁止绕过Skill编译器手拼PPT、临时拼接PPTX/XML/ZIP,或给已手拼的成品补一个空工程。交付PPTX必须由声明的工程入口从当前输入成功构建,并保留对应工程。
## 初始化与作者工作流
解析和工程管理要求 Python 3.10+,只用标准库;实际 builder 的依赖由工程自行声明。消费方明确逐页制作时,保留 `interactive-page`,不要因建立工程而自动批量创作。
@@ -26,6 +28,8 @@ python3 /path/to/skill/scripts/ppt_project.py init \
该通用 builder 读取各页已完成的 SVG 和 Markdown 讲稿;`content.json`/`data` 仍是锁定作者输入,不会自动绑定到 SVG。需要数据驱动生成的消费方应提供自己的明确绑定或预处理步骤。
自定义预处理/builder仍须通过本Skill的相应编译路线生成最终PPTX,并声明真实输入,不能成为手拼成品的旁路。空骨架、`build_ready: false`、仅通过`check`或已有导出物都不算完成可构建项目;必须对当前获准页面实际执行`build`成功。若所选路线或环境暂时无法构建,完成可独立进行的源工作并说明具体缺口,不用手拼结果冒充工程交付。生产修复回写源后重建,PowerPoint内的临时编辑测试在独立副本中进行。
```sh
python3 tools/ppt_project.py lock --project .
python3 tools/ppt_project.py check --project .