企业品牌文档规范
将生成的演示文稿、表格和 PDF 统一为一致的企业品牌风格。
代码主要生成配置字典,不显示网络访问、凭据处理或破坏性外部操作,因此未触及红线;但没有权限边界、用户确认、数据流说明、回滚机制或敏感数据处理指南,且 logo_path 指向未提供的资源,故扣分。
三个格式化路径和若干验证函数结构基本一致,未知文档类型会返回明确异常;但没有针对关键路径的测试,缺少输入类型、缺失字段和实际文件生成的错误处理,validate_fonts 等解析逻辑也较脆弱,静态审查下不超过10分。
场景、支持的 Excel/PowerPoint/PDF 配置类型和部分格式规则较明确;但实际只返回配置而非完成文档,Acme Corporation 是固定占位品牌,未说明触发条件、非适用范围、中文排版或中国大陆环境适配,因此扣分。
SKILL.md、REFERENCE.md 和脚本具有可读的信息分层,包含示例、限制提示、MIT 许可证和部分版本历史;但缺少安装/依赖说明、真实资源路径、API 稳定性、变更记录与明确维护责任,且 README 的仓库定位与该品牌技能不一致,故扣分。
脚本可为三类文档生成格式配置,并提供颜色、数字和内容验证,具备一定直接价值;但不能自行创建或修改 Excel、演示文稿或 PDF,logo 和模板也未实现,输出仍需较多集成和人工复核,故仅给有限分数。
源代码、文档和示例提供了可审计的一手材料,接口行为可通过阅读推断;但未见针对该技能的测试、CI 覆盖或第三方执行证据,不能静态确认实际输出,故不超过5分。
- 该技能将 Acme Corporation 及其品牌资产硬编码,直接用于其他组织可能产生错误或误导性品牌输出。
- apply_brand.py 只生成配置字典,不负责实际文件渲染;assets/acme_logo.png 未在提供材料中出现。
- 未提供该技能专属测试或可复现执行证据,使用前应验证实际库适配、输入边界和生成文件结果。
- 颜色和字体验证存在解析局限,且未覆盖中文字体、分页、可访问性和复杂模板场景。
它能做什么 & 适用场景
该技能为 Acme Corporation 生成的文档规定统一的品牌颜色、字体、版式、语气和数据呈现方式。它覆盖 PowerPoint、Excel 和 PDF,并定义了标题层级、页边距、表格、图表、页眉页脚及标志使用规范。技能还提供最终检查清单和禁止元素说明。源文件提到两个 Python 脚本,但没有说明其运行方式。
为生成的文档应用 Acme 蓝、海军蓝、白色及指定辅助色;规定 Segoe UI 等字体和标题层级;定义 PowerPoint 的标题页、章节页、内容页和数据页布局;定义 Excel 的表头、数据行、边框、交替行和图表默认样式;定义 PDF 的页眉、页脚、页边距、行距和段落格式;规范专业、清晰、主动和积极的内容语气;根据标志、颜色、字体、拼写、数据准确性和专业度进行最终检查。文件中列出了 apply_brand.py 和 validate_brand.py,但未说明它们的具体调用方式。
- 企业团队制作对外 PowerPoint 汇报,需要统一标题页、章节页、图表和品牌色。
- 财务或运营人员创建 Excel 报表,需要规范表头、交替行、边框和图表颜色。
- 文档团队生成 PDF 通知或报告,需要统一页眉、页脚、标题层级和页面边距。
- 品牌或市场团队希望生成内容使用正式、清晰、主动且积极的表达方式。
- 需要将生成式文档按照既定企业品牌规范进行发布前检查的团队。
优缺点一览
- 覆盖 PowerPoint、Excel 和 PDF 三类常见文档。
- 提供明确的颜色、字体、尺寸、页边距和版式规范。
- 包含语气、标准短语、数字格式和表格对齐规则。
- 提供发布前的品牌合规检查清单。
- 品牌示例固定为 Acme Corporation,可能需要改写后才能用于其他企业。
- 要求使用公司标志,但源材料没有提供标志文件或插入方法。
- 没有说明 apply_brand.py 和 validate_brand.py 的使用方式或依赖。
- 源材料没有提供测试套件、支持平台清单或实际输出示例。
- 对内部文档、特殊项目例外和季度更新只给出原则性说明。
如何安装
该技能位于仓库的 skills/custom_skills/applying-brand-guidelines/SKILL.md。源材料只提供仓库路径,没有提供独立安装命令或安装流程;使用时需将该技能目录放入兼容 Agent Skills 的 skills 目录中。
如何使用
在已加载该技能的环境中,提出具体文档任务,例如:“创建一份符合 Acme Corporation 品牌规范的 PowerPoint 演示文稿,使用 Acme Blue 和 Segoe UI,并遵守标题页和图表规则。”源材料没有提供更具体的运行命令、参数或调用接口。