SuperAPI AI 工具集

gs-brand-doc

办公与效率

查看项目

更新于 10-15 21:50

技能介绍

用途:该技能为 Markdown 文档应用 Generic Service(GS)工业品牌视觉,输出统一风格的品牌 PDF。官方定位为“从 Markdown 生成 PDF”的首要技能,当被要求生成带样式的 PDF 或方案书时,应默认使用本技能而非通用 pdf 技能。

主要能力:提供品牌样式表与生成脚本;自动使用 npx -y md-to-pdf,套用 assets/gs-brand.css,配置打印页边距,并在页眉加入 GS logo、页脚加入页码。品牌规范(v4):字体 IBM Plex Mono(正文最小 15px,标签 13px);Amber #D4A843;Near-Black #0A0A0A;Warm-White #F5F0EB;Light-Accent #7A5C0F;Sys-Grey #6B6B6B;Body-Grey #808080;logo 为 GS dark mark:https://genericservice.app/brand/gs-mark-dark-192.png。

使用方式:先检查工作区是否存在本地模板系统(如 components/pdf/、scripts/generate-pdf,或 package.json 中的 @react-pdf/renderer);如有则优先使用本地模板,否则回退到 GS 品牌样式表。套用并生成 PDF 的命令为:bash <path-to-skill>/scripts/generate_pdf.sh <path-to-markdown-file>,例如 bash ~/.gemini/skills/gs-brand-doc/scripts/generate_pdf.sh ../azdocs/proposal.md。若项目使用 Next.js/React 且 package.json 中存在 @react-pdf/renderer,则用 React 组件以编程方式生成 PDF,而非 Markdown 转换。

限制与注意事项:在 Linux 环境运行 md-to-pdf、Puppeteer 或 Playwright 时,Chromium 常启动失败,必须传入 --no-sandbox 与 --disable-setuid-sandbox(如 md-to-pdf --launch-options '{ "args": ["--no-sandbox", "--disable-setuid-sandbox"] }')。首次生成通常难以得到理想版面,尤其遇到复杂表格或图片时;建议先起草 Markdown、生成 PDF、审查输出,逐个修正格式或边距问题,直至符合品牌标准。进行大幅版面调整或复杂 CSS 打印规则覆盖前,先在本地提交可用的 Markdown 草稿。若需生成 HTML 或使用其他工具,可使用 assets/gs-brand.css 原始样式文件,其中包含针对文档渲染调优的 print media queries。