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 个维度逐一检查,记录发现。
输出报告:按输出格式生成报告,改进建议要具体到"第几段、哪句话、怎么改",不要泛泛而谈。
可选:批量审查:如果用户要求审查整个模块,依次读取所有文章并汇总报告,最后给出模块级别的总结(哪些维度普遍偏弱)。