content-review

name	content-review
description	审查 zero2Agent 项目中的文章内容质量。当用户说"审查文章"、"review内容"、"检查这篇文章写得怎么样"、"看看这篇符不符合项目风格"、"帮我看看内容质量"时触发。负责对照项目风格标准进行结构化评审，输出具体的改进建议。即使用户只是说"帮我看看写得怎么样"，只要涉及 zero2Agent 的 Markdown 文章，也应当触发此技能。

content-review：文章内容审查

本技能用于对 zero2Agent 项目中的 Markdown 文章进行结构化质量审查。

审查维度（7 项）

1. Frontmatter 完整性

• layout: default 是否存在
• title、description、eyebrow 是否均已填写
• eyebrow 格式是否正确（如 Agent Basic / 05）
• description 长度是否在 10–30 字之间

2. 开篇质量（问题优先）

• 开头是否先说"为什么这个问题值得关注"，而非直接给定义
• 是否引出了读者可能有的误解或常见困惑
• 前 3 段是否能让读者产生"这跟我有关"的感觉

3. 工程视角

• 概念解释是否落脚到"它在系统里扮演什么角色"
• 是否有具体的系统行为描述，而不只是抽象定义
• 是否提到了真实工程场景中的约束或权衡

4. 避免框架崇拜

• 是否出现了对某个框架的无条件推荐
• 每次提到框架时是否说明了"它解决什么问题"和"它的代价"
• 是否有"X 是最佳实践"这类不加论证的断言

5. 暴露真实复杂度

• 是否主动提到了容易踩坑的地方
• 是否区分了"Demo 能跑"和"生产可用"的差距
• 是否对失败场景有基本描述

6. 语言和结构

• 全文是否使用中文（代码块、路径、专有名词除外）
• 段落是否简洁，避免废话和修饰语堆砌
• 是否合理使用了 # ## ### 标题层级
• 是否合理使用了代码块（text 或具体语言）展示流程/示例

7. 文末导航

• 是否有"下一篇建议继续看："的链接
• 链接路径是否使用相对路径 + index.html

输出格式

审查结果按如下结构输出：

## 审查报告：{文章标题}

**整体评分**：✅ 通过 / ⚠️ 需改进 / ❌ 有明显问题

### 1. Frontmatter 完整性
状态：✅ / ⚠️ / ❌
说明：{具体发现，若通过则简写"符合要求"}

### 2. 开篇质量
状态：…
说明：…

### 3. 工程视角
…（以此类推）

---

## 改进建议

{按优先级排列的具体修改建议，每条说明原因}

1. **[高优先级]** {问题描述} → 建议：{具体怎么改}
2. **[中优先级]** …
3. **[低优先级]** …

执行步骤

1. 定位文章：如果用户没有指定路径，根据对话上下文判断要审查哪篇文章。如果不明确，询问用户。

2. 读取文章：用 Read 工具读取对应的 index.md。

3. 逐维度审查：按上述 7 个维度逐一检查，记录发现。

4. 输出报告：按输出格式生成报告，改进建议要具体到"第几段、哪句话、怎么改"，不要泛泛而谈。

5. 可选：批量审查：如果用户要求审查整个模块，依次读取所有文章并汇总报告，最后给出模块级别的总结（哪些维度普遍偏弱）。