用途:为仓库和包工具集定义、实现并治理一套克制、高工艺感的视觉与文字品牌识别系统,避免企业式浮夸和通用视觉堆砌。
主要能力:按 ADR 0012 的流程推进品牌建设,依次为品牌内核与理由、配色、矢量标志、徽章、封面位图、治理。配色需为明暗两种模式定义十六进制色值,文本与背景对比度须通过 WCAG AA(文档目标 AAA),每个界面最多三种颜色。矢量标志放在 docs/brand/assets/svg/,使用 currentColor 继承渲染上下文颜色,采用稳定 viewBox(如 200 200),不加阴影、渐变或写实细节。徽章有两种做法:自建品牌化 SVG 胶囊徽章(推荐),或使用 Shields.io 并嵌入自定义 base64 标志。封面图偏好隐喻性、艺术化位图,生成提示词记录在 docs/brand.mdx,宽封面目标小于 150 KiB,小方图小于 80 KiB。语气上避免营销术语,偏好克制、精确、仪式化的描述。
使用方式:终端用户可通过 npx skills add arenukvern/skill_steward --skill repo-brand-identity 安装。自建徽章托管在 GitHub 仓库中,README 通过 raw.githubusercontent.com 链接引用。Shields.io 徽章需将清理后的 SVG 转为 base64 传入 logo 参数,可用 Node.js 单行命令去除注释、标题、描述与换行后输出 base64。
适用场景:设计仓库视觉资产、配色或标志;创建并托管品牌化 SVG 徽章;格式化带 base64 SVG 标志的 Shields.io 状态徽章;记录封面图提示词来源;在各界面执行语气与视觉资产治理。
限制:所有品牌资产须放在 docs/brand/ 下;不编写自动校验器或扩展 CLI 工具检查品牌资产,依靠人工代码审查与文档清单维护;品牌相关更新记录在 docs/brand.mdx,面向公众的变更用 changesets(pnpm changeset)记录。具体价格、平台支持范围等资料暂未提供。