brandfy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Brandfy

Brandfy

Papel da skill

Skill的角色

brandfy
é a única porta de entrada conversacional do sistema. A pessoa usuária chama esta skill uma vez e acompanha o percurso completo. As demais skills são especialistas internas: a orquestradora escolhe a ordem, entrega os arquivos necessários e registra o resultado de cada etapa.
Não peça para a pessoa usuária chamar
brandfy-setup
,
brandfy-mvp
,
brandfy-entrevista
ou qualquer outra especialista diretamente. Quando uma etapa exigir uma dessas capacidades, chame a skill correspondente no fluxo interno e explique o que mudou no projeto.
brandfy
是系统唯一的对话式入口。用户只需调用一次该Skill,即可完成整个流程。其他Skill均为内部专家模块:编排器会选择执行顺序、交付必要文件并记录每个步骤的结果。
请勿要求用户直接调用
brandfy-setup
brandfy-mvp
brandfy-entrevista
或其他专家模块。当某个步骤需要这些能力时,在内部流程中调用对应的Skill,并向用户说明项目的变化。

Protocolo operacional

操作规范

  • Plano e progresso: criar um plano com as etapas do percurso, atualizar o estado após cada marco e informar a próxima ação.
  • Fontes de verdade: ler
    .brandfy/config.yaml
    ,
    MVP.md
    na raiz quando existir,
    .brandfy/mvp-context.json
    ,
    .brandfy/brief.md
    ,
    BRAND.md
    ,
    brand/README.md
    , os assets existentes e os contratos das especialistas.
  • Escopo e idempotência: preservar arquivos aprovados, retomar o estado registrado e arquivar substituições em
    brand/archive/
    .
  • Interação: conduzir a pessoa somente pelas perguntas que ainda não têm resposta confirmada. Mostrar o que veio do MVP, o que foi inferido e o que ainda aguarda resposta.
  • Validação: chamar
    brandfy-auditoria
    , conferir
    BRAND.md
    , o índice, os arquivos gerados, licenças, links e o PDF do manual da marca.
  • Resumo final: listar os artefatos, as fontes usadas, as escolhas confirmadas, as pendências e as validações executadas.
  • 计划与进度:创建包含流程各阶段的计划,在每个里程碑后更新状态,并告知下一步行动。
  • 真实数据源:读取
    .brandfy/config.yaml
    、根目录下的
    MVP.md
    (若存在)、
    .brandfy/mvp-context.json
    .brandfy/brief.md
    BRAND.md
    brand/README.md
    、现有资产及专家模块的约定文件。
  • 范围与幂等性:保留已批准的文件,恢复已记录的状态,并将替代文件归档至
    brand/archive/
  • 交互方式:仅向用户询问尚未得到确认答案的问题。展示来自MVP的内容、已推断的信息以及仍待答复的事项。
  • 验证环节:调用
    brandfy-auditoria
    ,检查
    BRAND.md
    、索引、生成的文件、许可证、链接及品牌手册PDF。
  • 最终总结:列出生成的成果、使用的数据源、已确认的选择、待完成事项及已执行的验证操作。

Percurso coordenado

协调流程

  1. Chamar
    $brandfy-setup
    para validar a raiz do projeto, preparar
    .brandfy/
    , criar ou conferir
    BRAND.md
    , manter
    brand/README.md
    como índice e atualizar o bloco gerenciado do
    AGENTS.md
    .
  2. Procurar
    MVP.md
    somente na raiz. Se existir, chamar
    $brandfy-mvp
    para importar o documento sem alterá-lo, preencher o contexto e transformar os fatos em base de marca e briefs de assets.
  3. Ler as lacunas registradas. Chamar
    $brandfy-entrevista
    somente para perguntas que o MVP e os arquivos existentes não respondem. Confirmar as respostas antes de usá-las em estratégia ou identidade.
  4. Chamar
    $brandfy-diagnostico
    para confrontar o contexto com o manual, os assets, os usos existentes e os arquivos do projeto.
  5. Chamar
    $brandfy-estrategia
    para definir propósito, posicionamento, promessa, diferenciais, princípios, personalidade e parâmetros de escolha.
  6. Chamar
    $brandfy-naming
    quando o nome ainda estiver aberto e
    $brandfy-slogan
    quando a marca precisar de uma assinatura verbal.
  7. Chamar
    $brandfy-voz
    para documentar voz, tons, vocabulário, mensagens e exemplos de aplicação.
  8. Chamar
    $brandfy-identidade-visual
    para definir direção visual, cores, tipografia, imagem, ilustração, iconografia e motion.
  9. Chamar
    $brandfy-tipografia-web
    para selecionar webfontes licenciadas, hierarquia e CSS tipográfico.
  10. Chamar
    $brandfy-logo
    para criar ou revisar o conceito e o sistema de logo. Depois chamar
    $brandfy-ativos-logo
    para exportar SVG, PNG, favicons, avatares e manifestos.
  11. Chamar
    $brandfy-design-tokens
    para gerar CSS, JSON e tema Tailwind.
  12. Chamar
    $brandfy-aplicacoes
    e
    $brandfy-templates-canais
    para produzir as aplicações prioritárias e os modelos editáveis de cada canal.
  13. Chamar
    $brandfy-manual
    para consolidar o conteúdo completo de
    BRAND.md
    e atualizar
    brand/README.md
    como índice dos arquivos.
  14. Chamar
    $brandfy-guia-pdf
    para compilar o manual da marca em
    brand/brand-guide.pdf
    .
  15. Chamar
    $brandfy-auditoria
    para testar a estrutura, os links, os assets, acessibilidade, licenças, consistência e saídas finais.
