Kami · 纸
专业文档与落地页的排版系统：暖米纸底色、墨蓝点缀、衬线层次，一份设计语言贯穿简历、白皮书、PPT 与官网。
证据显示技能在最小权限、数据流透明方面有显著努力：SKILL.md 明确声明更新检查只读、每日至多一次、失败静默；MCP 服务器文档强调只渲染受信任的本地 HTML；材料检查要求用户提供素材，缺失时以空缺表格呈现而非猜测；品牌配置文件仅填缺陷。未发现凭证窃取、外传、破坏性默认行为等红线。但存在扣分项：技能会主动运行外部脚本（check-update.sh），虽然声明无数据发送，但无法静态验证；MCP 服务器允许渲染本地 HTML，但未明确限制文件访问范围；依赖外部字体（如 TsangerJinKai02）从 CDN 下载，涉及网络请求；未提供明确的回滚或撤销操作流程；发布者身份未经验证，但仅作为维护责任的证据，不因此扣分。综合评分为 15，达到主要风险可见但权限、确认、回滚不完整的中档水平。
静态审查下观察到技能包含大量自一致性指令：SKILL.md 提供明确步骤、模板选择表、验证命令（如 build.py --check-*），AGENTS.md 记录了已知陷阱和 CI 注意事项，显示出工程化程度高。但未执行任何命令，无法确认关键路径（如 render.py、build.py 的 --verify）实际工作。依赖项如 WeasyPrint、Pygments、Marp CLI 为可选，但未提供安装失败时的完整降级机制（除了字体恢复脚本）。错误处理方面：SKILL.md 说明了外部命令失败时应静默继续，但未提供清晰、可诊断的错误消息模板。根据静态限制，最高只能给 10 分，即 happy path 可行但测试、边界情况、错误处理覆盖薄。
技能适用场景明确：面向简历、一页纸、白皮书等 8 种文档类型和落地页，受众和用例清晰。SKILL.md 提供了详细的触发词列表（中文、英文、日文），能精准触发，避免误触发。环境适配：明确支持中文、英文、日文、韩文，并对 CJK 字体提供回退；但字体依赖商业字体 TsangerJinKai02 和系统字体，若用户无法安装可能影响中文排版效果，且未明确提供针对大陆网络环境的优化（如 CDN 可访问性）。能力边界声明充分：说明不提供托管服务、非主题引擎，且分步骤逐步披露细节。扣分点：触发条件虽清晰，但未明确列出非适用场景（如简单的纯文本格式化），可能导致过度触发；环境适配对大陆网络依赖外部 CDN 的字体下载未作风险评估。综合评分为 13，接近满分但边界声明和环境适配有少量扣分。
信息架构良好：SKILL.md 提供渐进式披露，按文档类型分步加载所需规范；安装和依赖说明在 README 中详细（插件安装、ZIP 下载）；参数和模板命名稳定，且通过脚本一致性检查；提供了示例（assets/demos）和常见问题说明。license 明确为 MIT，但未提供版本号或变更日志（VERSION 文件存在但未在提供的文件中体现）；维护责任明确（一人维护，联系方式在 contact.md），但未提供更新路径（如如何提 PR）。扣分项：版本和变更日志在提供的文件中未见，可能存在于 docs/release.md，但静态对照不足；已知局限如商业字体使用未在 SKILL.md 中强调。综合评分为 12，达到可读可用但有隐藏假设或治理不完整水平。
静态审查无法验证实际输出效果，但 SKILL.md 详细描述了输出格式（HTML、PDF、PPTX）和验证命令，合理性较高。价值主张明确：通过约束系统减少混乱，声称比手动或替代方案更高效。但未提供实际生成文档的示例（如 assets/demos 中的 PDF 未附在审查材料中），无法确认输出直接可用。根据静态限制，最高只能给 7 分，即完成核心任务但输出完整性、直接可用性证据有限。扣分：暂无执行证据，无法确认是否真能完成用户任务。
SKILL.md 和 AGENTS.md 引用了 CI 工作流（.github/workflows/check.yml 和 release.yml）和测试套件（scripts/tests/test_build.py），但审查材料中未包含这些文件的实际内容，无法验证其真实性。提供了一些可复现的验证命令（如 build.py --check），但未提供第三方执行证据（如 CI 运行日志）。因此，关键断言（如 CI 存在）无法交叉验证。根据静态限制，最高只能给 5 分，即有可审计的原始材料但覆盖薄或有有限的复现可能性。扣分：无第三方证据，且测试和 CI 未在提供的文件中展示。
- 技能会自动运行更新检查脚本，虽声明为只读且无数据发送，但用户应知晓此类网络请求可能发生。
- 生成 PDF 依赖 WeasyPrint 等可选依赖，若未安装，渲染会失败；错误提示可能仅提供安装提示而非完整诊断。
- 中文字体依赖商业字体 TsangerJinKai02，免费版仅限个人使用；若需商业使用，请获取许可证。
- 主功能依赖外部 CDN 下载字体，在大陆网络环境下可能不可达，导致 PDF 渲染效果不佳。
- 技能未提供明确的回滚或撤销操作流程，修改文档后若需恢复原状，需用户自行备份。
这个 Skill 能做什么，适合哪些场景？
Kami 是一套为 AI 代理设计的文档排版约束系统，解决 AI 生成文档时风格漂移、版式平淡的问题。它提供八种文档模板（一页纸、长文档、信件、作品集、简历、幻灯片、个股研报、更新日志）外加落地页系统，每种都有中、英、韩文版本。设计上采用暖米纸底色、单一墨蓝强调色和衬线字体层级，强调编辑式的紧凑节奏。它不仅是模板，还内置了内容提取、校验、密度检查、字体检查等质量门禁，以及内联 SVG 图表和插图委托机制。
Kami 根据用户请求自动识别文档类型和语言，选择合适的 HTML 模板并填充内容。它运行 Python 脚本构建 PDF（默认 WeasyPrint 路径）或 PPTX（可选），并通过多种校验命令检查占位符、内容完整性、页面密度、字体渲染和视觉质量。它还会在任务开始时执行非阻塞的版本检查，并可选地加载用户品牌配置文件（~/.config/kami/brand.md）以应用个性化风格。对于落地页，它会生成可直接部署的静态 HTML 文件。
- 创业者需要为投资人或客户制作一页纸的初创公司简介，希望得到专业排版而非默认的灰色文档。
- 产品经理将长篇幅的调研报告转化为 6-15 页的长文档，要求清晰的章节结构和数据可视化。
- 求职者制作中英文简历，需要遵循严格的写作规范（行动-范围-结果-业务影响）并保证单页密度。
- 演讲者将已有内容快速转变为幻灯片，支持 PDF、PPTX 和 Marp 三种输出路径。
- 开发者或公司希望为自己的应用或工具制作产品落地页，需要包含轮播图、响应式断点和多语言支持。
这个 Skill 有哪些优点和局限？
- 统一的视觉风格，消除 AI 生成的文档漂移，输出专业且一致。
- 覆盖多种文档类型和语言（中/英/日/韩），并提供落地页系统。
- 内置质量门禁：内容 schema 校验、密度检查、字体检查、视觉检查，确保交付质量。
- 灵活的幻灯片路径：WeasyPrint PDF、可编辑 PPTX、Marp Markdown。
- 支持品牌配置文件，可个性化保持一致性。
- 需要安装额外依赖（Python、WeasyPrint、Pygments 可选），不是零配置。
- 中文字体（TsangerJinKai02）仅限个人免费使用，商业使用需获得许可，且字体文件不随技能包分发，需要运行脚本恢复。
- 部分功能（如产品站点系统、屏幕截图验证）需要较高的代理能力和文件系统访问。
- 仅支持暖纸风格，不适合需要高科技感或高饱和多色的设计。
如何安装这个 Skill？
Kami 作为一个包含多个技能的仓库，可通过以下方式安装：
- Claude Code（v2.1.142+）：/plugin marketplace add tw93/kami 然后 /plugin install kami@kami。
- Codex CLI：codex plugin marketplace add tw93/kami 然后 codex plugin add kami@kami。
- Claude Desktop：从 GitHub Releases 下载 kami.zip，在 Customize > Skills > 新建技能中上传。
- 通用代理：npx skills add tw93/kami/plugins/kami -a universal -g -y。
如何使用这个 Skill？
无需斜杠命令，直接以自然语言描述需求即可触发。例如：
- 中文："帮我做一份一页纸"、"帮我排版一份长文档"、"帮我做一份简历"。
- 英文："make a one-pager for my startup"、"build me a resume"、"design a slide deck"。
- 日文/韩文也有对应的示例。
技能会自动选择语言对应的模板，并在结束时输出交付物路径和校验结果。