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