guideline-generation

指南生成

基于任意组合的来源生成全面、可供大模型直接使用的品牌语调指南。来源可以是品牌文档、销售通话转录、探索报告或用户的直接输入。将原始材料转化为结构化、可执行的指南，并附带置信度评分和待定问题。

输入

可接受以下任意组合：

• 来自 discover-brand Skill 的探索报告（结构化，已预先筛选）
• 上传的或来自已连接平台的品牌文档（PDF、PPTX、DOCX、MD、TXT）
• 来自 Gong、Granola、手动上传或 Notion 会议笔记的对话转录
• 用户关于其品牌语调和价值观的直接输入

提供了探索报告时，将其作为主要输入，因为来源已经过筛选和排序。必要时补充额外分析。

生成流程

1. 识别与分类来源

确定用户提供了哪些材料。如果没有可用来源：

• 检查是否存在之前运行 /brand-voice:discover-brand 生成的探索报告
• 检查 .claude/brand-voice.local.md 中记录的已知品牌材料位置
• 建议先运行探索：/brand-voice:discover-brand

2. 处理来源

对于文档： 委托 document-analysis Agent 进行深度解析。提取语调属性、信息主题、术语、语气指导和示例。

对于转录： 委托 conversation-analysis Agent 进行模式识别。提取隐含的语调属性、有效的语言模式、不同语境下的语气以及反模式。

对于探索报告： 提取已预先筛选的来源、冲突和空白。直接使用已排序的来源。

3. 综合为指南

将所有发现合并为统一的指南文档，遵循 references/guideline-template.md 中的模板。关键章节如下：

"我们是 / 我们不是"表格，即品牌身份的核心锚点：

我们是	我们不是
[属性，例如"自信"]	[对立面，例如"傲慢"]
[属性，例如"平易近人"]	[对立面，例如"随意或敷衍"]

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

语调恒定与语气变化，明确哪些保持不变、哪些随语境调整：

• 语调（Voice） = 个性、价值观、"我们是 / 我们不是"，在所有内容中保持恒定
• 语气（Tone） = 正式程度、能量感、技术深度，随语境变化

语境语气矩阵：

语境	正式程度	能量感	技术深度	示例
冷启动外联	中	高	低	"[示例短语]"
企业方案	高	中	高	"[示例短语]"
社交媒体	低	高	低	"[示例短语]"

4. 分配置信度评分

依据 references/confidence-scoring.md 中的方法为每个章节评分：

• 高置信度：3 个及以上相互印证的来源，且找到明确指导
• 中置信度：1 至 2 个来源，或从模式中推断
• 低置信度：单一来源、推断得出，或数据相互冲突

5. 提出待定问题

对于无法解决的任何歧义，生成待定问题：

## Open Questions for Team Discussion

### High Priority (blocks guideline completion)
1. **[Question Title]**
   - What was found: [conflicting or incomplete info]
   - Agent recommendation: [suggested resolution with reasoning]
   - Need from you: [specific decision or confirmation needed]

每个待定问题都必须包含 Agent 建议。将歧义转化为"确认或覆盖"，绝不能形成死胡同。

6. 质量检查

在呈现之前，通过 quality-assurance Agent（定义于 agents/quality-assurance.md）进行验证：

• 所有主要章节均已填充（若来源支持，包括品牌个性和内容示例）
• 至少 3 个带有证据的语调属性
• "我们是 / 我们不是"表格至少有 4 行
• 语气矩阵至少覆盖 3 种语境
• 每个章节均已分配置信度评分
• 所有提取的元素均有来源标注
• 没有暴露任何个人身份信息（PII）
• 待定问题包含建议

7. 呈现结果并提供后续步骤

总结关键发现：

• 已生成的章节总数及置信度分布
• 最突出的语气特征与最有效的信息
• 未解决问题的数量（如有）

8. 保存以供后续会话使用

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

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

1. 解析保存路径。 文件必须保存到用户工作文件夹中的 .claude/brand-voice-guidelines.md。写入前请确认工作文件夹路径。
2. 检查该路径下是否已存在指南
3. 如果已存在，则归档旧版本： 将现有文件重命名为同一目录下的 brand-voice-guidelines-YYYY-MM-DD.md（使用当天日期）
4. 将新指南保存到工作文件夹中的 .claude/brand-voice-guidelines.md
5. 向用户确认并给出完整绝对路径："指南已保存至 <full-path>。/brand-voice:enforce-voice 将在未来会话中自动找到它们。"

指南内容也保留在本次对话中，因此 /brand-voice:enforce-voice 可以直接使用，无需从文件加载。

保存后，可提供以下选项：

1. 逐节讲解指南
2. 使用 /brand-voice:enforce-voice 开始创作内容
3. 解决未决问题

隐私与安全

在整个生成工作流中始终执行以下隐私约束，而不仅限于输出阶段：

• 从所有示例中删除客户姓名和联系方式
• 如有要求，对访谈记录摘录中的公司名称进行匿名化处理
• 标记处理过程中检测到的任何敏感信息

参考文件

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