import-guidelines

/digital-marketing-pro:import-guidelines

目的

将品牌指南导入并整理到持久化品牌知识层。把非结构化的指南文档、风格指南、限制清单和信息传达手册，转换为结构化、可执行的 Markdown 文件，并自动应用于所有模块和命令。

所需输入

用户提供以下一项或多项：

• 粘贴的指南内容：现有品牌指南、风格指南或限制清单中的文本
• 口头描述：口述或输入的规则（“我们从不使用感叹号”“始终以数据开篇”）
• 要更新的类别：要添加到哪个指南类别（voice-and-tone、messaging、restrictions、channel-styles、visual-identity 或 custom）
• 源文档参考：说明这些指南的来源

如果用户未指定类别，请分析内容并自动将其归入正确类别。

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）以及行业背景。同时检查是否已有指南：查看 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json；如果存在，则加载现有指南以便合并（而非覆盖）。如果没有品牌，则询问：“先设置一个品牌吗（/digital-marketing-pro:brand-setup）？”——也可以使用默认值继续。

2. 对内容分类 — 确定输入所属的指南类别（一类或多类）：

   • 语气规则、写作风格、语调 → voice-and-tone.md
   • 核心信息、标语、定位、价值主张 → messaging.md
   • 禁用词、受限声明、免责声明、禁止话题 → restrictions.md
   • 各渠道的格式／语气规则 → channel-styles.md
   • 颜色、字体、徽标规则、图像风格 → visual-identity.md
   • 其他内容 → custom/{descriptive-name}.md

3. 整理内容 — 将非结构化输入转换为有条理的 Markdown：

   • 将单条规则提取为项目符号
   • 按子主题分组，并添加清晰的标题
   • 如果输入中提供了示例，则添加前后对比示例
   • 保留用户原意——不要添加用户未指定的规则
   • 使用 skills/context-engine/guidelines-framework.md 中的框架结构

4. 检查冲突 — 将新指南与现有的品牌资料设置进行比较：

   • 如果指南要求“轻松随意的语气”，但品牌资料中的 formality=8，则标记冲突
   • 如果限制规则禁止了现有品牌信息中的词语，则标记冲突
   • 向用户说明冲突，并询问哪项优先
   • 注意：channel-styles 会有意覆盖特定渠道的基础语气，因此不构成冲突

5. 与现有指南合并 — 如果该类别已有内容：

   • 向用户展示已有内容
   • 询问如何处理：合并（将新规则添加到现有内容）、替换（覆盖）或取消
   • 合并时，去重规则并保持内容结构

6. 保存并确认 — 写入整理后的指南文件：

   • 使用 guidelines-manager.py --brand {slug} --action save --category {category} 保存
   • 或直接写入 ~/.claude-marketing/brands/{slug}/guidelines/{file}
   • 保存时会自动重建清单文件
   • 确认时，展示类别、规则数量以及已保存内容的预览

7. 询问是否添加其他类别 — 如果用户的输入可能涉及多个类别：

   • “我还注意到有信息传达方面的内容——要我也将其保存到 messaging.md 吗？”
   • “其中一些规则专用于特定渠道——要我也创建 channel-styles.md 吗？”

输出

• 确认已保存的内容及规则数量
• 结构化指南文件的预览
• 标记指南与现有品牌档案之间的任何冲突
• 如果检测到相关内容，建议导入其他类别
• 提醒：“创建内容时将自动应用这些指南。再次使用 /digital-marketing-pro:import-guidelines 添加更多内容。”

指南类别参考

类别	文件	内容
语气与风格	voice-and-tone.md	写作风格、语气规则、该做与不该做的事、可读性、人称偏好
信息传达	messaging.md	定位、价值主张、关键信息、标语、电梯演讲、佐证
限制	restrictions.md	禁用词、受限声明、强制免责声明、禁止话题
渠道风格	channel-styles.md	各渠道的语气、格式、话题标签／表情符号政策、内容类型
视觉识别	visual-identity.md	颜色、字体、徽标规则、摄影风格（文字描述）
自定义	custom/{name}.md	无障碍规则、法律审核触发条件、季节性规则、合作伙伴指南

示例

用户：“这是我们的品牌语气指南：我们友好但专业。绝不使用行话。始终用简单的方式解释技术概念。使用‘你’，而不是‘客户’。句子应少于 20 个词。”

结果：保存到 voice-and-tone.md：

# Brand Voice & Tone Guide

## Core Voice
- Friendly but professional
- Always explain technical concepts in plain language
- Use "you" and "your" — never "customers" or "users"

## Writing Style
- Sentences: maximum 20 words
- No jargon — if a simpler word exists, use it

## Dos and Don'ts
- DO: Use plain language and direct address
- DON'T: Use industry jargon or technical terminology without explanation

用户：“我们绝不能使用‘cheap’、‘guarantee’、‘best’ 或 ‘revolutionary’这些词。健康声明需要附带免责声明。”

结果：保存到 restrictions.md：

# Brand Restrictions & Guardrails

## Banned Words and Phrases
- "cheap" → use "affordable" or "cost-effective"
- "guarantee" → use "committed to" or "designed to"
- "best" → use specific proof points instead
- "revolutionary" → use "innovative" or describe the specific innovation

## Mandatory Disclaimers
- Health/wellness claims: Include "This is not medical advice. Consult your healthcare provider."

参考文件

• skills/context-engine/guidelines-framework.md — 用于构建和应用指南的完整框架
• scripts/guidelines-manager.py — 用于指南增删改查操作的 CLI