Kami 紙
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tw93-kami。
技能介绍
痛点:内容有了,版面却总在「凑合」
工程师和写作者常遇到同一类摩擦:正文可以,但导出成 PDF、一页方案或产品页时,字体、间距和层级各搞一套;幻灯片既要可讲又要能印,却要在 PPTX 和 HTML 之间反复手工对齐。Kami(紙)把「交付物落在哪张纸上」当成一等公民:暖色羊皮纸底、墨蓝强调、衬线主导的编辑节奏,在文档与落地页之间共用一套设计语言。
技能如何组织一次交付
启动时可非阻塞执行 scripts/check-update.sh 做只读版本提示,不阻断任务。若存在 ~/.config/kami/brand.md(或旧路径 ~/.kami/brand.md),按 references/brand-profile.md 的四层规则静默填缺;优先级为:当前对话里的显式要求 > 编辑判断 > 习惯笔记 > frontmatter > 内置默认。
语言与模板在 Step 1 锁定:中文走 *.html / slides-weasy.html,英文走 *-en.html 族,韩文有 *-ko.html;幻灯片默认 WeasyPrint HTML 路径,只有用户明确要可编辑 deck 时才退回 slides*.py 出 PPTX。在选模板前会静默厘清目的、受众与硬性约束,并锁定执行契约(语言、模板、输出格式、页数/长度、验收方式、验证命令);能用现有模板就不新增 CSS 层或依赖。
Step 2 用决策树映射文档类型:一页方案 one-pager、长文/白皮书 long-doc、正式信函 letter、作品集 portfolio、简历 resume、演示 slides、个股研报 equity-report、版本记录 changelog、落地页 landing-page 等。长文/作品集/幻灯片里的图不单独开模板,走 assets/diagrams/ 与 references/diagrams.md;内容带数字时由技能自行选图类型嵌入。工作模式按工件状态分支:新建全文、仅改文案(尽量保留版式)、视觉修复(以用户截图/渲染为 brief 做最小改动)、生成独立插图/封面。
边界与注意点
- 落地页是首屏交互式静态 HTML,不做 PDF;多语言生产需按
references/design.md处理 companion 与{{SITE_ORIGIN}}等占位符。 - 品类上的 changelog 模板是带样式的文档输出;GitHub Release Notes 另走
/write的 Release Note Template Mode,不要混用。 - 当需求已是「文档站 + 多 locale + releases/legal」等产品站形态时,应先锁定产品类别、真实素材、站点形状、语言列表与「真相面」(安装路径、价格、版本、FAQ、
llms.txt等),再套 Product site system,而不是只填单页模板。 - 可选安装 Pygments 时代码块才有语法高亮;未安装时 PDF 仍可出,代码块为单色。
Kami 与 Kaku(写代码)、Waza(练习惯)同属一套命名:Kaku 写代码,Waza 练习惯,Kami 交文档。
使用场景
- 投资人要一页执行摘要且版式统一,需从对话内容生成 `one-pager.html` 并走 WeasyPrint 验收
- 维护开源项目要在 README 架构图与仓库内 `index.html`/PNG 提示词三者一致地更新示意图
- 产品对外页需要 hero、轮播与响应式断点,用 `landing-page` 填占位符后直接静态托管
- 季报式文字里含占比与趋势数字,要在长文或 slide 里自动选型嵌入图表而非手写截图
适合人员
- 要给理事会或投资人交中英双语一页方案、且不愿每次在 Word 里重排版的产品负责人
- 需要在简历、作品集与长白皮书之间保持同一套羊皮纸视觉语言的求职者或技术作者
- 负责对外官网首屏与 FAQ 区块、要把真实截图槽位与 `{{CANONICAL_URL}}` 填齐再部署的独立开发者
- 写个股研报或投资备忘录、希望走 `equity-report` 模板而非零散 Markdown 转 PDF 的初级研究员