⚡ 编程工程方法论2026-06-30
Kami:AI 生成的文档,终于有了值得一看的排版
原文链接Kami:AI 生成的文档,终于有了值得一看的排版
原文链接:https://mp.weixin.qq.com/s/7WgmbhQl3GpydDcPlI5YtQ 发布时间:2026-05-06 来源:开源星探
摘要
tw93 的 Kami——给 AI 写的文档设计系统,八条铁律约束让 AI 输出的 PDF 有印刷品级排版,不再是一堆默认黑体白底的廉价感。4400 收藏,以 Claude Code Skill 形式分发,一句话生成 PDF,支持中/英/日三语。tw93 工作方法论三部曲最后一环:Kaku(写代码)→ Waza(练技能)→ Kami(交文档)。
为什么要 Kami
AI 生成的文档永远默认黑体白底、段落没节奏、两次输出风格不同——哪怕内容有价值,视觉上的挫败感已经耗尽阅读欲望。Kami 解决的问题:不是又一套模板,是一套跨文档的约束集合,每条都有工程理由。
八条设计铁律
- 页面背景用 #f5f4ed 暖米色 — 纯白刺眼、打印廉价,米色是整个系统的情感基础
- 强调色只有油墨蓝 #1B365D — 全文档占比不超 5%,单一焦点不分散
- 所有灰色必须暖调,禁止冷蓝灰 — #6b7280 这种 SaaS 灰放文档里显廉价
- 每种语言只用一种 serif 字体 — 英文 Charter、中文仓耳今楷 02、日文 YuMincho,不混搭
- 字重固定,不用 bold — 需要强调用字号或左侧竖线,不加粗反而更有格调
- 行距三档,禁止 1.6+ — 紧凑标题 1.1-1.3 / 密排正文 1.4-1.45 / 阅读正文 1.5-1.55
- Tag 背景必须实色 hex,禁止 rgba() — WeasyPrint 渲染 PDF 时 rgba 会导致双层矩形 bug
- 阴影只用 ring shadow 或 whisper shadow — 描边阴影或极轻浮起,SaaS 界面式硬阴影放文档很突兀
六种文档类型
| 类型 | 适用场景 |
|---|---|
| One-Pager | 一页纸报告、公司简介、产品介绍 |
| Long Doc | 白皮书、长篇分析、研究报告 |
| Letter | 推荐信、正式信函、商务函件 |
| Portfolio | 项目作品集、个人展示 |
| Resume | 简历、个人履历 |
| Slides | 演讲稿、演示幻灯片 |
内置 12 种 SVG 图表(架构图/流程图/甘特图等),AI 直接注入文档,不依赖外部图片。
安装
npx skills add tw93/kami -a claude-code -g -y
安装后自然语言描述要什么文档,Skill 自动触发,无需额外指令。
关键信息
- GitHub: https://github.com/tw93/Kami
- Slogan: "Good content deserves good paper."
- 核心判断: 不是 UI 框架,是为印刷品设计的约束系统。文档应该读起来像精心编排的页面,而不是仪表盘。