claude-howto 品牌语态 Skill 全解析让 Claude 输出始终一致的企业级文案风格【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto导读在 Claude Code 的 Agent Skills 体系中brand-voice是一类特殊的背景知识型Skill它不执行任何操作而是把品牌的声音、语调、措辞偏好注入到每一次对外沟通中确保营销文案、客户沟通和公开内容始终保持一致。本文以仓库中的 vi/03-skills/brand-voice/SKILL.md越南语版与英文原版为主体结合仓库内模板与 Skill 机制源码级文档完整讲解该 Skill 的定义、写作规范、术语表与配套模板并说明如何在 Claude Code 中安装与调用。读完本文你将能直接复制这套品牌语态体系到自己的项目并理解user-invocable: false、渐进式披露等 Skill 底层机制如何让品牌规范自动生效。一、Skill 概述与定位品牌语态为什么需要代码化brand-voice是 03-skills/brand-voice/ 目录下的一个 Agent Skill英文原版文件为 SKILL.md仓库同时提供了越南语翻译版 vi/03-skills/brand-voice/SKILL.md。其核心作用是保证所有对外传播内容marketing copy、客户沟通、公开内容维持统一的品牌语气、语调和信息传达方式。在多人协作、多模型、跨会话的场景下文案风格漂移style drift是真实痛点不同人写出的宣传语可能一个活泼、一个严肃术语用法也可能五花八门。把品牌规范固化成 Skill 后Claude 在撰写任何公开内容时会自动匹配并遵循这套规则无需每次在 Prompt 里重复交代。该 Skill 在 03-skills/README.md 中被归类为Example 4: Brand Voice SkillBackground Knowledge属于背景知识/参考内容类型而不是任务型Skill。它不产生独立动作而是为 Claude 的写作行为提供风格约束。二、Frontmatter 元数据详解一个不可由用户主动调用的 SkillSKILL.md 的文件头采用 YAML Frontmatter这是所有 Agent Skill 的标准入口Claude 在启动时就会加载它即 Level 1 元数据--- name: brand-voice description: Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when users mention brand voice, tone, or writing style. user-invocable: false ---三个字段逐一拆解字段值作用namebrand-voiceSkill 唯一标识只允许小写字母、数字、连字符最长 64 字符且不能包含 anthropic 或 claudedescription上述英文描述告诉 Claude这个 Skill 做什么以及何时使用它最长 1024 字符描述质量直接决定 Claude 能否在合适的场景自动触发user-invocablefalse将该 Skill 从/斜杠菜单中隐藏只有 Claude 能自动调用用户不能在菜单中主动选择这里user-invocable: false是关键设计决策。依据 03-skills/README.md 中的调用控制矩阵Frontmatter用户可调用Claude 可调用默认是是disable-model-invocation: true是否user-invocable: false否是品牌语态本质上是后台知识它不是一个可执行的动作命令而是一种潜移默化的写作约束。正如 README 中解释的——legacy-system-context 这类 Skill 解释旧系统如何工作对 Claude 有用但对用户来说不是有意义的动作。因此它适合user-invocable: false不需要出现在用户的斜杠命令菜单里只要用户提到品牌语气、语调、写作风格或正在创作营销文案、客户沟通、公开内容时Claude 便会自动加载。与之对比仓库中 03-skills/code-review-specialist/SKILL.md 这类任务型 Skill 不设置该字段用户可通过/code-review-specialist直接调用而 03-skills/claude-md/SKILL.md 则专注于生成 CLAUDE.md 的写作规范与品牌语态形成互补。三、品牌身份使命、价值观与语调四要素SKILL.md 用三个层级定义我们是谁这是所有写作规范的根基。3.1 使命MissionHelp teams automate their development workflows with AI帮助团队用 AI 自动化他们的开发工作流。使命陈述界定了品牌的业务边界与价值主张Claude 在创作内容时以此判断什么值得写、站在什么立场写。3.2 价值观Values价值观含义Simplicity简单Make complex things simple —— 把复杂的事情变简单Reliability可靠Rock-solid execution —— 稳固可靠的执行Empowerment赋能Enable human creativity —— 释放人的创造力价值观决定了文案的情绪基调与论证方向例如强调简单时文案应突出易用性与低门槛强调赋能时则应把用户放在主体位置凸显其自主性。3.3 语调四要素Tone of Voice语调是品牌语态最核心的可操作部分SKILL.md 明确定义了四个维度友好但专业Friendly but professional——平易近人但不过度随意。既要消除距离感也要保持可信度清晰简洁Clear and concise——避免术语用简单语言解释技术概念。技术产品最容易犯的错是默认读者懂行话自信Confident——我们清楚自己在做什么。自信不等于傲慢而是对自身能力的笃定表达共情Empathetic——理解用户的需求与痛点站在用户立场说话。这四个维度可以直接迁移到任何技术团队它们是如何说话的顶层规则下面所有的 Dos / Donts 和词汇表都是它们的落地细则。四、写作指南Dos 与 Donts 完整清单4.1 应该做Dos ✅SKILL.md 列出 7 条正向写作规则称呼读者用你Use you when addressing readers——直接对话拉近距离使用主动语态——Claude generates reportsClaude 生成报告而非 Reports are generated by Claude报告被 Claude 生成。主动语态更清晰、更有行动力以价值主张开头Start with value proposition——第一句话就要让读者知道这对我有什么用使用具体例子Use concrete examples——抽象表述无法建立信任具体场景才能句子控制在 20 词以内Keep sentences under 20 words——可读性的硬性指标防止长句堆砌用列表增强清晰度Use lists for clarity——复杂的并列信息用列表呈现包含行动号召Include calls-to-action——读者读完应该知道下一步做什么。4.2 不应该做Donts ❌对应的 6 条负面禁令不要使用公司行话Dont use corporate jargon——synergyalignment这类空话没有任何信息量不要居高临下或过度简化Dont patronize or oversimplify——尊重读者的智力不要用哄小孩的语气不要使用我们认为/我们觉得Dont use we believe or we think——这类措辞削弱确定性显得底气不足不要滥用全大写Dont use ALL CAPS except for emphasis——全大写在网络语境等于喊叫仅在强调时允许不要制造文字墙Dont create walls of text——长段落会吓跑读者应拆分为短段落与列表不要假设读者有技术背景Dont assume technical knowledge——默认读者是新手需要解释时就要解释。五、术语表Vocabulary词汇级的一致性管控品牌语态不止于语气还包括用词选择。SKILL.md 提供了两份对照清单这是整份文档中最容易被直接拿来复用的部分。5.1 优先术语✅ Preferred Terms使用不使用理由Claudethe Claude AI直接称呼产品名去掉冗余冠词Code generationauto-coding语义更准确的行业通用表达Agentbotbot 带有贬义与误导性Streamlinerevolutionize前者务实后者夸大Integratesynergize前者具体后者是典型空话5.2 应避免的术语❌ Avoid Terms术语问题Cutting-edge被过度使用overused已无新鲜感Game-changer含义模糊vague无法量化Leverage典型的公司行话corporate-speakUtilize直接用 use 更简单Paradigm shift语义不明unclear读者无法理解具体指什么这类禁用词清单对营销文案质量提升立竿见影。值得留意的是Leverage 这类词在英文技术圈已经被大量吐槽中文语境下对应的赋能抓手打通等词同样适用这条规则——用具体的动作动词替代空泛的抽象词。六、正反例对比好文案 vs 坏文案SKILL.md 给出了两组完整的对照示例这是理解品牌语态最直观的材料。6.1 好示例✅ Good ExampleClaude automates your code review process. Instead of manually checking each PR, Claude reviews security, performance, and quality—saving your team hours every week.它为什么有效Why it works价值清晰Clear value、利益具体specific benefits、行动导向action-oriented。逐条对照写作指南开头直接点明价值主张自动化的代码审查使用你称呼读者主动语态贯穿全文saving your team hours every week是可感知的具体收益没有一句超过 20 词结尾隐含着明确的行动方向。6.2 坏示例❌ Bad ExampleClaude leverages cutting-edge AI to provide comprehensive software development solutions.它为什么失败Why it doesnt work含义模糊Vague、公司行话corporate jargon、没有具体价值no specific value。leverages 是禁用词cutting-edge 是过度使用的词comprehensive solutions 说了等于没说——整句话没有告诉读者任何具体的好处无法打动任何人。这两段示例的存在非常有价值它们让 Claude 不仅能理解抽象规则还能通过正反面对比学会区分好文案与坏文案——这正是 03-skills/README.md 中用具体示例展示期望输出格式的最佳实践。七、配套资源语调示例与即用模板仓库为brand-voice提供了两类配套文件体现 Skill 的渐进式披露设计主文件只放规则细节与模板放 Level 3 资源按需加载。7.1 分场景语调示例tone-examples.mdtone-examples.md 给出了四种典型场景下的标准表述直接把抽象语调转成可复制的句式场景示例兴奋的产品发布Exciting AnnouncementSave 8 hours per week on code reviews. Claude reviews your PRs automatically. —— 用具体时间收益制造兴奋点共情式客户支持Empathetic SupportWe know deployments can be stressful. Claude handles testing so you dont have to worry. —— 先承认痛点再给出解决方案自信的产品特性介绍Confident Product FeatureClaude doesnt just suggest code. It understands your architecture and maintains consistency. —— 用对比句式突出差异化优势教育性博客文章Educational Blog PostLets explore how agents improve code review workflows. Heres what we learned... —— 用探索口吻引导读者这四种模板覆盖了 B2B 技术产品最常见的对外内容场景可以作为团队文案起步的骨架。7.2 邮件模板email-template.txttemplates/email-template.txt 提供了一封结构完整的对外邮件骨架Subject: [Clear, benefit-driven subject] Hi [Name], [Opening: Whats the value for them] [Body: How it works / What theyll get] [Specific example or benefit] [Call to action: Clear next step] Best regards, [Name]模板的每个区块都对应一条写作指南主题行强调清晰、利益驱动对应以价值主张开头Opening 直接说明对他们有什么价值正文说明如何运作/他们将获得什么紧接着是具体例子或收益对应使用具体例子最后是明确的行动号召。这是一份可以直接复制到邮件营销、销售跟进、客户通知等场景的通用结构。7.3 社媒发帖模板social-post-template.txttemplates/social-post-template.txt 面向社交媒体短文案[Hook: Grab attention in first line] [2-3 lines: Value or interesting fact] [Call to action: Link, question, or engagement] [Emoji: 1-2 max for visual interest]模板定义了四段结构第一行钩子抓注意力、2-3 行价值或有趣事实、行动号召链接、提问或互动引导、1-2 个 emoji增加视觉吸引力。注意最后一条的限定——1-2 max这与 Donts 中不要滥用的精神一脉相承即使是在轻松的社媒场景也强调克制。八、机制原理这个 Skill 在 Claude Code 中如何自动生效理解了内容再看它如何被加载。根据 03-skills/README.md 的渐进式披露Progressive Disclosure架构Skill 分三级加载级别何时加载Token 成本内容Level 1: 元数据始终启动时每个 Skill 约 100 tokensname与description即 FrontmatterLevel 2: 指令Skill 被触发时5k tokens 以内SKILL.md 正文Level 3: 资源需要时近乎无限打包的脚本、模板、文档brand-voice的完整加载链路是启动时Claude Code 只加载name: brand-voice与那段 descriptionLevel 1此时不占上下文当用户请求写一段产品介绍创作营销文案或明确提到 brand voice / tone / writing style 时Claude 将请求与 description 匹配触发 Skill读取 SKILL.md 正文Level 2当 Claude 需要具体句式或模板时按需读取 tone-examples.md 与 templates/ 下的文件Level 3。这意味着即便团队安装了十几个 Skill只要不触发就几乎没有上下文开销。而user-invocable: false保证了它不会出现在用户的斜杠菜单里只有 Claude 在合适的写作场景才会自动启用——规范在后台静默生效无需用户手动干预。九、安装与使用如何在你的项目里启用品牌语态9.1 安装位置Skill 支持多个安装层级brand-voice作为团队级标准应放在项目目录# 个人级仅自己可用 ~/.claude/skills/brand-voice/SKILL.md # 项目级随 git 共享给团队 .claude/skills/brand-voice/SKILL.md # 插件级随插件分发 plugin/skills/brand-voice/SKILL.md仓库中的 03-skills/ 目录结构即可视为一套现成的项目级 Skill 集合其中brand-voice/子目录布局为brand-voice/ ├── SKILL.md # 主规范必选 ├── tone-examples.md # 分场景语调示例 └── templates/ ├── email-template.txt # 邮件模板 └── social-post-template.txt # 社媒模板9.2 使用方式由于user-invocable: false用户不能从/菜单主动调用它但可以通过自然语言触发写一封给客户的欢迎邮件注意保持我们的品牌语气帮我把这段产品介绍改得更符合我们 brand voiceCreate marketing copy for our new feature, follow our brand voice and tone guidelinesClaude 会自动匹配 description 中的关键词marketing copy、customer communications、public-facing content、brand voice、tone、writing style并加载该 Skill。9.3 验证是否生效安装后可用 03-skills/README.md 中的两种方式验证直接询问 What Skills are available? 确认brand-voice已被识别或者发起一个匹配 description 的写作请求观察输出是否遵循了本文第四、五节的规则主动语态、无禁用词、句子 20 词、以价值主张开头等。9.4 适配你自己的品牌这套 Skill 的价值在于框架可复用、内容可替换。要把它变成自己团队的品牌语态只需修改三个部分Frontmatter description替换为你的品牌描述与触发关键词Brand Identity改写使命、价值观与语调四要素Vocabulary 与 Examples换成你的产品术语与正反例。保留user-invocable: false与三级文件结构即可获得一套与claude-howto仓库同样机制的品牌语态 Skill。十、与其他 Skill 的协同brand-voice不是孤立的。在 03-skills/ 集合中它可与多种 Skill 组合使用与 blog-draft/博客草稿配合保证博客文章从提纲到成稿都遵循品牌语调与 doc-generator/文档生成配合确保公开文档的语气一致与 code-review-specialist/ 协同让代码审查报告同样使用清晰简洁的表述。按 03-skills/README.md 的说明Skills 支持叠加调用与自动发现当工作目录存在嵌套的.claude/skills/时Claude Code 会自动发现子目录中的 Skill因此 monorepo 中不同子项目可以挂载各自微调过的品牌语态版本。结语brand-voice是把品牌文化工程化的一个小而完整的范本Frontmatter 控制触发机制Brand Identity 定义立场Dos / Donts 约束句法词汇表管控用词正反例与模板提供落地素材。这套从 vi/03-skills/brand-voice/SKILL.md 到 templates/ 的完整结构可以直接迁移到任何团队——让 AI 生成的内容从第一句话起就带着你想要的品牌声音。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考