--- slug: "whatsapp-style-guide" name: "whatsapp-style-guide" version: 1.0.1 displayName: "WhatsApp样式指南-专业版" summary: "企业级WhatsApp格式完整规范,含边界场景/高级模式/多语言指南/交互式测试。WhatsApp样式指南专业版,提供完整的WhatsApp消息格式规范体系,面向企业和专业内容团队。核心能力" summary_zh: "企业级WhatsApp格式完整规范,含边界场景/高级模式/多语言指南/交互式测试。WhatsApp样式指南专业版,提供完整的WhatsApp消息格式规范体系,面向企业和专业内容团队。核心能力" license: "MIT" edition: "pro" description: |- WhatsApp样式指南专业版,提供完整的WhatsApp消息格式规范体系,面向企业和专业内容团队。核心能力: - 完整WhatsApp格式语法规范(含边界场景与特殊字符处理) - 高级排版模式库(商务/营销/客服/技术场景) - 多语言格式指南(中文/英文/日文) - 交互式格式测试与实时预览 - 团队样式规范定制与执行 - 格式合规审计与报告生成 - 版本化规范管理与变更追踪 适用场景: - 企业内容团队的WhatsApp消息规范制定 - 多语言客服团队的格式培训 - 消息格式合规审计与质量管控 tags: - 沟通协作 - 样式指南 - WhatsApp - 企业级 - 格式规范 - 合规审计 - UI设计 - 前端 - 设计 - emoji - 模式 - print - text tools: - read - exec - write homepage: "" category: "Creative" --- # WhatsApp样式指南-专业版 ## 付费版专享能力 | 能力 | 免费版 | 付费版 | |---|---|---| | 基础功能 | 支持 | 支持 | | 多渠道消息批量发送 | 不支持 | 支持 | | 消息模板与变量注入 | 不支持 | 支持 | | 送达状态实时回调 | 不支持 | 支持 | | 通信记录归档与检索 | 不支持 | 支持 | | 消息频控与智能排队 | 不支持 | 支持 | ## 核心能力 ### 1. 边界场景处理规范 #### 特殊字符转义 当文本内容本身包含格式符号时,需要特殊处理以避免误触发格式. > 详细代码示例已移至 `references/detail.md` #### Emoji与格式混用 ```python class EmojiFormatGuide: """Emoji与格式混用指南""" # ... RULES = { "emoji_before_format": "Emoji放在格式符号之前,不影响格式渲染", "emoji_inside_format": "Emoji在格式符号内部时,确保符号紧贴文字部分", "emoji_after_format": "Emoji放在格式符号之后,不影响格式渲染", } # ... EXAMPLES = { "correct_emoji_bold": "🔥 *限时特惠* 🔥", "correct_emoji_list": "📦 订单明细:\n* 商品A\n* 商品B", "correct_emoji_quote": "💡 温馨提示:\n> 请及时确认收货", "warning_emoji_inside": "🔥*限时特惠*🔥 (部分设备可能不渲染加粗)", } # ... def get_recommendation(self, emoji: str, format_type: str) -> str: """获取Emoji与格式的推荐组合方式""" return f"推荐: {emoji} {format_type}文本{format_type} {emoji}" ``` #### 多行格式处理 ```text ┌─────────────────────────────────────────────────────────┐ │ 多行格式处理规范 │ ├─────────────────────────────────────────────────────────┤ │ 1. 加粗/斜体/删除线不可跨行(每行独立使用) │ │ 2. 等宽体不可跨行(每行独立使用) │ │ 3. 引用块可跨行(每行以 > 开头) │ │ 4. 列表项每行独立(每行以 * 或数字开头) │ │ 5. 空行用于段落分隔,不影响格式 │ └─────────────────────────────────────────────────────────┘ ``` ### 2. 高级排版模式库 #### 商务排版模式 #### 营销排版模式 ```text *营销推广模式* # ... 适用于:促销活动、产品推广、优惠通知 # ... *结构规范:* * 标题:加粗 + Emoji吸引注意 * 副标题:斜体,营造氛围 * 商品:编号列表,清晰展示 * 价格:删除线原价 + 加粗现价 * 紧迫感:引用块,限时限量提示 # ... *示例:* 🔥 *夏季清仓大促* 🔥 # ... _一年仅此一次,错过再等一年_ # ... *精选商品* 1. 蓝牙耳机 Pro - ~299元~ *199元* 2. 智能手表 - ~599元~ *399元* 3. 无线充电器 - ~99元~ *59元* # ... ``` #### 客服排版模式 ```text *客服沟通模式* # ... 适用于:客户服务、售后支持、咨询回复 # ... *结构规范:* * 问候:加粗标题 + 斜体问候语 * 选项:列表形式,便于客户选择 * 说明:普通文本,简洁明了 * 结语:引用块,服务承诺 # ... *示例:* *客服中心* # ... _您好,很高兴为您服务_ # ... 请问需要什么帮助? # ... 1. 查询订单状态 2. 申请退换货 3. 产品使用咨询 4. 转人工客服 # ... ``` #### 技术排版模式 ```text *技术文档模式* # ... 适用于:技术说明、操作指引、故障排查 # ... *结构规范:* * 标题:加粗 * 步骤:编号列表,每步清晰 * 代码/命令:等宽体 * 注意事项:引用块 * 技术参数:列表形式 # ... *示例:* *API接入指引* # ... *操作步骤* 1. 获取API Key: `sk-详情见说明详情见说明详情见说明详情见说明` 2. 设置请求头: `Authorization: Bearer ` 3. 发送请求到: `https://api.example.com/v1/send` # ... *请求参数* * phone: 收件人号码(含国家代码) * message: 消息内容(最多4096字符) * type: 消息类型(text/media/template) # ... ``` **输出**: 返回高级排版模式库的处理结果,包含执行状态码、结果数据和执行日志. ### 3. 多语言格式指南 > 详细代码示例已移至 `references/detail.md` **输入**: 用户提供多语言格式指南所需的指令和必要参数. **处理**: 解析多语言格式指南的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回多语言格式指南的处理结果,包含执行状态码、结果数据和执行日志. **输入**: 用户提供交互式格式测试所需的指令和必要参数. **处理**: 解析交互式格式测试的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回交互式格式测试的处理结果,包含执行状态码、结果数据和执行日志. **输入**: 用户提供团队规范定制与合规审计所需的指令和必要参数. **处理**: 解析团队规范定制与合规审计的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回团队规范定制与合规审计的处理结果,包含执行状态码、结果数据和执行日志. # ## 快速开始 1. 确认运行环境满足依赖说明中的要求 2. 在AI Agent对话中调用本技能,提供必要的输入参数 3. 检查输出结果,根据需要进行后续处理 > 详细的输入输出格式请参考下方章节说明。 ## 适用场景 ### 场景一:制定团队WhatsApp消息规范 企业内容团队使用PRO版指南制定统一的WhatsApp消息格式规范. ```python auditor = ComplianceAuditor("优品商城") # ... team_standards = { "notification": "通知类消息须使用加粗标题 + 编号列表 + 引用落款", "marketing": "营销类消息须使用Emoji + 加粗 + 删除线价格 + 紧迫感引用", "service": "客服类消息须使用加粗问候 + 斜体服务语 + 编号选项", } # ... cs_message = """*客服中心* # ... _您好,很高兴为您服务_ # ... 1. 查询订单 2. 售后服务 # ... result = auditor.audit_message(cs_message, {"type": "service"}) print(f"合规状态: {result['overall']}") ``` ### 场景二:多语言团队格式培训 国际化客服团队使用多语言指南培训各语言团队. ```python guide = MultilingualStyleGuide() # ... for lang_info in guide.list_languages(): lang_guide = guide.get_guide(lang_info["code"]) print(f"\n{lang_guide['name']}") print(f" 加粗示例: {lang_guide['bold_example']}") print(f" 注意事项: {lang_guide['notes']}") ``` ### 场景三:消息批量合规审计 对一批待发送消息进行格式合规审计,确保全部通过后再发送. ```python messages = [ "*发货通知* 订单已发出 - 优品商城", "## 标题 **内容** 优品商城", "*活动* ~原价199~ *现价99* 优品商城", ] # ... for msg in messages: result = auditor.audit_message(msg) status = "通过" if result["overall"] == "pass" else "不通过" print(f"[{status}] {msg[:30]}...") # ... report = auditor.generate_report() print(f"\n总审计: {report['summary']}") ``` ## 使用流程 ### 从免费版升级 ```bash skill-platform skills install whatsapp-style-guide-pro skill-platform gateway restart # ... ``` ### 全新安装 ```bash skill-platform skills install whatsapp-style-guide-pro # ... python3 init_team_guide.py --org "你的公司名" # ... python3 interactive_test.py ``` # ## 输入格式 | 参数名 | 类型 | 必填 | 说明 | |:-----|:-----|:-----|:-----| | content | string | 否 | whatsapp-style-guide处理的内容输入 |, 默认: 全部维度 | | strict_level | string | 否 | 审查严格度, 可选: strict/normal/loose, 默认: normal | ## 输出格式 ```json { "success": true, "data": { "overall_grade": "A", "total_score": 92, "max_score": 100, "summary": "处理完成", "details": [ { "item": "代码风格", "status": "pass", "score": 95, "comment": "符合规范" }, { "item": "安全合规", "status": "warn", "score": 80, "comment": "符合规范" } ], "improvements": [ { "priority": "high", "suggestion": "建议优化", "expected_gain": "+5分" }, { "priority": "medium", "suggestion": "建议优化", "expected_gain": "+3分" } ] }, "error": null } ``` ## 异常处理 | 错误场景 | 原因 | 处理方式 | |---:|---:|---:| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | ## 依赖说明 ### 运行环境 - **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等) - **操作系统**: Windows / macOS / Linux - **Python**: 3.8+(交互式测试和合规审计脚本需要) ### 第三方依赖 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:---:|:---:|:---:|:---:| | LLM API | API | 必需 | 由Agent内置LLM提供 | | Python 3.8+ | 运行时 | 推荐 | python.org 下载 | | re | 标准库 | 必需 | Python内置 | | json | 标准库 | 必需 | Python内置 | | datetime | 标准库 | 必需 | Python内置 | ### API Key 配置 - 本Skill为纯Markdown指令型指南工具,无需额外API Key - 所有规范内容和测试功能在本地完成,不依赖外部服务 - 合规审计日志存储在本地文件系统 ### 可用性分类 - **分类**: MD+EXEC() - **说明**: 基于Markdown的AI Skill,提供完整的WhatsApp格式规范体系和合规审计能力 - **运行模式**: 纯本地处理,支持交互式测试和批量审计 - **安全等级**: 审计日志可选加密存储;规范版本支持变更追踪 - **兼容性**: 与免费版(whatsapp-style-guide-free)完全兼容,支持无缝升级 ## 案例展示 ### 示例1: 基础用法 **输入**: ```json { "content": "示例内容", "strict_level": "normal" } ``` **输出**: ``` 评级: B级(良好) - 总分: 85/100 # ... 检查详情: - 代码风格: 通过(95分) - 检查通过 - 安全合规: 警告(75分) - 检查通过 - 无障碍性: 通过(85分) - 检查通过 # ... 改进建议: 1. [高优先级] 建议优化 2. [中优先级] 建议优化 ``` ### 示例2: 进阶用法 **输入**: ```json { "content": "示例内容", "strict_level": "strict" } ``` **输出**: ``` 评级: C级(及格) - 总分: 70/100 # ... 检查详情: - 代码风格: 通过(90分) - 检查通过 - 安全合规: 不通过(50分) - 检查通过 - 无障碍性: 警告(70分) - 检查通过 # ... 改进建议: 1. [高优先级] 建议优化 2. [高优先级] 建议优化 3. [低优先级] 建议优化 ``` ### 示例3: 边界情况 - 边界情况 **输入**: ```json { "content": "示例内容" } ``` **输出**: ``` 评级: D级(不及格) - 总分: 45/100 # ... 检查详情: - 代码风格: 不通过(40分) - 检查通过 - 安全合规: 不通过(30分) - 检查通过 - 无障碍性: 通过(65分) - 检查通过 # ... 改进建议: 1. [紧急] 建议优化 2. [高优先级] 建议优化 ``` ## 常见问题 ### Q1: PRO版指南包含哪些免费版没有的内容? **A:** PRO版新增了:边界场景处理(特殊字符转义、Emoji混用、多行格式)、高级排版模式库(商务/营销/客服/技术四种场景模式)、多语言格式指南(中/英/日)、交互式格式测试器和合规审计报告功能. ### Q2: 合规审计可以自动化吗? **A:** 可以。PRO版支持批量消息合规审计,可集成到消息发送流程中,在发送前自动检查格式合规性。不合规的消息会被拦截并生成修正建议. ### Q3: 多语言指南的格式规则是否一致? **A:** 格式语法规则跨语言一致(WhatsApp的格式符号不随语言变化)。但排版习惯和注意事项会根据语言特点有所不同,如中文字符与格式符号之间不留空格、全角符号不影响格式等. ### Q4: 自定义排版模式如何添加? **A:** 在配置的 `custom_patterns` 目录下创建模式定义文件(JSON格式),定义模式名称、结构规范和示例。PRO版会自动加载自定义模式. ### Q5: 交互式测试支持哪些功能? **A:** 交互式测试支持:格式检测(识别文本中使用的所有格式)、问题诊断(检测禁止模式和不规范用法)、渲染预估(模拟WhatsApp端的显示效果)和修正建议(自动提供修复方案). ### Q6: 如何与免费版用户协作? **A:** PRO版与免费版完全兼容。免费版用户可以查看核心语法规范,PRO版用户额外拥有高级模式和审计能力。团队中可以混合使用两个版本,PRO版用户的审计报告可共享给免费版用户参考. ## 错误处理 | 错误场景(续)| 原因 | 处理方式 | |:---------|---------:|:---------| | LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 | | 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 | | 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 | | 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |