再也不用调文档样式了!Claude Code 这个 4.5k Star 文档神器,5 天爆红

• AI 写出来的文档为什么"一眼就丑"
• Kami 的反向定位：不教生成什么，教"长什么样"
• 5 条设计规范：克制是最高级的精致
• 8 种文档类型 + 14 种 SVG 图表
• 3 种语言的字体方案：每一个选择都有理由
• 一行命令装好：研发能用 Kami 干啥
• tw93 的开源三部曲：Kami 是收尾
• 我的判断

AI 写出来的文档为什么"一眼就丑"

让 Claude 帮你写一份周报、产品文档、研究报告——内容都没毛病，但导出 PDF 之后你就是不想发出去。

为什么？因为它长得太"AI 默认"了 ——纯白底、Arial 字体、段落之间一行空白、链接全是蓝色下划线。内容是你的，但视觉是 AI 自动生成的统一公模脸 。

写美股研究报告的 tw93 也卡在这——他喜欢让 Claude 帮他写公司分析，但每次出来都"平平整整、毫无变化、翻几页就累"。他自己一条条调样式，调到某天发现「这套东西已经不止适合美股报告了——什么文档都能套」。于是顺手开源出来——这就是 Kami。

项目口号只有一句 ：*"Good content deserves good paper"*（好内容值得好纸张）。截至本文发稿 GitHub Star 4.5k+ ——比刚发那阵涨了快 50%。

仓库地址：https://github.com/tw93/Kami ｜ 官网：https://kami.tw93.fun

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

• 项目地址：https://github.com/YunaiV/ruoyi-vue-pro
• 视频教程：https://doc.iocoder.cn/video/

Kami 的反向定位：不教生成什么，教"长什么样"

市面上 Skill 类工具的常规做法是「教 AI 生成什么内容 」——给 Claude 一段 prompt，告诉它怎么写代码、怎么写文档。

Kami 走的是反向路子 ——它不管你写什么内容，它管"出来之后长什么样" ：

• 不是「帮我把美股研究报告写成 5 段 」
• 而是「帮我把美股研究报告印成一份能打印、能发邮件、能截图分享的专业文档 」

这个反向定位的好处是——内容你想怎么写都行，但视觉一定 OK 。研究报告、产品文档、简历、PPT、作品集——只要你有内容，Kami 负责让它"印出来不丢人"。

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

• 项目地址：https://github.com/YunaiV/yudao-cloud
• 视频教程：https://doc.iocoder.cn/video/

5 条设计规范：克制是最高级的精致

Kami 不是简单地"换个字体换个颜色"——它定义了一套克制到极致 的设计规则，所有文档都要在这套规则里运行：

• 底色不用纯白 ：所有页面背景是 #f5f4ed，接近羊皮纸的颜色，有一点暖、看着不刺眼 。这一条不起眼，但放在屏幕上立刻比纯白舒服很多。
• 强调色只有一个 ：整个文档里有颜色的地方只能用墨蓝 #1B365D ——还限制面积不能超过全页 5%。没有第二个彩色 。这条限制逼着排版专注于"结构本身"——不能靠颜色乱晃来吸引眼球。
• 灰色也要暖 ：文档里所有中性色全部带黄褐色调 ，禁止出现带蓝调的冷灰 。这一条让整体色温保持统一——不会出现一块冷一块暖的割裂。
• 阴影只用极轻的 ：允许 Ring 或轻微的 Whisper Shadow，不允许硬投影 ——避免做出"网页 Banner"那种厚重感。
• Tag 背景必须实色 ：Tag 类元素只能用纯 Hex 值（#xxxxxx），不能用 rgba() 。这条是给 WeasyPrint（PDF 渲染工具）打补丁——rgba 背景在 WeasyPrint 里会出现重叠矩形 bug，实色直接绕开 。

这五条加起来，形成了 Kami 的视觉基调——暖、静、有层次 。

8 种文档类型 + 14 种 SVG 图表

按官方 README，Kami 内置 8 种文档类型 ——每种都有独立的中英文模板：