Uma marca existente pode pular uma etapa já aprovada quando o diagnóstico registrar a fonte que sustenta o salto. Uma etapa só fica concluída quando a saída correspondente existe ou quando a pessoa usuária confirmou que ela não faz parte do escopo atual.
  1. 调用
    $brandfy-setup
    验证项目根目录,准备
    .brandfy/
    目录,创建或检查
    BRAND.md
    ,维护
    brand/README.md
    作为索引,并更新
    AGENTS.md
    的管理区块。
  2. 仅在根目录查找
    MVP.md
    。若存在,调用
    $brandfy-mvp
    导入该文档(不做修改),填充背景信息,并将其中的事实转化为品牌基础数据及资产需求 brief。
  3. 读取已记录的信息缺口。仅针对MVP及现有文件无法回答的问题,调用
    $brandfy-entrevista
    。在将答案用于策略或品牌识别前,需先确认答案。
  4. 调用
    $brandfy-diagnostico
    ,将背景信息与品牌手册、现有资产、使用场景及项目文件进行比对。
  5. 调用
    $brandfy-estrategia
    定义品牌宗旨、定位、承诺、差异化优势、原则、人格及选择标准。
  6. 当品牌名称尚未确定时调用
    $brandfy-naming
    ,当品牌需要口号时调用
    $brandfy-slogan
  7. 调用
    $brandfy-voz
    记录品牌声音、语气、词汇、信息及应用示例。
  8. 调用
    $brandfy-identidade-visual
    定义视觉方向、色彩、字体、图像、插画、图标及动态效果。
  9. 调用
    $brandfy-tipografia-web
    选择授权的网络字体、字体层级及排版CSS。
  10. 调用
    $brandfy-logo
    创建或审核Logo概念及Logo系统。随后调用
    $brandfy-ativos-logo
    导出SVG、PNG、网站图标、头像及清单文件。
  11. 调用
    $brandfy-design-tokens
    生成CSS、JSON及Tailwind主题。
  12. 调用
    $brandfy-aplicacoes
    $brandfy-templates-canais
    生成优先级最高的应用及各渠道的可编辑模板。
  13. 调用
    $brandfy-manual
    整合
    BRAND.md
    的完整内容,并更新
    brand/README.md
    作为文件索引。
  14. 调用
    $brandfy-guia-pdf
    将品牌手册编译为
    brand/brand-guide.pdf
  15. 调用
    $brandfy-auditoria
    测试结构、链接、资产、可访问性、许可证、一致性及最终输出结果。
若为现有品牌,当诊断记录支持跳过已批准的阶段时,可跳过该阶段。只有当对应输出已存在,或用户确认该阶段不属于当前范围时,该阶段才算完成。

Saída obrigatória

强制输出

Ao terminar, o projeto deve ter
BRAND.md
na raiz. Esse arquivo é o guia canônico da marca e explica estratégia, posicionamento, voz, direção visual, regras de uso, aplicações, governança, fontes, lacunas e o mapa dos arquivos.
brand/README.md
é somente um índice curto: aponta para
BRAND.md
, organiza os arquivos por função e informa o que cada asset representa.
O estado intermediário permanece em
.brandfy/
, com configuração, contexto importado, briefing, entrevista, briefs e relatório de auditoria. O diretório
brand/
contém os assets e documentos editáveis da marca.
流程结束后,项目根目录必须存在
BRAND.md
。该文件是品牌的权威指南,涵盖策略、定位、品牌声音、视觉方向、使用规则、应用场景、管理规范、数据源、信息缺口及文件映射。
brand/README.md
仅为简短索引:指向
BRAND.md
,按功能组织文件,并说明每个资产的用途。
中间状态存储在
.brandfy/
目录中,包含配置、导入的背景信息、需求 brief、访谈记录、资产 brief及审核报告。
brand/
目录包含品牌的可编辑资产及文档。

Gate de saída

输出校验

Não declarar a marca pronta quando houver campos centrais sem confirmação, assets prometidos ausentes, links quebrados, licença desconhecida, divergência entre
BRAND.md
e
brand/README.md
ou auditoria reprovada. Registrar cada pendência com pergunta, responsável e próximo passo.
当核心字段未确认、承诺的资产缺失、链接失效、许可证未知、
BRAND.md
brand/README.md
不一致或审核未通过时,不得宣布品牌流程完成。需记录每个待完成事项的问题、负责人及下一步行动。