🚀 快速安装

复制以下命令并运行,立即安装此 Skill:

npx skills add https://skills.sh/anthropics/knowledge-work-plugins/guideline-generation

💡 提示:需要 Node.js 和 NPM

指南生成

从任何来源组合——品牌文档、销售通话记录、发现报告或直接的用户输入——生成全面、可供大语言模型直接使用的品牌语气指南。将原始材料转化为结构化、可执行的指南,并附有置信度评分和待解决的问题。

输入来源

接受以下任何组合:

  • 发现报告 来自 discover-brand 技能(结构化的,已预分类)
  • 品牌文档 上传或来自已连接平台(PDF、PPTX、DOCX、MD、TXT)
  • 对话记录 来自 Gong、Granola、手动上传或 Notion 会议笔记
  • 用户直接输入 关于其品牌语气和价值观

当提供了发现报告时,将其作为主要输入——来源已经过分类和排序。必要时辅以额外的分析。

生成工作流程

1. 识别并分类来源

确定用户提供了什么。如果没有可用来源:

  • 检查之前运行的 /brand-voice:discover-brand 是否生成了发现报告
  • 检查 .claude/brand-voice.local.md 中已知的品牌资料位置
  • 建议先运行发现技能:/brand-voice:discover-brand

2. 处理来源

对于文档: 委托给文档分析智能体进行深度解析。提取语气属性、信息主题、术语、语气指导和示例。

对于对话记录: 委托给对话分析智能体进行模式识别。提取隐含的语气属性、成功的语言模式、按上下文区分的语态以及反模式。

对于发现报告: 提取预分类的来源、冲突点和差距。直接使用已排序的来源。

3. 综合成指南

将所有发现合并成一个统一的指南文档,遵循 references/guideline-template.md 中的模板。关键部分包括:

“我们是 / 我们不是” 表格 —— 核心品牌身份锚点:

我们是 我们不是
[属性 — 例如,“自信”] [反面 — 例如,“傲慢”]
[属性 — 例如,“平易近人”] [反面 — 例如,“随意或草率”]

从跨来源最一致的模式中推导出属性。每一行都应有支持的证据。

语气常数 vs. 语态变化 —— 阐明哪些是固定的,哪些是灵活调整的:

  • 语气 = 个性、价值观、“我们是 / 我们不是” —— 在所有内容中保持不变
  • 语态 = 正式程度、能量水平、技术深度 —— 根据上下文灵活变化

上下文语态矩阵:

上下文 正式程度 能量水平 技术深度 示例
冷启动外联 中等 “[示例短语]”
企业级方案 中等 “[示例短语]”
社交媒体 “[示例短语]”

4. 分配置信度评分

使用 references/confidence-scoring.md 中的方法对每个部分进行评分:

  • 高置信度:3 个或更多相互印证的来源,找到明确的指导
  • 中等置信度:1-2 个来源,或从模式中推断得出
  • 低置信度:单一来源,推断得出,或数据存在冲突

5. 提出待解决的问题

针对无法解决的任何歧义,生成待解决的问题:

## 需要团队讨论的待解决问题

### 高优先级(阻碍指南完成)
1. **[问题标题]**
   - 发现情况:[冲突或不完整的信息]
   - 智能体建议:[带有理由的建议解决方案]
   - 需要您: [需要做出的具体决定或确认]

每个待解决的问题必须包含智能体建议。将歧义转化为“确认或覆盖”的决策点——绝不能是死胡同。

6. 质量检查

在呈现之前,通过质量保证智能体(定义于 agents/quality-assurance.md)进行验证:

  • 所有主要部分都已填写(如果来源支持,包括品牌个性和内容示例)
  • 至少有 3 个有证据支持的品牌属性
  • “我们是 / 我们不是”表格至少有 4 行
  • 语态矩阵至少覆盖 3 种上下文
  • 每个部分都已分配置信度评分
  • 所有提取的元素都有来源归属
  • 未暴露任何个人身份信息
  • 待解决的问题包含建议

7. 呈现并提供后续步骤

总结关键发现:

  • 生成的总部分数,附置信度细分
  • 最强的品牌属性和最有效的信息
  • 待解决问题的数量(如有)

8. 保存以备未来会话

默认保存位置是用户工作文件夹内的 .claude/brand-voice-guidelines.md

重要提示: 智能体的工作目录可能不是用户的项目根目录(尤其是在 Cowork 中,插件从插件缓存目录运行)。务必解析相对于用户工作文件夹的路径,而非当前工作目录。如果未设置工作文件夹,则跳过文件保存,并告知用户指南仅在此次对话中可用。

  1. 解析保存路径。 文件必须保存到用户工作文件夹内的 .claude/brand-voice-guidelines.md。在写入前确认工作文件夹路径。
  2. 检查该路径下是否已存在指南
  3. 如果存在,存档之前的版本: 将现有文件重命名为同一目录下的 brand-voice-guidelines-YYYY-MM-DD.md(使用当前日期)
  4. 将新指南保存 到工作文件夹内的 .claude/brand-voice-guidelines.md
  5. 向用户确认,提供完整的绝对路径:“指南已保存到 <完整路径>。未来的会话中,/brand-voice:enforce-voice 将自动找到它们。”

指南也存在于本次对话中,因此 /brand-voice:enforce-voice 可以立即使用它们,无需从文件加载。

保存后,提供:

  1. 逐部分浏览指南
  2. 使用 /brand-voice:enforce-voice 开始创建内容
  3. 解决待解决的问题

隐私与安全

在整个生成工作流程中贯彻这些隐私约束,而不仅仅在输出时:

  • 从所有示例中修订客户姓名和联系信息
  • 如有要求,对记录摘录中的公司名称进行匿名化处理
  • 在处理过程中标记任何检测到的敏感信息

参考文件

  • references/guideline-template.md — 包含所有部分、字段定义和格式指导的完整输出模板
  • references/confidence-scoring.md — 置信度评分方法、阈值和示例

📄 原始文档

完整文档(英文):

https://skills.sh/anthropics/knowledge-work-plugins/guideline-generation

💡 提示:点击上方链接查看 skills.sh 原始英文文档,方便对照翻译。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。