tw93/Kami

Kami – AI 驱动的文档设计技能

简介 – Kami 是一个用于 AI 智能体（如 Claude Code、Codex、Cursor 等）的插件/技能，它能将自然语言请求转换为设计精美的 PDF、PNG 或可编辑的 PowerPoint 文件。它内置了八种模板（单页文档、简历、信函、作品集、幻灯片、股权报告、更新日志、落地页），并支持英语、中文、日语和韩语。

工作原理 – 该技能位于智能体的 ~/.agents/skills 文件夹中。当你向智能体发出类似 “make a one‑pager for my startup” 的指令时，它会自动触发 Kami，执行以下步骤：

1. 将请求解析为结构化的简报（受众、目的、语气等）。
2. 将你的内容填充到 HTML 模板中。
3. 使用 WeasyPrint 将 HTML 渲染为 PDF，或通过 python‑pptx 渲染为 PPTX，或渲染为 Marp 风格的 Markdown 演示文稿。
4. 可选地添加由 Mermaid 文本生成的内联 SVG 图表，并重新应用 Kami 的暖羊皮纸色调。
5. 将最终文件返回给你。

核心功能

• 多语言支持 – 完整的英语和中文布局；针对日语/韩语的字体回退机制。
• 八种现成模板 以及落地页系统。
• 图表集成 – Mermaid → SVG → PDF 兼容。
• 品牌配置 – 通过 ~/.config/kami/brand.md 文件存储默认字体、颜色、页面大小、语气等，无需重复设置。
• 零依赖 MCP 服务器 – 一个微型本地 HTTP 服务器 (mcp_server.py) 允许任何支持 MCP 的智能体驱动 Kami，而无需加载整个技能提示词。
• 字体处理 – 脚本自动安装缺失的 CJK 字体；字体已打包以供离线使用。
• 版本检查 – 每日静默检查 GitHub 最新发布版本。

安装

# generic agent install (Claude Code, Codex, Cursor, …)
npx skills add tw93/kami -a claude-code codex cursor -g -y

或者使用 README 中列出的特定主机插件命令，或为 Claude Desktop 下载预构建的 kami.zip。

使用方法 – 无需斜杠命令；只需用支持的语言自然交流即可。示例提示词：

• English: make a resume for me
• 中文: 帮我做一份一页纸
• 日本語: スタートアップ向けの一枚資料を作って
• 한국어: 이력서를 만들어줘

设计理念 – 暖羊皮纸背景 (#f5f4ed)、墨蓝色强调色、衬线字体、宽裕的留白。所有模板遵循相同的视觉节奏，使技术输出既严谨又美观。

许可证 – 代码和模板采用 MIT 协议。CJK 字体拥有各自的许可证（TsangerJinKai02 仅限个人使用，其他采用 OFL）。

更多信息 – 完整规范见 design.md，速查表见 CHEATSHEET.md，在线展示请访问 https://kami.tw93.fun。