| name | review-article |
| description | Zenn記事の品質を多角的にレビューするスキル。記事作成・編集完了時、/publishの前、または「記事をレビューして」と依頼された場合に使用。読者視点、正確性、引用・出典、構成、SEO、Zenn固有の6観点でチェックし、Codexレビューも実施して総合評価を出力する。 |
記事レビュー
Zenn記事の品質を多角的にレビューする。
チェック手順
- 対象記事ファイルを読み込む(指定がなければ直近編集中の記事を自動検出)
- 以下の6観点でチェックを実施
/ask-codex でCodexにレビューを依頼(必須・スキップ禁止)
- Codexの指摘を確認・精査し、採否を判断
- 最終的なレビュー結果をまとめて出力
6つの観点
A. 読者視点
- 対象読者が明確(「誰向け」「何が得られるか」が冒頭で分かる)
- 読者メリットが具体的
- 前提知識が明示されている
B. 内容の正確性
- コード・コマンドが動作する
- バージョン情報が明記されている
- 再現可能な手順になっている
- 環境情報(OS、言語バージョン等)が明記されている
C. 引用・出典
- 外部情報は出典URLを記載
- 公式ドキュメントへのリンクがある
- 外部リンクは日本語版を優先(/ja/ 版があれば使用)
- 画像・コードのライセンスが適切
D. 構成・読みやすさ
- 論理的な流れ(導入→課題→解決→結果)
- 適切な見出し階層(h2から開始)
- 段落が長すぎない(目安: 3-5文)
- コードブロックに言語指定・ファイル名がある
E. SEO・発見性
- タイトル60文字以内
- topics適切(関連性のあるタグ、最大5つ)
- 検索キーワードが含まれている
F. Zenn固有
- Front Matter完備(title, emoji, type, topics, published)
- Zenn記法活用(:::message, :::details等)
- 画像にaltテキストがある
Codexレビュー(必須)
/ask-codex で以下を依頼:
この記事をレビューしてください。以下の観点でフィードバックをお願いします:
1. 記事の論理構成は適切か
2. 技術的な説明に不正確な点はないか
3. 読者視点で分かりにくい箇所はないか
4. 改善すべき点があれば具体的に指摘してください
Codexの指摘は参考意見として扱い、最終判断はClaude Codeが行う。
| 採用 | 不採用 |
|---|
| 読者視点で有効な指摘 | Zennのトーンと合わない |
| 技術的な誤りの指摘 | このリポジトリの方針と矛盾 |
| 見落としていた観点 | 根拠が不明確な指摘 |
出力フォーマット
# 記事レビュー結果
## 総合評価
⭐⭐⭐⭐☆ (4/5)
## 良い点
- ...
## 改善が必要な点
### 優先度: 高
- [ ] ...(理由と改善案)
### 優先度: 中
- [ ] ...
## 各観点の評価
| 観点 | 評価 | コメント |
| ---------- | ---------- | -------- |
| 読者視点 | ⭐⭐⭐⭐☆ | ... |
| 正確性 | ⭐⭐⭐⭐⭐ | ... |
| 引用・出典 | ⭐⭐⭐☆☆ | ... |
| 構成 | ⭐⭐⭐⭐☆ | ... |
| SEO | ⭐⭐⭐⭐☆ | ... |
| Zenn固有 | ⭐⭐⭐⭐⭐ | ... |
## Codexからの指摘と対応
| 指摘内容 | 採否 | 理由 |
| ---------------------- | --------- | ---------------------- |
| 〇〇について補足が必要 | ✅ 採用 | 読者視点で有効 |
| △△の表現を変更すべき | ❌ 不採用 | Zennのトーンと合わない |