article-quiz

Files (1)

• SKILL.md

SKILL.md (first lines)

# Article Quiz

記事の理解度テストを出題・採点する汎用スキル。

## Step 1: 記事本文の取得

`$ARGUMENTS` を入力として受け取る。

- `$ARGUMENTS` が `http` で始まる場合: URLとして扱い、WebFetch で記事の全文を取得する
  - url: `$ARGUMENTS`
  - prompt: 「この記事の本文テキストをすべて抽出してください」
- `$ARGUMENTS` が `http` で始まらない場合: テキストとしてそのまま記事内容として利用する（フォールバック用）
- `$ARGUMENTS` が空の場合: AskUserQuestion で記事URLを尋ねる

**WebFetchが失敗した場合（ペイウォール、404等）**:
以下の構造化結果を出力して処理を終了する:

```
## Quiz Result
- **URL**: <URL>
- **Result**: FETCH_FAILED
- **Error**: <エラーの説明>
```

## Step 2: 理解度テストの生成

取得した記事内容をもとに、5問の質問を生成する。

### 質問の構成
- **選択式**: Q1〜Q3（3問、A/B/C/D の4択）
- **記述式**: Q4〜Q5（2問、短文で回答）

### 質問の方針
- 記事の重要な概念や主張の理解を問う
- 些末な詳細（日付、数値など）は避ける
- 実務に活かせる知識の定着を重視する
- 記述式の問題のみ、問題文の末尾に `💡 ヒント: <キーワード>` を付けて手がかりを提示する（選択式にはヒントを付けない）

### 内部で保持する情報
各質問について以下を生成しておく（ユーザーには見せない）:
- 正解
- 解説（3〜5文程度。記事のどの部分に基づく問題か、正解の根拠となる記事中の記述や概念、なぜ他の選択肢が不正解かを含めて説明する）

## Step 3: AskUserQuestion で出題

AskUserQuestion の複数問同時出題機能を使い、**2回に分けて**出題する。
回答中は正誤を表示しない。全問の回答をすべて集めてから次のステップに進む。

### 1回目: 選択式（Q1〜Q3）

AskUserQuestion の `questions` に3問を同時にセットして出題する。

各問の設定:
- `question`: 問題文（ヒントなし）
- `header`: `Q1`, `Q2`, `Q3`
- `options`: A/B/C/D の4つの選択肢
- `multiSelect`: false

### 2回目: 記述式（Q4〜Q5）

AskUserQuestion の `questions` に2問を同時にセットして出題する。

各問の設定:
- `question`: 問題文 + `💡 ヒント: <キーワード>`
- `header`: `Q4`, `Q5`
- `options`: 「わからない」の選択肢を用意する（ユーザーは「その他」で自由記述回答する）
- `multiSelect`: false

## Step 4: 全問回答後に採点とフィードバック

全問の回答が揃ったら、まとめて採点と解説を行う。

### 採点方法
- 選択式: 正解と完全一致で正解
- 記述式: 以下をすべて満たす場合のみ正解とする
  - 回答の意味が正解と概ね一致している（厳密な文字列一致は不要）
  - **ヒントのキーワードをそのまま（または単語だけを）書き写しただけの回答は不正解**とする
  - ヒントを踏まえた上で、主語・述語・目的語などが揃った論理的な文章として回答が成立している
  - 例:
    - ヒント「キャッシュ戦略」に対し回答が「キャッシュ戦略」→ 不正解（ヒントの書き写し）
    - ヒント「キャッシュ戦略」に対し回答が「頻繁にアクセスされるデータをキャッシュ戦略で保持し、レスポンスを高速化する」→ 正解（論理的な文章として成立）

### 合格基準: 70%以上

| 問題数 | 合格ライン |
|--------|-----------|
| 3問 | 2問以上正解 |
| 4問 | 3問以上正解 |
| 5問 | 4問以上正解 |

### 表示する内容

テーブル形式で採点結果を表示する（解説はテーブル内に含め、`<br>` で改行する）:

| # | 正誤 | あなたの回答 | 正解 | 解説 |
|---|------|-------------|------|------|
| Q1 | ⭕ | B | B | 記事では○○について△△と述べており…<br>この概念は□□の文脈で重要 |
| Q2 | ❌ | A | C | ○○の部分で説明されている通り…<br>Aが不正解な理由は△△ |

最後にまとめ:
- スコア（例: 3/5）
- 合否判定
- 理解が不十分だったポイントのまとめ（不合格の場合）

## Step 5: 構造化された結果出力

採点結果の表示後、以下の形式で結果を出力する。呼び出し元のスキルがこの結果を利用できるようにするため、**必ずこの形式で出力すること**。

```
## Quiz Result
- **URL**: <記事URL>
- **Score**: <正解数>/<総問題数>
- **Percentage**: <正答率>%
- **Result**: PASS または FAIL
```

## エラー時のガードレール

- 同じ操作が3回以上連続で失敗した場合は、リトライせずエラーを報告して処理を終了する

From TAATHub/claude-code, MIT.

More from TAATHub/claude-code