Kami (紙)：AI Agent 的文档设计系统

> 来源: https://github.com/tw93/Kami

> 日期: 2026-06-05

> 作者: tw93 — 中国独立开发者（145K+ GitHub Stars），Pake / MiaoYan / Kaku / Waza 作者

> 最新版本: V1.7.0 Korean Paper (2026-06-03)

一句话版本

Kami 是一个"给 AI Agent 用的文档排版系统"——你让 Claude 帮你写一份投资报告或简历，它不再是普通灰色 Markdown，而是直接输出一份排版考究、暖色调、衬线字体、可以直接打印的 PDF 文档。

这是什么

Kami（紙，日语"纸"的意思）是 tw93 创建的 AI 文档设计系统。核心思想是：AI 生成的内容需要排版约束，否则每次输出都是不同的丑样子。

它是一个 Claude Code/Codex Skill + 设计约束系统，定义了一套严格的排版规则（暖底色、单一墨蓝强调色、衬线字体系列），Agent 通过自然语言指令就能生成 9 种文档类型。

三部曲

Kami 是 tw93 工具三部曲之一：

项目	含义	功能
Kaku (書く)	写	AI 编程专用终端（WezTerm 定制 fork）
Waza (技)	技能	工程习惯→Claude Skills，8 个斜杠命令
Kami (紙)	纸	文档设计系统，本报告

核心模板

9 种文档模板，覆盖大部分专业文档需求：

模板	用途
One-Pager	一页纸总结/公司简介
Long Doc	长文报告/研究分析
Letter	正式信件/邀请函
Portfolio	项目作品集
Resume	个人简历（中英日韩）
Slides	演讲幻灯片（WeasyPrint / PPTX / Marp）
Equity Report	美股研究报告
Changelog	版本变更日志
Landing Page	产品落地页

设计系统

Kami 的设计不是 UI 框架，而是一个用于印刷品的约束系统：

规则	值
画布底色	#f5f4ed 暖黄，从不纯白
唯一强调色	#1B365D（墨蓝）
中性色	暖调（黄棕底色），禁止冷蓝灰
衬线字体	Body 400 / Heading 500，禁用合成粗体
行高	标题 1.1-1.3 / 紧凑 1.4-1.45 / 阅读 1.5-1.55
阴影	只允许环形阴影和轻声阴影，无硬阴影
标签底色	纯 hex，避免 rgba 导致的 WeasyPrint 双矩形 bug

中英日韩各使用一种衬线字体：

英文: Charter（系统自带）
中文: TsangerJinKai02（个人免费，商用需授权）
日文: YuMincho（系统自带）
韩文: Source Han Serif K（OFL 开源）

14 种内联 SVG 图表类型，涵盖架构图、流程图、数据图表。

使用方式

安装


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

# Claude Code v2.1.142+ 插件市场
/plugin marketplace add tw93/kami
/plugin install kami@kami

# 通用 Agent
npx skills add tw93/kami -a '*' -g -y

# Claude Desktop
下载 kami.zip → 自定义 > Skills > + > 创建技能 → 上传

使用

Agent 自动触发，不需要斜杠命令。中文示例：

"帮我做一份一页纸"
"帮我排版一份长文档"
"帮我写一封正式信件"
"帮我做一份简历"
"帮我做一套演讲幻灯片"
"帮我做一个产品落地页"

品牌配置

~/.config/kami/brand.md 可配置个人品牌：姓名、角色、邮箱、网站、品牌色、语言、纸张尺寸、货币格式、语气风格等。

评价

Kami 的设计哲学非常出色：

1. "约束即自由" — 9 种模板 + 一套严格设计规则，反而让 AI 输出更可靠

2. Agent-native 设计 — SKILL.md + AGENTS.md + CLAUDE.md 完整覆盖所有 Agent 框架

3. 文化包容 — 中英日韩四种语言一等支持，每种语言独立字体

4. 多层渲染 — 幻灯片支持 HTML→PDF / PPTX / Marp 三种路径

5. 品牌个性化 — brand.md 让输出带有个人风格

类比来说：Kami : Framer/Markdown = OpenClaw Skills : 普通脚本——在特定领域用约束系统释放 AI 的潜力。

与我们的关联

tw93 的 trilogoy（Kaku→Waza→Kami）和 OpenClaw 的技能生态有很强的互补性：

Jay 的 deep-research 报告系统可以用 Kami 的模板来做排版
Kami 的 SKILL.md 设计值得参考
brand.md 的模式可以引入到 OpenClaw 的个性化输出中

评分

维度	评分	说明
设计质量	★★★★★	暖色调+墨蓝的系统非常优雅，排版细节精致
实用性	★★★★★	解决了 AI 生成文档无排版痛点的终极方案
Agent 集成	★★★★★	SKILL.md + 插件市场 + 多种安装路径
开源程度	★★★★★	MIT 许可证，字体兼容各平台
推荐程度	★★★★★	每个用 AI 写文档的人都应该装