name: article-quality-check description: "記事投稿前の品質チェックと必須項目確認。サムネイル未設定、メタデータ不備、フォーマット問題を自動検出し、tifaなど新任エージェントのミス防止に特化。「記事チェック」「投稿前確認」「品質保証」「新任サポート」などの作業に使う。"

Article Quality Check Skill

概要

記事投稿前の包括的品質チェック。特に新任エージェント（tifa等）のサムネイル設定忘れや必須項目の見落としを防ぐ。

🚨 tifa用：記事投稿前必須チェックリスト

Step 1: サムネイル画像確認（最重要）

# 記事ファイルまたはWordPress投稿JSONをチェック
grep -E "(image|featured_media)" [記事ファイル]

# ✅ 正常例：
# "image": "https://images.unsplash.com/photo-xxx?w=800&h=420&fit=crop"
# "featured_media": 123

# ❌ NG例：
# "image": ""
# "featured_media": null
# サムネイル設定なし

サムネイル未設定の場合の対処：

Unsplash検索: web_search("site:unsplash.com [記事テーマ] technology")
適切な画像ID取得
URL形式: https://images.unsplash.com/photo-{ID}?w=800&h=420&fit=crop
記事に設定

Step 2: 必須メタデータ確認

# チェック項目：
- [ ] タイトル設定済み
- [ ] スラッグ設定済み（英語）
- [ ] カテゴリ設定済み
- [ ] メタディスクリプション（120文字以内）
- [ ] サムネイル画像設定済み

Step 3: コンテンツ品質確認

# AIニュース記事の場合（必須）
grep -E "(参考リンク|公式サイト|出典)" [記事ファイル]

# ✅ 必要な要素：
- [ ] ニュースソースURL
- [ ] 公式サイトリンク
- [ ] 参考リンクセクション

Step 4: WordPress投稿データ検証

# JSON投稿データの確認（POST /wp/v2/posts）
cat post_data.json | jq '.featured_media'
# → null または 0 の場合はサムネイル未設定

cat post_data.json | jq '.excerpt'
# → 空文字の場合はメタディスクリプション未設定

自動チェック機能

使用例

# 記事ファイルのチェック
article-quality-check /path/to/article.md

# WordPress投稿JSONのチェック
article-quality-check --json post_data.json

# 投稿前の包括チェック
article-quality-check --pre-publish /path/to/article.md

エラーパターンと対処

エラー	原因	対処法
`THUMBNAIL_MISSING`	サムネイル未設定	thumbnail-generatorスキルで画像設定
`METADATA_INCOMPLETE`	メタデータ不備	title, slug, category確認
`SOURCE_LINKS_MISSING`	出典リンクなし	公式サイト・ニュースソースURL追加
`EXCERPT_EMPTY`	メタディスクリプション空	120文字以内の要約作成
`TABLE_LAYOUT_BROKEN`	テーブル列幅異常	テーブルガイドライン参照

テーブルレイアウトチェック（AI Solo Craft記事用）

Step 5: テーブル表示確認

詳細なチェック手順・テーブル種類別の確認ポイント・問題発生時の対処法: → references/table-layout-guide.md

緊急修正コマンド

サムネイル・メタディスクリプションの緊急修正スクリプト: → scripts/emergency-fix.sh

# 使用例
./scripts/emergency-fix.sh thumbnail <POST_ID> <IMAGE_ID> <USER:PASS>
./scripts/emergency-fix.sh excerpt   <POST_ID> "<要約テキスト>" <USER:PASS>

新任エージェント向けガイド

tifaへの注意事項

記事投稿前は必ずこのスキルでチェックを実行
サムネイル未設定は読者の第一印象に直結する重要項目
「後で設定する」は禁止 → 投稿前に必ず完成させる
不明な点があれば他のエージェントに確認

よくあるミスパターン（tifa注意）

サムネイル設定忘れ（最多）
英語スラッグ忘れ
カテゴリ未設定
出典リンク忘れ（AIニュース）
メタディスクリプション空白
編集部コメント未追加（digest / news 記事は必須）

Step 6: 編集部コメント確認（AI Solo Craft 記事用）

digest / news 記事には、編集部コメントセクション が body_markdown 末尾に含まれている必要がある。

確認方法:

# body_markdown に editorial-section が含まれているか
grep -c "editorial-section" [記事ファイルまたはDB出力]

必須コメンター（4名）:

🔧 エンジニア — expert-engineer
🎨 デザイナー — expert-designer
📊 マネージャー — expert-manager
📋 シニアデスク — desk-summary

⚠️ comment-name に人名が入っていたらNG。絵文字のみ（🔧/🎨/📊/📋）。

対象外: product 辞書ページ

テンプレート: digest-writer スキル参照

統合ワークフローでの使用

# article-writerと組み合わせた安全な投稿
1. article-writer でコンテンツ作成
2. article-quality-check で事前検証 ← 新追加
3. 問題なければWordPress投稿実行
4. 投稿後の最終確認

⚠️ よくある落とし穴

サムネイル設定忘れ（最多ミス）: 最も頻発するミス。featured_mediaがnullまたは0の場合はサムネイル未設定。「後で設定する」は禁止、投稿前に必ず完成させること
メタディスクリプション空白: excerptが空文字だとSEOとSNSシェア時に不利。120文字以内の要約を必ず設定する
英語スラッグの設定忘れ: スラッグが日本語のまま投稿するとURLが長くなりシェアしにくい。英語のkebab-caseスラッグを必ず設定する
AIニュース記事の出典リンク欠落: AIニュース記事には公式サイト・ニュースソースURLが必須。grepで出典セクションの有無を確認してから投稿する
編集部コメント未追加: digest/news記事には編集部コメントセクション（エキスパート4名）が必須。product辞書ページは対象外。comment-nameに人名を入れず絵文字のみ（🔧/🎨/📊/📋）を使うこと
テーブルレイアウト崩れの見落とし: CSSはtable-layout: autoで自動幅だが、「合計」が「合」「計」で改行されたり、数値列が広すぎる場合がある。nth-child固定幅指定がないか確認する

Created: 2026-02-10 for tifa onboarding and thumbnail issue prevention