Agent Skills
返回列表
水墨风技术长文编排

水墨风技术长文编排

内容创作 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c25a863/inkwash-editorial-web-article。

技能介绍

要解决什么问题

技术团队常把论证型长文做成「幻灯片风」或堆满圆角卡片:数据被视觉牵着走,移动端排版也对不齐正文栏。Inkwash Editorial Article 面向「暖纸上的当代技术社论」:论据可读、证据可查,水墨只承担材质与强调,而不是山水装饰或企业模版皮肤。

技能如何工作

每次任务先读 references/style-language.md;若涉及头图、架构图、流程图或概念插画,再读 references/image-generation.md。新建页时从 assets/article-template.html 与 assets/inkwash-theme.css 复制独立页面;改既有站点则先检视 HTML/Markdown、提纲与现有图,标明目标文件并隔离无关脚本与数据。

编排顺序大致固定:抽出叙事主线(问题、张力、证据、机制、建议、收束)→ 把各段映射到最小视觉形态(数值对比用图表 + 可访问数据表;顺序与归属用代码向图示或架构图;抽象机制用概念插画;短规则用 callout/引用/三列表格;普通叙述不加额外卡片)→ 套用统一页面系统里的样式 token 与组件规则 → 只对确实降低阅读成本的图调用 imagegen,并写好 caption、alt 与项目内路径 → 交付前校验桌面与移动布局。

证据图优先用 ECharts 等确定性图表库,.palette 与 inkwash-theme.css 一致;每张交互图配可见的图表/数据切换或表格兜底。宽栏仅给 .is-wide 认定的高密表、主图或 pull quote,普通卡片与正文共享同一内容边距。

适用边界与注意点

Hero 默认以文字为主,除非用户明确要求,不要在标题旁铺装饰笔触或头图云。定量图形必须精确,不能为「水墨感」扭曲数据;密集中文标签宜先出无字底图再在 HTML/SVG 上叠加。交付前需对照技能内 Verify 清单:标题层级、320px 可读性、边距对齐、prefers-reduced-motion、以及 390px 下根滚动宽度不超出视口等。

使用场景

  • 已有 Markdown 提纲与数据,需落成独立 HTML 技术社论页并统一暖纸边距与字体系统
  • 老文章只有圆角卡片堆砌,要按叙事段映射图表、callout 与概念图且不改无关脚本
  • 评审稿需补充架构图或流程示意,须按 image-generation 契约单次生成并校正箭头与标签
  • 含 ECharts 对比实验的长文交付前,要在桌面与 320px 宽屏下核对表格兜底与 .is-wide 宽栏

适合人员

  • 负责对外发布机理说明与实验结论的技术写作者,希望页头像纸社论而非仪表盘
  • 要把内网 Wiki 导出 HTML 再套品牌化阅读体验的前端,需保留原结构只换模板与主题
  • 做性能或架构复盘时要配精确对比图、且交互图必须带数据表兜底的工程师
  • 带插画 brief 的编辑/设计协作方,需要 AI 按固定色谱生成概念图并写入项目目录