brand knowledge base

Build a reusable brand knowledge package from uploaded brand documents and/or a filled intake form. Use when the user wants a standardized brand SSOT containing company intro, products/services, target users, selling points, cases, FAQ, contact info, website links, competitors, banned words, and brand tone.

Brand Knowledge Base Builder

Purpose

Use this skill to turn scattered brand materials into a standardized, reusable brand package that can feed downstream content, sales, support, FAQ, RAG, or Agent workflows.

This skill is for building a Single Source of Truth, not for writing one-off marketing copy.

What It Accepts

Use one or both of these input modes:

1. Upload raw materials

   • 官网文案
   • 公司介绍
   • 产品资料
   • 销售话术
   • FAQ 草稿
   • 客户案例
   • 访谈或语音转文字

2. Fill an intake form

   • Run the skill in template mode to generate intake_form.md, intake_form.yaml, or intake_form.json
   • Let the user fill key fields first, then append raw materials if needed

First-Use Requirement

On the first turn this skill is used, do not jump straight into extraction.

You must first clearly tell the user:

1. This skill builds a reusable brand SSOT, so the company needs to provide source materials first.
2. The company can provide materials in either of these ways:
   • Upload raw materials directly
   • Fill the intake form first, then optionally append raw materials
3. If the company does not provide enough information, the skill may still generate a draft, but missing fields must be marked as 待确认, and the analysis report must list follow-up questions.

You must explicitly ask the user to provide the following minimum required materials:

• 公司基础信息：品牌名称、公司名称、所属行业、产品类别、一句话定义、100 到 300 字公司简介
• 官网与公开链接：官网首页、产品页、案例页、FAQ 页；如果没有完整官网，至少提供对外介绍页或文档
• 产品与服务说明：卖什么、解决什么问题、怎么交付、如何收费
• 目标客户信息：核心客户、次级客户、决策人、使用者、不适合客户
• 核心卖点：至少 3 条卖点，并尽量附证据、数据、客户反馈或资质依据
• 联系方式：销售邮箱、支持邮箱、电话、微信/社媒、地址、工作时间、预约方式
• 品牌语气与表达规范：语气关键词、必须出现的说法、禁用词、禁用承诺、安全替代表达
• 合规边界：哪些能说、哪些不能说、哪些效果不能承诺、哪些内容必须人工审核

You should then strongly recommend these additional materials:

• 客户案例 2 到 5 条：客户类型、原问题、解决方案、结果、证据
• FAQ 种子问题 10 到 20 条：价格、效果、安全、交付周期、合作方式
• 竞品与替代方案：直接竞品、间接竞品、传统做法、外包方案、行业 SaaS
• 销售或客服话术：开场白、异议处理、报价说明、边界说明
• 原始素材：官网文案、宣传册、访谈纪要、录音转文字、产品说明、案例文档

Required Coverage

The final package should cover:

• 公司简介
• 产品与服务
• 目标客户
• 核心卖点
• 使用场景与客户案例
• FAQ
• 联系方式
• 官网链接
• 竞品与替代方案
• 品牌语气
• 禁用词与禁用承诺
• 合规边界

Workflow

1. Intake

   • On first use, explicitly tell the user what the company must provide
   • Collect files and/or a filled intake template
   • Prefer mixed mode when the user has partial structure plus raw docs
   • If the user has not prepared enough material, direct them to the intake template instead of proceeding silently

2. Core extraction

   • Produce a canonical JSON package
   • Prioritize factual sections over derivative writing assets

3. Analysis

   • Score completeness
   • Identify missing fields, conflicts, assumptions, and follow-up questions

4. Asset generation

   • Generate FAQ, glossary, standard messaging, and llms.txt inputs

5. Export

   • Render the full package into:
     • brand_knowledge_base.json
     • brand_knowledge_base.yaml
     • brand_knowledge_base.md
     • faq.md
     • glossary.md
     • standard_messaging.md
     • llms.txt
     • analysis_report.md

Safety Rules

• Do not invent missing facts.
• Use conservative wording.
• Strip or rewrite unverified absolute claims.
• For regulated industries, keep or add strong disclaimers in compliance_boundary.
• Human review is still required before publishing or loading into production systems.
• If the user has not yet provided the minimum required materials, be explicit about what is missing before building the package.

Files To Read

• For intake guidance: prompts/intake.md
• For extraction rules: prompts/extraction.md
• For analysis rules: prompts/normalization.md
• For derivative assets: prompts/asset_generation.md
• For schema shape: templates/brand_knowledge_base.json

Runtime Notes

• main.py is the executable entrypoint.
• --generate_intake_template creates fillable intake files.
• --input and --inputs accept raw material files.
• --intake_file accepts a structured intake form.
• --render_from_json re-renders the full artifact set from an existing package JSON.

First Reply Pattern

When the skill is first invoked, the assistant should lead with a message equivalent to:

使用本 Skill 前，请先按要求提供品牌资料。至少需要：公司简介、官网链接、产品服务、目标客户、核心卖点、联系方式、品牌语气与禁用词、合规边界。强烈建议同时提供客户案例、FAQ、竞品信息、销售话术和其他原始素材。你可以直接上传资料，或者先填写 intake 表单。若资料不完整，系统会生成初稿，并把缺失项标记为“待确认”。