Communitygithub.com

品牌指南构建器

将现有品牌资产转化为可复用的规则,区分记录的事实与推断的选择,并对照品牌规范检查拟定的文档。

品牌指南构建器 是什么?

品牌指南构建器是一个 AI 代理技能,旨在将原始品牌资产文件夹转化为结构化的、可重用的品牌规则。它执行自动化审计,从样式表、主题文件和图像中提取颜色调色板、排版层次、徽标变体等,生成一个 `brand-spec.json` 文件,该文件清晰标记哪些值是从声明中读取的(`"source": "read"`),哪些是推断的(`"source": "inferred"`)。所有推断的值必须通过一套预设的所有者问题(`owner-questions.md`)进行人工确认,确保品牌规则建立在经过验证的事实而非假设之上。该技能最终生成可直接粘贴到品牌构建技能中的规则块(`skill-rules.md`),并使用 `brand_check.py` 工具验证任何输出文档与规范的一致性。它与 Claude Code、Cursor 和 Codex 等基于终端的代理兼容,优先在代理工作区外操作品牌文件,强调审计先于技能编写,且检查器在交付前必须运行。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byoverseas/knacco-free-skills/tree/HEAD/skills/kit-brand-guide-builder

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Brand Guide Builder

一个装着品牌资产的文件夹并不是一个品牌技能。品牌技能是一套书面的规则,代理无需被询问即可自动应用,并且它只能通过对品牌实际行为的审计来构建。

状态:v1.0 | 分类:技能 | 价格:免费

在运行审计之前,请阅读产品指南。从此产品文件夹中运行附带的工具。将您的品牌文件保留在您自己的工作区中。

此技能的作用

  1. 接收一个包含品牌资产的文件夹:样式表、主题文件、徽标文件、图像、笔记。
  2. 在该文件夹上运行 tools/brand_audit.py,并写出 brand-spec.json,其中包含排序后的调色板、命名的颜色角色、排版层次、徽标变体和留白区域、图像规则、安全的对比配对以及反模式。
  3. 将无法从声明中读取的每个值标记为 "source": "inferred",并在 unconfirmed 中列出其路径。
  4. 向品牌所有者提出十二个所有者问题,并针对这些路径记录答案。
  5. 将 references/skill-rules.md 中的规则块提供给您,供您粘贴到您构建的技能中,并在交付前使用 tools/brand_check.py 检查每个输出。

路线

  • 审计一个文件夹 → python3 tools/brand_audit.py <folder> --out brand-spec.json --json,然后在信任任何一个值之前阅读 GUIDE.md 的第 4 节。
  • 询问所有者 → references/owner-questions.md。全部十二个问题,即使审计只引发了一个问题。
  • 构建技能 → references/skill-rules.md。将规则块粘贴到技能中,填入已确认的值,保留拒绝规则。
  • 检查一个输出 → python3 tools/brand_check.py brand-spec.json output-description.json。十二条规则,一个分数,失败时退出码为 2。
  • 检查散文 → 将检查器指向一个文本文件。它会检查调色板、字体大小和品牌名称,并跳过散文无法承载的规则。

不可协商的规则

  • 审计先于技能。 不经过审计就从文件夹编写的技能不过是一套带有品牌词汇的猜测。
  • 每个推断的值都由所有者确认。 基于未确认推断的规则比没有规则更糟糕。
  • 规范是颜色、字体和徽标的唯一来源。 构建的技能不携带其自身的调色板副本。
  • 技能应用品牌。 它不会重新设计、改进或现代化品牌。
  • 任何徽标都不得重新绘制、重新拉伸或根据描述重建。 按原样使用文件,否则输出就不带徽标。
  • 检查器在交付前运行。 所有者发现的品牌违规与检查器发现的品牌违规是不同的问题。

文件

文件用途
GUIDE.md完整的方法:收集、审计、构建,以及顺序不可逆转的原因
references/audit-fields.md品牌规范中的每个字段:类型、如何推导、读取或推断
references/skill-rules.md可用于粘贴的规则块,用于您构建的技能
references/owner-questions.md十二个问题,以及跳过其中一个会出什么问题
tools/brand_audit.py遍历一个文件夹并写出 brand-spec.json
tools/brand_check.py对照一个拟议输出执行十二条规则,满分为 100

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能