voice-reviewer

语气审校器

根据项目的语气指南审校内容。此技能会读取项目的语气指南和 lint 规则，然后检查内容文件是否存在违规。

工作原理

1. 查找语气指南：在项目根目录中查找 docs/brand-voice-guidelines.md、.voice-lint.json 或类似文件。
2. 阅读规则：提取句子长度限制、禁用词、语气要求、双语政策和结构模式。
3. 审校内容：检查每个文件是否符合所有规则。
4. 报告结果：列出违规项、所在行、违反的规则和建议的修正方式。

检查内容

句子结构

• 最大句长（按指南规定的词数计算，通常为 20-30 个词）
• 每句话只表达一个观察
• 尽量使用缩略形式
• 句子长度以短到中等为宜

禁用模式

• 最高级用语（best、top、must-visit、amazing、incredible）
• 感叹号
• 表情符号
• 流行俚语（hits different、no cap、lowkey、将 vibe check 用作动词）
• 话题标签风格
• 形容词堆砌（cozy、intimate、must-visit spot）
• 专家或权威人士的断言（everyone knows、locals say、the best）

语气

• 侧重观察，而非宣传
• 具体，而非含糊
• 保持好奇，而非自信满满
• 自然真诚，不刻意表演
• 使用“It felt like...”，而非“The best...”

双语政策（如适用）

• 检查 EN:ES 比例目标（例如，loops 为 85:15，rituals 为 95:5）
• 西班牙语插句不得超过字数上限（通常最多 6 个词）
• 不得用西班牙语重复完整内容
• H1/H2 标题中不得使用西班牙语

结构模式

• 抵达 -> 细节 -> 转变 -> 释放的叙事弧线
• 展示，而非讲述
• 每个部分至少包含一处具体的感官细节
• 这个段落能否原封不动地放在另一座城市？（如果能，就需要重写）

输出格式

## Voice Review: [filename]

### Violations

1. **Line 23**: "This amazing, must-visit hidden gem is perfect for date night!"
   - **Rule**: No superlatives, no adjective stacking
   - **Fix**: "The place looks quiet until you sit down."

2. **Line 45**: Sentence is 31 words (max: 24)
   - **Rule**: Max sentence length
   - **Fix**: Split into two sentences.

3. **Line 67**: Spanish aside "entonces vamos a intentar algo nuevo juntos" (7 words)
   - **Rule**: Spanish asides max 6 words
   - **Fix**: Trim to "vamos a intentar algo nuevo" (5 words)

### Summary
- 3 violations found
- 0 critical (forbidden terms)
- 2 structural (sentence length, adjective stacking)
- 1 bilingual (Spanish aside too long)

Agentic 工作流与 Vibe Coding

• **迭代优化：**不要指望第一次就能完成完美的语气审校。先撰写初步审校意见，再检查是否正确应用了指南且没有过于吹毛求疵，找出具体误用规则的地方，并改进评述。每次只调整一种规则的解读。
• **Vibe Coding：**在发送最终反馈或尝试大幅改写文档之前，先在本地提交审校笔记或拟议的内容修改。

作为子 Agent 使用

作为子 Agent 调度时，请提供：

1. 要审校的文件
2. 语气指南的路径
3. .voice-lint.json 的路径（如果存在）

审校器应先阅读语气指南，然后逐个独立审校文件。