openpress-writing

用途：open-press writing 负责文档面向读者的论证内容——写什么、以什么顺序、用什么标题结构，以及哪些事实需要确认；同时是便携写作技能（语气、语言、体裁、教学）的入口。\n\n主要能力：定义受众、目的、叙事流与章节顺序；决定 H1/H2/H3/H4 结构、正式目录深度、阅读大纲深度与附录位置；改写正文、表格、图注与内容过渡；掌握 <TableCaption> 的放置规则；决定正文何时转为表格、图、图表或标注框；保留已确认事实并显式标记缺失事实。\n\n层级契约：# 仅用于整份文档标题，不用于普通内容文件；## 为正式章节，进入正式目录；### 为章内主要主题组，进入正式目录；#### 为具体算法、操作、定理、变体或演算步骤，进入阅读大纲但不进正式目录；正文块承担解释工作。长期文档通常少量 H2、若干 H3、较多 H4。\n\nH4 粒度：用于完整可教学单元，同一操作或算法的块保持一个 H4，仅追加表格、图、追踪、伪代码或代码的相邻 H4 应合并；重复的小测验标题不设为 H4；一个 H3 下优先 3-7 个 H4。\n\n文件策略：扫描 press/chapters/<NN-slug>/content/.mdx；章节目录是持久编辑单元，文件边界只是编辑边界；同一章后续文件可以 ### 或 #### 开头；文件名前缀用于排序而非可见层级；frontmatter 标题是编辑标签，可见结构由 Markdown 标题决定。\n\n组件限制：MDX 组件是阅读辅助而非交互式 UI；不要使用悬浮、点击、展开、标签页等交互暗示，也不要用装饰性卡片、渐变边框、emoji 图标等表面装饰；正式与教学语境下避免这些反模式。\n\n使用方式与触发：涉及繁体中文专业内容加载 chinese-ai-writing-polish；面向学习者的教学笔记、练习、学习指南、教程章节加载 teaching-notes-writing；冲突时按用户明确指示、工作区记忆与偏好、文档简报、open-press-writing 结构决策、便携技能规则的顺序解决，若影响含义或论断则询问用户。\n\n工作流：先确定受众、目标、固定事实与缺失事实；如涉及层级先做结构梳理再起草正文；按触发表加载便携技能；改写时不添加无依据论断；未决事实标为 [TODO: ...]、[FIX: ...] 或 [DRAFT: ...]。\n\n完成检查：可用 rg -n '^#{1,4} ' press/chapters -g '.mdx' 扫描标题，确认结构符合 H2/H3/H4 模型、正式目录未过载 H4 级算法名、阅读大纲 H4 未被微小代码片段或重复测验标签主导。\n\n限制：主题 CSS、视觉系统与组件样式归 openpress-design，图表的语义内容归 openpress-diagram-drawing，CLI 与源/生成边界归 openpress，本技能不重复定义。具体命令与参考资料需在编辑后按 openpress 的验证深度执行；其他事实暂未提供。