editorial-monograph

Editorial Monograph

一种适用于严肃长文的文档样式——日系简约风格与 IBM Carbon hairline 风格的衍生，适合产品提案书、白皮书、研究报告、规格文档等需要 A4 印刷、章节结构清晰、适合长段阅读的场合。

这是一项自带 starter 的 skill：它提供 SKILL 规则，以及可运行的 starter/ 文档工作区（React/MDX 入口、主题、设计文档、示例章节）。使用 openpress 初始化 OpenPress 运行时工作区；此 skill 负责提供编辑风格的 starter 文件和设计规则。

Visual Signature

• 字体：章首使用衬线字体（Noto Serif TC / Source Han Serif TC）+ 正文使用无衬线字体（IBM Plex Sans / PingFang TC）
• 线条：1px 细线 + 链接使用点状下划线；不使用 box-shadow / gradient
• 颜色：黑白灰为主 + 三种状态强调色（warn / success / info）+ 图表调色板（gold / coral / dark）
• 布局：固定 A4 版面、章首占据整页、目录带页码但不显示 footer、可选章节 mini cover、图表 / 表格自动编号
• 章节编号：默认使用 01 / 02 / 2.1（pagination + CSS ::before）；可改为 一、二、（一） 或 Chapter 1 / §1.1，token 和 selector 位于 starter 中的 theme/base/typography.css 以及 design.md 的 Typography Scale / Chapter & Section Numbering 部分

Suitable For

• 产品提案 / 商业计划
• 白皮书 / 规格文档 / 需求文档
• 学术专著 / 长篇研究报告
• 编辑风格的商业报告

Not Suitable For

• 幻灯片（没有 bundled starter；自定义尺寸时修改 config.page，不要把 A4 starter 硬改成幻灯片）
• 海报 / 单页文档
• 营销落地页

Related Starters

• claude-document — 纸张质感更温暖，节奏类似 Claude。适合文档更接近工作简报 / 规格文档 / 笔记，而非正式专著的情况。

Apply To A Workspace

使用 openpress 初始化目标工作区，然后将此 skill 的 starter/press 目录树复制或改编到工作区。然后：

1. 在 press/<slug>/press.tsx 中 <Press> 的 props 上填写 title / subtitle / organization。将 starter/package.openpress.json 合并到工作区 package.json 的 "openpress" 字段，以设置部署 / pdf 选项。
2. 请 openpress 选择所需的验证 / 导出 / 渲染命令，以确认工作区运行正常。
3. 使用 openpress 确定源文件的边界；通常可编辑的源文件区域包括内容文件 press/<slug>/chapters/**/*.mdx、封面 / 目录 / 封底文件 press/<slug>/press.tsx，以及视觉 token 文件 press/<slug>/theme/tokens.css 或 press/shared/theme/tokens.css。

页面内容规则（层级、表格标题、图表编号、事实边界）位于 openpress-create-pages；此 skill 不会重新定义这些规则。

Do / Don't

Do：

• 更换 brand color：修改 tokens.css 中的 --openpress-chart-gold，或新增 --openpress-brand-accent
• 更换字体：修改 --openpress-font-serif / --openpress-font-body 的字体栈；如需在 mobile / iPad 上保持稳定，同步更新 theme/fonts.css 以加载 webfont，不要只依赖 local(...)
• 添加新的 page kind（divider / appendix-cover）：在 theme/page-surfaces/ 中新增 CSS；现有的 chapter-opener 可用作书籍 / 教材章节的 mini cover
• 更换编号样式（一、二、或 §1.1）：修改 theme/base/typography.css 中的 ::before content，并搭配 @counter-style
• 修改 page 尺寸（B5 / Letter / 幻灯片）：修改 press/<slug>/press.tsx 中 <Press page="..."> 的 prop；tokens.css 只保留主题默认值和视觉 token

Don't：

• 不要将 inline emphasis color 改为自由色票（这会破坏语义系统）；新增状态色票前，先补充 --openpress-status-* token，再使用
• 不要在 theme/base/typography.css 中放置单个图表 / 样例的 CSS（这属于 press/<slug>/components/<name>/ 的职责）
• 不要为了容纳密集内容而把字号缩得太小；A4 正文不应低于 9.5pt
• 不要将 hairline 改成 2px 以上的实线；这个 starter 的风格就靠线条纤细

深入设计规则

editorial-monograph 不单独维护 reference/ 文档——所有规格都写在 starter/press/design.md 中，与 starter 一起复制到工作区后，它就会成为该项目的设计文档：

• 第 1 节 风格目标与使用场景 — 目标 / 适用场景 / 角色定义
• 第 2 节 Tokens — typography / color / spacing / page geometry / inline emphasis / chapter & section numbering
• 第 3 节 Components — page surfaces / text components / tables / figures / charts
• 第 4 节 CSS 职责

Agent 应用此 skill 后，这份文件就会成为该项目 press/design.md 的内容；之后 user 想要自定义时，直接修改 design.md，无需回头修改 skill。