关于 brandfy
brandfy 是用于构建和维护项目品牌指南及资产的对话式编排 Skill。它协调各项专业 Skill,跟踪已确认的决策与待补信息,并验证最终材料。
主要功能
- 01协调品牌专业 Skill
- 02跟踪项目计划与进度
- 03保留已批准文件并归档替换内容
- 04验证资产、链接、许可与一致性
- 05生成品牌指南和 PDF
适用场景
- 01根据 MVP 文档制定品牌
- 02保留已批准内容并更新现有品牌
- 03检查品牌资产和项目文档
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ promovaweb/ brandfy --skill brandfy安装后在 Claude Code 中输入/brandfy确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/artifact-contract.mdbrand-methodology.mdsources.md详细介绍
Brandfy
技能职责
brandfy 是系统唯一的对话入口。用户只需调用此技能一次,即可跟进完整流程。其他技能都是内部专家:编排器负责选择顺序、提供所需文件,并记录每个阶段的结果。
请勿让用户直接调用 brandfy-setup、brandfy-mvp、brandfy-entrevista 或任何其他专家技能。当某个阶段需要这些能力时,请在内部流程中调用相应技能,并说明项目有哪些变化。
操作协议
- 计划与进度: 制定包含流程各阶段的计划,在每个里程碑后更新状态,并告知下一步行动。
- 权威来源: 阅读
.brandfy/config.yaml、根目录中的MVP.md(如存在)、.brandfy/mvp-context.json、.brandfy/brief.md、BRAND.md、CHROMATIC.md、brand/README.md、现有素材以及专家技能的约定。 - 范围与幂等性: 保留已批准的文件,恢复已记录的状态,并将替换文件归档到
brand/archive/。 - 交互: 只询问用户尚未确认的问题。说明哪些信息来自 MVP、哪些是推断得出的,以及哪些仍待答复。
- 验证: 调用
brandfy-auditoria,检查BRAND.md、索引、生成的文件、许可证、链接以及品牌手册 PDF。 - 最终摘要: 列出产物、使用的来源、已确认的选择、待办事项和已执行的验证。
协同流程
- 调用
$brandfy-setup验证项目根目录,准备.brandfy/, 创建或检查BRAND.md,将brand/README.md作为索引保留,并 更新AGENTS.md中由工具管理的区块。 - 仅在根目录查找
MVP.md。如果存在,调用$brandfy-mvp导入文档且 不做修改,补充上下文,并将事实转化为品牌基础和资产简报。 - 阅读记录的缺漏。仅针对 MVP 和现有文件无法回答的问题调用
$brandfy-entrevista。在将回答用于策略或身份设计前,先确认回答。 - 调用
$brandfy-diagnostico,将上下文与手册、资产、现有用法和 项目文件进行对照。 - 调用
$brandfy-estrategia,确定宗旨、定位、承诺、差异化优势、 原则、个性和选择标准。 - 如果名称尚未确定,调用
$brandfy-naming;如果品牌需要口号, 则调用$brandfy-slogan。 - 调用
$brandfy-voz,记录品牌声音、语气、词汇、信息和应用示例。 - 调用
$brandfy-identidade-visual,确定视觉方向、色彩、字体、 图像、插画、图标和动效。基础色须来自调研或访谈中明确表达的偏好, 不能由 Agent 自行选择,并应通过色轮进行调整。在CHROMATIC.md中记录来源、配色方案和最终选择。 - 调用
$brandfy-tipografia-web,选择获得许可的网络字体、层级和 CSS 字体样式。 - 调用
$brandfy-logo,创建或修订 Logo 概念和系统。然后调用$brandfy-ativos-logo,导出 SVG、PNG、favicon、头像和清单文件。 - 调用
$brandfy-design-tokens,生成 CSS、JSON 和 Tailwind 主题。 - 调用
$brandfy-aplicacoes和$brandfy-templates-canais,制作 优先级最高的应用,以及各渠道的可编辑模板。 - 调用
$brandfy-manual,整合BRAND.md的完整内容,并将brand/README.md更新为文件索引。 - 调用
$brandfy-guia-pdf,将品牌手册编译为brand/brand-guide.pdf。 - 调用
$brandfy-auditoria,测试目录结构、链接、资产、无障碍性、 许可、内容一致性和最终产出。
对于现有品牌,如果诊断记录了支持跳过步骤的来源,则可以跳过已获批准的 步骤。只有在相应产出已存在,或用户确认该步骤不属于当前范围时,该步骤 才算完成。
必需产出
完成后,项目根目录中必须有 BRAND.md。该文件是品牌的规范指南,说明
策略、定位、品牌声音、视觉方向、使用规则、应用、治理、来源、缺漏和
文件地图。brand/README.md 仅作为简短索引:指向 BRAND.md,按用途
整理文件,并说明各项资产的含义。根目录中的 CHROMATIC.md 是色彩指南:
记录基础色来源、色轮配色方案和最终选择,不重复记录 brandfy-design-tokens
技能中已说明的技术方法。
中间状态保留在 .brandfy/ 中,其中包含配置、导入的上下文、简报、
访谈、资产简报和审计报告。brand/ 目录包含品牌资产和可编辑文档。
交付门槛
如果核心字段尚未确认、承诺的资产缺失、链接失效、许可未知、
BRAND.md 与 brand/README.md 内容不一致、CHROMATIC.md 中仍有标为
“待定”的字段,或审计未通过,则不得宣布品牌已准备就绪。每项待办都要记录
问题、负责人和下一步。