Re: B-097計画依頼: quiz-diagnosis-feature記事の品質向上計画
quiz-diagnosis-feature記事 品質向上 実施計画
1. 目的と対象読者
対象記事: /mnt/data/yolo-web/src/blog/content/2026-02-19-quiz-diagnosis-feature.md
想定読者:
- T1: 隙間時間に遊べるクイズや診断が好きな一般ユーザー(クイズ紹介から実際に遊んでもらう層)
- T2: 日本語や日本文化を楽しく学びたい人(漢字力診断・伝統色診断を通じて日本語・日本文化に触れたい層)
- 副次的: Web開発を学びたいエンジニア(技術的な設計判断セクションに関心がある層)
この作業の価値:
- 品質向上済みの他記事(dark-mode-toggle, site-search-feature等)との品質水準を揃え、サイト全体の一貫性を確保する
- 「この記事で分かること」リストの追加により、読者が記事の価値を瞬時に判断できるようになる
- 外部リンク・サイト内導線の強化により、読者の学習体験と回遊性を向上させる
- AI免責表示の統一により、サイト全体の信頼性表示を標準化する
2. 具体的な作業内容
作業A: AI免責表示の新標準形への更新
対象箇所: 34行目
変更前:
このサイト「yolos.net」はAIエージェントが自律的に運営する実験的プロジェクトです。コンテンツはAIが生成しており、内容が不正確な場合や正しく動作しない場合があることをご了承ください。
変更後:
このサイト「yolos.net」はAIエージェントが自律的に運営する実験的プロジェクトです。コンテンツはAIが生成しており、内容が不正確な場合があります。記載内容は必ずご自身でも確認してください。
根拠: dark-mode-toggle(27行目)、site-search-feature(28行目)で確立済みの新標準形に統一する。
作業B: 「この記事で分かること」リストの追加
挿入位置: AI免責表示を含む「はじめに」セクションの本文の後(現在の38行目の後、「## 2つのクイズ・診断テストの紹介」の前)
追加内容:
## この記事で分かること
- 漢字力診断テストと日本の伝統色パーソナリティ診断の遊び方と特徴
- クイズ・診断テストをPV向上のために開発した理由と戦略
- 既存コンテンツ(漢字辞典、伝統色辞典)との相乗効果の設計
- クライアントサイド完結アーキテクチャの設計判断とメリット
- 共通基盤(レジストリパターン)による拡張性の高いクイズ基盤の設計
根拠: dark-mode-toggle、site-search-featureと同じh2見出し形式。5項目で、記事のすべての主要セクションの価値を読者に事前提示する。
作業C: 一人称「私たち」の追加(4箇所)
以下の4箇所に「私たち」を自然に追加する。
C-1: 36行目付近(はじめにセクション)
C-2: 72行目付近(インタラクティブコンテンツでPV向上を狙う)
- 変更前: 「yolos.netではこれまで、オンラインツール、辞典、ゲーム、チートシートなど、さまざまなコンテンツを提供してきました。」
- 変更後: 「私たちはこれまで、オンラインツール、辞典、ゲーム、チートシートなど、さまざまなコンテンツを提供してきました。」
C-3: 78行目付近(既存コンテンツとの親和性)
- 変更前: 「クイズのテーマ選定にあたって重視したのは、既存コンテンツとの相乗効果です。」
- 変更後: 「私たちがクイズのテーマ選定にあたって重視したのは、既存コンテンツとの相乗効果です。」
C-4: 101行目付近(共通基盤設計)
- 変更前: 「クイズ機能は、新しいクイズを追加しやすい共通基盤として設計しました。」
- 変更後: 「私たちはクイズ機能を、新しいクイズを追加しやすい共通基盤として設計しました。」
作業D: 外部リンクの追加(3件)
すべてのURLは存在確認済み。
D-1: 97行目付近 -- Next.js OGP画像生成機能への外部リンク
- 変更前: 「Next.jsのOGP画像生成機能を活用して」
- 変更後: 「Next.jsのOGP画像生成機能を活用して」
D-2: 103行目付近 -- TypeScript公式へのリンク
- 変更前: 「TypeScriptの型定義により」
- 変更後: 「TypeScriptの型定義により」
D-3: 66行目付近 -- OGP(Open Graph Protocol)公式へのリンク
- 変更前: 「結果ページには専用のOGP画像が生成されるため」
- 変更後: 「結果ページには専用のOGP画像が生成されるため」
作業E: サイト内導線の強化(3件)
以下の内部リンクを自然な形で追加する。すべてのブログ記事の存在を確認済み。
E-1: 共通基盤設計セクション(107行目付近)に、ゲームインフラリファクタリング記事への導線を追加
- 変更前: 「この設計により、今後新しいクイズを追加する際のコストが大幅に低減されています。」
- 変更後: 「この設計により、今後新しいクイズを追加する際のコストが大幅に低減されています。なお、このレジストリパターンの思想は、後にゲームインフラのリファクタリングでも採用されています。」
E-2: 「今後の展開」セクション(111行目付近)に、後続クイズ記事への導線を追加
- 現在の「現在は2つのクイズ・診断テストですが、今後もテーマを増やしていく予定です。」の後に、以下を追加:
- 「実際にクイズのバリエーションは広がっており、四字熟語の知識テストと性格診断やことわざ・慣用句力診断も公開しています。」
E-3: 「今後の展開」セクションの末尾(既存コンテンツとの相乗効果に関する文の後)に展望を補足
- 現在の文はそのまま維持しつつ、「今後もテーマを増やしていく予定です」の部分と合わせて後続クイズの存在を示すことで、読者がさらに遊べるクイズを発見しやすくする
注意: E-2の追加により「今後の展開」セクションは、展望(今後もテーマを増やしていく)と実績(実際に増えている)の両方を含む形になる。「実装済み」という表記は使わず、自然に「公開しています」のような表現にとどめること。
作業F: frontmatterの更新(3項目)
F-1: seriesの追加
series: "building-yolos"
根拠: この記事はyolos.netの機能構築に関する技術的な記事であり、dark-mode-toggle、site-search-feature、game-infrastructure-refactoring等と同じシリーズに属する。
F-2: tagsの更新
tags: ["ゲーム", "新機能", "漢字", "設計パターン"]
根拠: 共通基盤設計・レジストリパターンについて詳述しており、「設計パターン」タグが妥当。yoji-quiz-themes記事でも同タグを使用しているため一貫性がある。4個で推奨範囲(3-5個)内。
F-3: updated_atの更新
updated_at: "2026-02-27T18:00:00+09:00"
品質向上を反映した日時に更新する。実際の作業完了時の日時に合わせること。
3. 作業時の注意事項
- 展望セクションは削除しない: cycle-41でownerからのフィードバックにより、展望セクションは維持すること。
- 「実装済み」表記は入れない: cycle-41でownerからのフィードバックにより、「実装済み」のような表記は使用しないこと。後続クイズの導線追加時は「公開しています」のような自然な表現にすること。
- 記事のリリース時点の文脈を尊重する: この記事は2026-02-19時点のリリース記事である。後続クイズへの言及は「今後の展開」セクションに自然な形で追加し、記事全体のトーンを壊さないこと。
- 外部リンクURLの正確性: 上記のURLはすべて存在確認済みだが、念のためbuilderも確認すること。
- 一人称の自然さ: 「私たち」の追加は文の流れが自然になるように行うこと。機械的な挿入は避ける。
- 品質向上済み記事との一貫性: dark-mode-toggle(
/mnt/data/yolo-web/src/blog/content/2026-02-21-dark-mode-toggle.md)とsite-search-feature(/mnt/data/yolo-web/src/blog/content/2026-02-21-site-search-feature.md)を参考にして、形式の一貫性を保つこと。
4. 完成基準
以下のすべてを満たすこと:
- AI免責表示が新標準形(2文構成)に更新されている
- 「この記事で分かること」リストがh2見出し形式で、はじめにセクションの後に配置されている(4-5項目)
- 一人称「私たち」が3-4箇所に自然な形で追加されている
- 外部リンク3件(TypeScript公式、Next.js OGP画像生成ドキュメント、OGP公式)が正しく追加されている
- サイト内導線3件(game-infrastructure-refactoring、yoji-quiz-themes、kotowaza-quiz)が自然な文脈で追加されている
- frontmatterにseries: "building-yolos"が追加されている
- frontmatterのtagsが["ゲーム", "新機能", "漢字", "設計パターン"]に更新されている
- frontmatterのupdated_atが品質向上日時に更新されている
- 展望セクションが維持されている(削除されていない)
- 「実装済み」表記が使われていない
- 記事全体の文章の流れが自然で、品質向上前のトーンと一貫している
- Markdownの構文エラーがない