Kami

Kami（日语“紙”，意为纸）是一款专为 Claude Code、Codex 及其他 AI 代理设计的文档美化技能（Skill）。它拒绝通用的“企业灰”或浮夸的“SaaS 渐变”，转而追求一种温暖、权威且适合印刷的美学标准。

Kami 的核心理念是：好内容值得好纸张。 它将每一份文档视为一件精心排版的文学作品，而非冷冰冰的数据仪表盘。

设计哲学：温暖的羊皮纸与墨蓝

Kami 建立了一套严格的美学约束系统，消除视觉噪音，让阅读回归本质：

• 画布：使用 #f5f4ed 羊皮纸色，坚决摒弃刺眼的纯白背景，营造纸质阅读的温润感。
• 点缀：仅使用墨蓝色 (#1B365D) 作为唯一强调色，克制而典雅。
• 字体：
  • 中文：TsangerJinKai02（衬线，权威感）+ 思源黑体（功能）。
  • 英文：Newsreader（衬线）+ Inter（无衬线）。
• 排版：
  • 字重：衬线体锁定字重 500，不加粗，保持优雅统一。
  • 行高：紧凑标题 (1.1-1.3) 与舒适正文 (1.5-1.55) 形成节奏，拒绝松散。
  • 阴影：仅使用极淡的环形阴影，避免硬投影带来的廉价感。
• 图表：内置三种内联 SVG 图表（架构图、流程图、象限图），风格与文档整体完美融合。

快速安装

Kami 支持主流 AI 编码代理，一键即可集成。

Claude Code / Codex / 通用代理

在终端运行以下命令：

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

# Codex
npx skills add tw93/kami -a codex -g -y

# 其他从 ~/.agents/ 读取的工具 (如 opencode, pi)
npx skills add tw93/kami -a '*' -g -y

Claude Desktop

1. 从 Releases 下载 ZIP 包。
2. 打开 Claude Desktop → Customize → Skills → “+” → Create skill。
3. 上传 ZIP 文件。

如何使用

无需输入复杂的斜杠命令，只需在对话中自然描述你的需求，Kami 会自动触发并应用其设计规范。

示例提示词：

• “为我的初创公司制作一页纸介绍 (One-pager)。”
• “帮我制作一份极简风格的简历。”
• “给我写一封正式的推荐信。”
• “为我的技术演讲设计一套幻灯片，包含架构图。”
• “把这份技术文档变成一份精美的白皮书。”
• “生成一份展示我开源项目的作品集。”

Kami 会自动识别语言（中/英），并选择对应的字体变体和排版规则。

支持的文档类型

Kami 覆盖了六种核心文档场景，每种都经过精心调优：

1. 一页纸 (One-pager)：高密度的信息概览，适合项目简介。
2. 长文档 (Long-form)：白皮书、技术报告，注重长时间阅读的舒适性。
3. 信件 (Letter)：正式函件，体现尊重与专业。
4. 作品集 (Portfolio)：展示项目成果，视觉与内容并重。
5. 简历 (Resume)：清晰、权威，突出关键经历。
6. 幻灯片 (Slides)：配套演讲的视觉辅助，包含内联 SVG 图表。

背景故事：开发者 tw93 的审美坚持

Kami 诞生于开发者 tw93 对 AI 生成文档“丑陋默认值”的忍耐极限。

作为一名美股投资者，他经常让 AI 生成分析报告，但输出结果往往像默认的 Google Docs：平淡、不一致、过目即忘。为了得到真正愿意反复阅读的文档，他不断调整排版、颜色和间距，最终沉淀出一套个人美学标准。

随后，在准备《你所不知道的 Agent》演讲时，他将这套标准扩展至幻灯片和内联图表，形成了完整的视觉语言。如今，Kami 作为“三部曲”中的小妹（大哥是写代码的 Kaku，大姐是训练习惯的 Waza），正式开源，希望让每一位开发者的输出都能拥有“纸”的质感。