// 技術記事の内容から読者の理解度をチェックする4択クイズを指定のYAML形式で生成するスキル。ユーザーが「この記事のクイズを作って」「理解度チェックを作成して」「記事を読んだ人向けの問題を作って」「selfAssessment形式でクイズを作って」と依頼したときに必ず使う。ブログ記事、技術ドキュメント、チュートリアル、解説記事、技術書の章など、読者の学習内容を確認する問題を作る必要があるあらゆる場面で使う。記事のURL・マークダウン・テキスト・ファイルパスのいずれを渡されても動作する。
引数で指定した記事のレビューを行います。記事スラッグを引数に渡すと、textlint による自動校正と誤字脱字・文法的な誤りの指摘を行います。/article-review [スラッグ] の形式で呼び出してください。記事を書いた後のチェック、公開前の校正、文章の品質確認にも使用してください。
ソフトウェアエンジニア向けの技術書・原稿をレビューし、構成・技術的正確性・読者体験の観点から改善提案を行うスキル。ユーザーが技術書の原稿、章のドラフト、チュートリアル記事、技術ドキュメントのレビューを依頼したときに使う。「原稿をレビューして」「この章を見てほしい」「技術書を書いている」「コードサンプルをチェックして」「構成についてアドバイスがほしい」といった依頼で発動する。技術書の執筆支援、編集フィードバック、構成改善、コードレビュー（書籍内のコード）、読者レベルの調整など、技術書制作に関わるあらゆるレビュー作業に対応する。
記事を英語に翻訳する。記事スラッグを引数に渡すと、日本語の記事を英語に翻訳して contents/blogPost/en/ に出力する。/translate [スラッグ] の形式で呼び出す。
| name | q |
| description | 技術記事の内容から読者の理解度をチェックする4択クイズを指定のYAML形式で生成するスキル。ユーザーが「この記事のクイズを作って」「理解度チェックを作成して」「記事を読んだ人向けの問題を作って」「selfAssessment形式でクイズを作って」と依頼したときに必ず使う。ブログ記事、技術ドキュメント、チュートリアル、解説記事、技術書の章など、読者の学習内容を確認する問題を作る必要があるあらゆる場面で使う。記事のURL・マークダウン・テキスト・ファイルパスのいずれを渡されても動作する。 |
技術記事から、読者の理解度をチェックする4択クイズを指定のYAML形式で生成するスキル。
出力は必ず以下のYAML形式に従う。コードブロックは ```skill タグで囲む。
selfAssessment:
quizzes:
- question: "クイズの問題文"
answers:
- text: "選択肢1"
correct: false
explanation: "不正解の理由"
- text: "選択肢2"
correct: true
explanation: "正解の理由"
- text: "選択肢3"
correct: false
explanation: "不正解の理由"
- text: "選択肢4"
correct: false
explanation: "不正解の理由"
selfAssessment、その下に quizzes の配列を置くquestion と answers を持つanswers は必ず4つの選択肢（text / correct / explanation）で構成する。3択や5択にしないcorrect は真偽値（true / false）で、文字列の "true" にしないexplanation はすべての選択肢に付ける（正解・不正解を問わず）"（ダブルクォート）やコロンが含まれる場合は、YAMLのエスケープルールに従って正しくクォートする入力パターンに応じて記事を取得する。
web_fetch で本文を取得するview、pdf なら pdf-reading スキル、docx なら docx スキルなど）本文を読み、以下を把握する。
常に3〜5問を作成する。記事のボリュームに応じて以下のように調整する。
ユーザーから明示的に問題数が指定された場合はそれに従う。
このスキルの問題は 「記事に書いてある内容を問う事実確認」 を中心に設計する。読者が記事をきちんと読んで覚えているかを確認することが目的。
事実確認問題であっても、選択肢の質が理解度測定の精度を決める。以下を守る。
explanation はすべての選択肢に付ける。
上記を踏まえ、指定のYAML形式で frontmatter に追記する。
以下は「Reactの useEffect について解説した記事」に対するクイズの例（4問・事実確認中心）。
selfAssessment:
quizzes:
- question: "useEffect の第2引数（依存配列）に空配列 [] を渡した場合の挙動として、記事で説明されているのはどれですか?"
answers:
- text: "コンポーネントがマウントされた直後に1回だけ実行される"
correct: true
explanation: "記事の通り、依存配列が空の場合、初回レンダリング後に1回だけ実行されます。"
- text: "毎回のレンダリング後に実行される"
correct: false
explanation: "これは第2引数を省略した場合の挙動として記事で説明されています。空配列を渡した場合ではありません。"
- text: "ステート変更のたびに実行される"
correct: false
explanation: "依存配列が空の場合、ステートが変わっても再実行されません。ステートに依存させたい場合は依存配列に含める必要があります。"
- text: "一度も実行されない"
correct: false
explanation: "空配列でもマウント時には1回実行される、と記事で明記されています。"
- question: "useEffect のクリーンアップ関数は、どのタイミングで実行されると記事で説明されていますか?"
answers:
- text: "コンポーネントのマウント直前"
correct: false
explanation: "マウント直前にはエフェクト本体もクリーンアップも実行されません。"
- text: "次のエフェクト実行前、およびアンマウント時"
correct: true
explanation: "記事で説明されている通り、クリーンアップは次のエフェクトが走る直前とアンマウント時に実行されます。"
- text: "毎回のレンダリング中"
correct: false
explanation: "レンダリング中ではなく、レンダリング後のエフェクトフェーズで実行されます。"
- text: "React がエラーを検知したときのみ"
correct: false
explanation: "クリーンアップはエラー検知とは関係なく、通常のライフサイクルで実行されます。"
- question: "記事で紹介されている useEffect の典型的なユースケースとして挙げられているものはどれですか?"
answers:
- text: "JSX のマークアップを定義する"
correct: false
explanation: "JSX はコンポーネントの return 文で直接書くもので、useEffect の用途ではありません。"
- text: "コンポーネント内のローカル変数を宣言する"
correct: false
explanation: "ローカル変数は通常の const/let で宣言します。useEffect は副作用を扱うためのフックです。"
- text: "データフェッチやサブスクリプションの設定"
correct: true
explanation: "記事で典型例として挙げられている通り、useEffect はデータ取得や購読のような副作用を扱うために使われます。"
- text: "コンポーネントの props の型を定義する"
correct: false
explanation: "型定義は TypeScript の interface や type で行うもので、useEffect の用途ではありません。"
- question: "useEffect 内で参照している state を依存配列に含めなかった場合、記事ではどのような問題が発生すると説明されていますか?"
answers:
- text: "コンパイルエラーになり、ビルドが通らない"
correct: false
explanation: "記事では、lint の警告は出るがビルドは通ると説明されています。"
- text: "エフェクト内で参照する state が古い値のままになる"
correct: true
explanation: "記事で説明されている通り、依存配列に含めないとエフェクトがマウント時の値を保持し続け、最新の state を参照できなくなります。"
- text: "state 自体が更新されなくなる"
correct: false
explanation: "state の更新自体は正常に動作する、と記事で明記されています。"
- text: "React が自動的にエフェクトを無限に再実行する"
correct: false
explanation: "依存配列に含まれていないものの変化は React が検知しないため、逆に再実行されなくなります。"
: や " が含まれる場合は注意する