用 Kami 把 Agent 产出变成打印就绪的文档

让 agent 写一份研报或简历，拿到的永远是同一种默认文档样式：灰色、扁平，每次排版还不一样。Kami——tw93 出品、12k 星的 skill——给 agent 换上一套固定的设计系统：羊皮纸底色、墨蓝点缀、衬线字体，外加八个文档模板，输出 PDF、PNG 或可编辑的 PowerPoint。

为什么这个 Skill 重要

Kami（紙，日语的「纸」）解决的是 agent 工作里的交付环节。仓库把它定位为三部曲的第三件：Kaku 负责写代码，Waza 打磨工程习惯，Kami 负责交付文档。普通对话到文字就结束了，Kami 会继续套用排版规则——字号、间距、配色——并在交付前检查结果。

模板覆盖了人们真正要交付的文档类型：One-Pager、Long Doc、Letter、Portfolio、Resume、Slides、Equity Report、Changelog，外加一套 Landing Page 系统。每个模板都有 EN、CN、KO 三个变体，Kami 根据你使用的语言自动选择。内置十八种内联 SVG 图表类型，时序图、类图和 ER 图还可以直接用 Mermaid 文本生成。

安装

一条命令即可安装到 Claude Code、Codex、Cursor 等多个 agent：

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

skill 会装进共享目录 ~/.agents/skills。Claude Code 以符号链接方式接入，读取该目录的 Codex、Cursor 及其他 agent 会把 Kami 识别为 /kami。之后用 npx skills update -g -y 更新。

如果你偏好宿主自己的插件流程，Kami 也以 /kami:kami 命名空间提供（需要 Claude Code v2.1.142 或更新版本）：

# Claude Code (update: claude plugin update kami)
/plugin marketplace add tw93/kami
/plugin install kami@kami

# Codex (update: codex plugin marketplace upgrade kami, then codex plugin add kami@kami)
codex plugin marketplace add tw93/kami
codex plugin add kami@kami

Claude Desktop 用户需要下载 kami.zip 发布附件——README 强调用发布 ZIP，不要用 GitHub 的源码 ZIP——然后在 Customize > Skills 里上传。Windows 用户请在 WSL 内运行 Kami：辅助脚本是 Bash，而且原生 Windows 上的 WeasyPrint 还需要单独安装 GTK/Pango 运行时。

实战：从草稿到打印就绪的一页纸

1. 安装 skill 后开一个新会话。
2. 粘贴内容并用自然语言提出请求——skill 会自动触发，不需要斜杠命令：

用 Kami 把这份产品介绍整理成一份一页纸，受众是第一次接触我们的客户，
重点保留使用场景和三个核心卖点，输出 PDF 和 PNG 两个版本。

3. Kami 选定 One-Pager 模板，并用一份结构化 brief 记录受众与要求。布局执行前，内容 schema 先检查结构；版面填完后，覆盖率检查会找出遗漏的内容。
4. 检查产出——渲染出的页面图片支持最终的视觉核对，如果 agent 没有主动展示，就要求它出示。

幻灯片走同样的流程，默认用 WeasyPrint 把 HTML 渲染成 PDF；要求可编辑的 PPTX 时，Kami 改用 python-pptx；想用 Markdown 维护幻灯片，可以要求 Marp 版本。如果你持续产出文档，可以配置可选的品牌档案：创建 ~/.config/kami/brand.md，用 YAML frontmatter 写结构化字段（姓名、职位、邮箱、品牌色、语言、页面尺寸、语气），正文用 Markdown 记自由笔记，Kami 会在你的请求留有余地时套用这些设置——你的明确指令始终优先。

技巧

• 要在家用或办公打印机上输出？白纸变体需要主动要求：它会把羊皮纸底色翻成白色，卡片和表格里保留暖色调。
• 时序图、类图和 ER 图可以直接给 Mermaid 文本，渲染器会自动把 SVG 重新配色成 Kami 风格。
• 安装了 Pygments 时，代码块带语法高亮；没有装也不影响 PDF 输出，代码保持单色。
• 中文输出默认使用仓耳今楷，该字体仅限个人免费使用——商用需要向 tsanger.cn 获取授权。
• Kami 每天至多做一次安静的版本检查，不上传任何文档或任务内容；离线时静默跳过。

何时不用这个 Skill

Kami 负责渲染文档，不做数据分析，也替代不了 BI 工具——请先准备好定稿的数据。WSL 之外的原生 Windows 不受支持。如果你的品牌要求模板未内置的专有字体，需要自行调整主题，而不是开箱即得。

查看 排行榜 了解更多 skill。