| 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. **[低优先级]** …
执行步骤
-
定位文章：如果用户没有指定路径，根据对话上下文判断要审查哪篇文章。如果不明确，询问用户。
-
读取文章：用 Read 工具读取对应的 index.md。
-
逐维度审查：按上述 7 个维度逐一检查，记录发现。
-
输出报告：按输出格式生成报告，改进建议要具体到"第几段、哪句话、怎么改"，不要泛泛而谈。
-
可选：批量审查：如果用户要求审查整个模块，依次读取所有文章并汇总报告，最后给出模块级别的总结（哪些维度普遍偏弱）。