• One-Pager（一页纸） ：公司 / 产品介绍压成一张 A4。示例用了特斯拉的公司简介，核心信息一眼抓住 。
• Long Doc（长文档） ：研究报告、技术说明这类多页内容。行距和字号管理得很细——密排正文行距 1.4-1.45、阅读性正文 1.5-1.55 ，读起来不累。
• Letter（正式信件） ：商务沟通 / 正式函件。
• Portfolio（作品集） ：项目经历展示，独立布局结构，适合设计师 / 开发者整理工作成果 。
• Resume（简历） ：很多人最常用的。不靠花哨颜色块吸引注意，靠字体和间距的层级 。示例用了 Elon Musk 的虚构简历可以参考。
• Slides（幻灯片） ：生成 Keynote 风格演示文稿。项目里有 AI Agent 主题示例，6 张左右、布局简洁、零装饰 。
• Equity Report（股权 / 美股研究报告） ：tw93 的本职——给美股分析报告专门做的模板。
• Changelog（变更日志） ：版本迭代记录。

另外内置 14 种 SVG 图表类型 ——折线图、环形图、架构图等常见形式——风格和文档整体保持一致，不需要再引入额外图表库 。

3 种语言的字体方案：每一个选择都有理由

字体是文档的灵魂。Kami 给三种主要语言分别选了不同的字体方案 ，每个选择都有理由：

行高也有明确规定——标题 1.1-1.3，密排正文 1.4-1.45，阅读性正文 1.5-1.55 。字重方面标题 500，正文 400，绝不用算法合成的假粗体 ——后者在 PDF 渲染里经常糊。

一行命令装好：研发能用 Kami 干啥

Kami 当前支持 4 种接入方式 ——按你已有的工具链选：

Claude Code 环境 ——一行装好：

npx skills add tw93/kami -a claude-code -g -y

Codex / OpenCode / Pi 等支持 ~/.agents/ 路径的 Agent 工具 ——README 给的是一条通用命令（用 -a '*' 覆盖所有 agents、Codex 也走这一条）：

npx skills add tw93/kami -a '*' -g -y

Claude Desktop ——稍麻烦一点：从仓库下载 kami.zip，在 Claude 设置 → Customize → Skills → 「+」 → Create skill，直接上传 zip （不需要解压）。

装好之后不需要任何启动命令 ——Kami 自动识别自然语言请求：

帮我做一份一页纸帮我排版一份长文档帮我写一封正式信件帮我做一份作品集帮我做一份简历帮我做一套演讲幻灯片

Kami 会根据你写的是中文还是英文，自动匹配对应语言的模板 。

研发能用它干啥？我自己平时用得最多的 4 个场景：

• 季度 OKR 复盘 → 一页纸模板，5 分钟出一份能甩到群里的版本
• 内部技术分享 → Slides 模板替代 Keynote，写完直接 PDF 发群
• 职业简历 → Resume 模板，比模板网站下载的好看 10 倍
• 项目作品集 → Portfolio 模板，给 GitHub README 当门面

tw93 的开源三部曲：Kami 是收尾

Kami 是 tw93 三个开源项目里的最后一个——三个项目分层负责不同的事：

• Kaku（書く） — 负责写代码
• Waza（技） — 培养开发习惯
• Kami（紙） — 负责交付文档

如果你已经在用 Kaku 写代码、Waza 练习——那么 Kami 就是这条链路的收尾 ：上游产出的内容，最后经由 Kami 变成可以正式提交的文档。

tw93 在国内开源圈不是新人——他还有两个高 Star 项目：Pake （把网页打包成桌面应用，38k+ Star，仓库 https://github.com/tw93/Pake）、妙言 （Markdown 编辑器，6k+ Star，仓库 https://github.com/tw93/MiaoYan）。有人愿意给他的项目押注是有道理的 ——他做开源属于"克制 + 长期维护"那一类——不会随便挖坑就跑 。

我的判断

如果你日常用 AI 大量做文字工作——周报、报告、文档、简历——但又懒得每次都调样式，Kami 是目前最省事的一个 Skill 。

它不要求你学什么新软件、不要求你改变工作方式——只是把一套设计规范注入 AI 已经在做的事 。代价是 30 秒装一下 Skill；收益是导出来的 PDF / HTML 一眼就比"AI 默认稿"高一档 。

如果你的需求是动态页面 / 互动式报表——这不是它的强项。但如果你需要每隔几天交一份"看起来就很专业"的 PDF / HTML 文档 ——Kami 真能省你不少动手的力气。

仓库地址：https://github.com/tw93/Kami ｜ 官网：https://kami.tw93.fun

AI 时代缺的不是"内容生成"——缺的是"输出标准" 。Kami 把"标准"那一步外包成了一个 Skill。