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

USAGE.md

@@ -2,6 +2,14 @@
 
 安装与升级见 [INSTALL.md](INSTALL.md)。开始任务时提供内容、用途、template 来源和 theme；沿用已确认选择。一次激活一个 template 和其中一个 theme，页面再选择 layout。没有模板来源时 Agent 会询问，不会猜一个全局默认模板。
 
+使用本Skill制作时，以下三项为必做要求：
+
+1. 必须用Skill工程工具创建可构建项目，或继续已有有效工程；单页任务也适用。保留真实构建入口和输入，交付PPTX须通过工程构建生成，禁止绕过Skill手拼PPT或给成品补空工程。
+2. 用户确认小样后尽量忠实重建，保留其内容、图形及表示关系的形状，包括连线、箭头和分组边界。修复排版与可读性问题时不得擅自删减这些元素。
+3. 每页完成后检查全页字号、字体、字重、间距和内容视觉分组的组合效果，确认层次清楚；发现问题后修复源、重建并查看当前画面，不以“不溢出”代替层次检查。
+
+具体见[工程接口](references/project-workspace.md)、[小样保真](references/visual-design.md#approved-mockup-fidelity)及[全页层次检查](references/visual-design.md#full-page-hierarchy-check)。
+
 可以直接这样请求：
 
 ```text
@@ -74,18 +82,19 @@ Agent 读取导出的调色板、字体、网格、素材 paint 契约、结构
 
 含数学内容时读取[数学制作](references/mathematics.md)，声明专用数学字体。`math_component.py`与原生导出包装器支持结构化表达式的Office Math输出；字体、字号角色和颜色由template或显式工程样式提供。它不是通用LaTeX解析器；源SVG的线性兼容文字也不等于复杂公式预览。目标应用的渲染和实际公式编辑分别验证。
 
+选定模板后先按下节初始化并配置工程，把当前获准页面及输入加入其中。最终导出走工程入口，由builder调用Skill原生编译器：
+
 ```sh
-"$PPT_PYTHON" "$PPT_SKILL/scripts/native_export.py" \
-  --manifest /path/to/template/manifest.json --theme THEME \
-  --source /path/to/project/pages/page.svg --source-root /path/to/project \
-  --output /path/to/project/exports/review.pptx
+"$PPT_PYTHON" /path/to/project/tools/ppt_project.py lock --project /path/to/project
+"$PPT_PYTHON" /path/to/project/tools/ppt_project.py check --project /path/to/project
+"$PPT_PYTHON" /path/to/project/tools/ppt_project.py build --project /path/to/project
 ```
 
-输出文件保护既有内容，修订时使用新路径。原生页面保留 Master／Layout／占位符；图表保留数据缓存和内嵌工作簿，表格保留单元格。图标按 SVG＋paint 的 palette／fixed／structural 通道处理。图表和表格示例位于 `assets/components/`，用法见[图表](references/charts.md)和[基础组件](references/components.md)。
+构建校验输入锁并生成当前PPTX，失败时保留旧产物；不要靠已有导出物或单独调用底层编译器绕过工程。原生页面保留 Master／Layout／占位符；图表保留数据缓存和内嵌工作簿，表格保留单元格。图标按 SVG＋paint 的 palette／fixed／structural 通道处理。图表和表格示例位于 `assets/components/`，用法见[图表](references/charts.md)和[基础组件](references/components.md)。
 
 ## 工程和协作
 
-需要可重建工程时，按[工程接口](references/project-workspace.md)执行 `ppt_project.py init`，为已定稿 SVG 准备 `prepare_native_project.py`，添加页面、讲稿及显式数据绑定，再 `lock`／`check`／`build`／`pack`。初始化只是骨架，不能把空工程当作完成的 PPT。
+每次使用本Skill都按[工程接口](references/project-workspace.md)执行 `ppt_project.py init` 或继续已有有效工程，为原生SVG路线准备 `prepare_native_project.py`，添加当前获准页面、讲稿及显式数据绑定，再 `lock`／`check`／`build`。交付时保留工程；需要源码包时再 `pack`。初始化只是骨架，只有当前输入经真实builder成功构建后才满足可构建项目要求。
 
 协作时负责人固定页 ID、页序、风格和共用资源，参与者只修改分配的页面目录；负责人串行整合共享内容和锁。详见[页面分工](references/page-collaboration.md)。