用途
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 文件。