SuperAPI AI 工具集

openpress-create-pages

办公与效率

查看项目

更新于 10-16 09:53

技能介绍

用途:该技能负责页面型 OpenPress 产物的结构与内容判断,适用于报告、提案、白皮书、论文、书籍、教学笔记和手册等文档。CLI 生命周期与交付由 openpress 负责,已有内容的修订模式由 openpress-collaborate 负责。

环境与初始化:需要 Node 20 或更新版本。可先运行 node -v 检查版本,并探测工作区是否已有 Press。空文件夹使用 npm create @open-press <target> -- --type pages,然后扩展生成的最小 pages Press,不要强制使用非空目标;已有工作区先查看 press/*/press.tsx,选择新 slug,运行 open-press create <slug> --type pages --title "<title>",只扩展新建目录。

页面约定:写入前收集文档简报和已确认的来源材料。报告、提案、白皮书、论文、书籍、教学笔记和手册默认使用 page="a4",仅在需要自定义几何时再询问;几何信息放在 <Press page> 而非 CSS。公开 MDX 源在 press/<slug>/press.tsx 中注册,内部规划放在 press/design.md、memory/ 或 skills。产物本地组件、媒体和主题放在 press/<slug>/ 下,仅有意跨 Press 复用时才放 press/shared/。使用自托管授权字体或系统回退字体,最终主题不得依赖远程字体 CSS。保留已确认事实,缺失材料标记为 [TODO: ...]、[DRAFT: ...] 或 [FIX: ...],不要编造。创建目录树或编写 Press TSX 前阅读 references/press-tree.md,编写主题或页面组件前阅读 references/theme.md。

文档结构:# 仅用于文档标题或封面标识;## 为进入目录的正式章节或文档单元;### 为主要主题组,进入目录;#### 为局部过程、定理、示例或参考项,通常不进目录。有标题的表格前放 <TableCaption>,图表编号由 OpenPress 管理。正文引用图或表时使用稳定语义 ID 写 @fig-名称 或 @tbl-名称,渲染时解析本地化编号,需先阅读 references/press-tree.md 的相关章节。明确要求后续内容另起一页时,紧跟 <PageBreak />,不要用占位内容或更细的 CSS 分页模拟。面向学习者的文档,在有助于验证时展示状态变更过程与预期结果;需要专业图表、架构图或可视化工具时加载 openpress-plugins。

验证:在共享评审门槛前扫描源文件,运行 open-press search 检查 [TODO:、[DRAFT:、[FIX: 标记,随后遵循 openpress 的评审与交付门槛。构建成功或 PDF 导出本身不等于页面布局已验证。报告需包含 Press slug、标题、几何、源根目录、已写文件、未解决输入和最新验证结果。

边界:不要用创建命令做升级或迁移;不要编辑生成输出,也不要从本技能发布。