SuperAPI AI 工具集

openpress

办公与效率

查看项目

更新于 10-16 08:19

技能介绍

用途

OpenPress 技能用于 OpenPress CLI 与交付相关工作的总入口。当任务涉及 CLI 生命周期、工作区检查、生成输出、PDF/图片/Word 导出、源码边界判断,或需要路由到其他 OpenPress 技能时,应优先使用本技能。

主要能力

本技能的核心能力是路由与边界管理,而非直接创建内容。根据需求,它会将任务导向对应的子技能:

  • 页面产物创建:openpress-create-pages
  • 幻灯片创建或编辑:openpress-create-slide
  • 已撰写内容的分析、提案或修订:openpress-collaborate
  • 待处理的 @openpress-comment 标记:openpress-apply-comments
  • 外部插件(图表、可视化工具、写作辅助):openpress-plugins
  • 包升级或迁移:openpress-upgrade
  • 部署或发布:openpress-deploy

仅在内容需要时,才加载可移植的语言或体裁技能。

源码边界

技能明确划分了各层的可编辑规则:

  • 工作区源码:press/*/press.tsx、已注册的 MDX/TSX 源、press/<slug>/{components,theme,media}/、可选的 press/shared/、press/design.md、openpress/settings.json,这些是可编辑的。
  • 技能源码:skills/、.agents/skills/、.claude/skills/,在技能工作时可编辑。
  • 框架源码:packages/core/、packages/cli/、apps/web/、根配置/文档/测试,仅用于框架工作。
  • 评审交接:.openpress/review/current.json,openpress-collaborate 可替换或删除,但绝不交付或提交。
  • 已安装框架:node_modules/@open-press/{core,cli}/,只读,需在上游修复。
  • 生成/缓存:public/openpress/、dist-react/、.deploy/、其他 .openpress/、.turbo/cache/,绝不手动编辑。

openpress/settings.json 负责工作区外观、页面默认值、标题编号、PDF 文件名和部署配置。Press 视觉设计仍保留在 press/design.md 和每个 Press 主题中。

如果存在 memory/AGENTS.md,应先阅读,它标识下游工作区及其项目规则。

使用方式

本地评审门禁

在内容、布局、组件、Press Tree 或分页敏感主题变更后:

npm run build
npm run dev              # 下游工作区
# npm run dev:workspace  # 框架 dogfood 仓库

打开 Vite 的 /workspace,检查受影响的 Press 的页数、溢出/裁剪、分页、排版/媒体和待处理评论。必要时修复源码并重复。

仅在本地 Workbench 评审后,才导出请求的交付格式:

npm run openpress:pdf
npm run openpress:image
npm run openpress:word

PDF/图片/Word 导出不能替代 Workbench 评审。

刷新边界

Vite HMR 不会重新生成 public/openpress/<slug>/document.json。在 MDX、Press Tree、组件、元数据或分页敏感主题编辑后,需先运行 npm run build 再评审。为加快内循环,可运行 open-press export . 并刷新浏览器。不移动内容的纯 CSS 编辑可仅使用 HMR。

CLI 与参考

优先使用包脚本。下游命令若无包装器则使用 open-press;框架仓库使用 node packages/core/engine/cli.mjs,因为其二进制未在本地构建。

仅在以下情况阅读 references/cli-commands.md:命令未在上文展示、源码搜索/替换、检查,或非标准验证深度。

每当评审门禁适用或需要 Workbench 控件时,阅读 references/local-review.md。

仅在框架工作改变 Press Tree/运行时契约时阅读 references/render-boundary.md,而非普通工作区撰写。

新产物由 openpress-create-pages 或 openpress-create-slide 负责;不要将创建命令用作升级工具。

适用场景

适用于 OpenPress 工作区中的 CLI 操作、交付流程、导出、源码边界判断和技能路由。

限制

资料未提供具体的收费、价格、平台支持范围或效果数据。部分命令与参考文档的详细内容需查阅对应 references 文件。