ielts-progress-reporter

IELTS 進捗レポーター

エッセイの採点結果が1つあれば、その下書きの出来は分かります。進捗レポートがあれば、実際に上達しているか、どの弱点が繰り返し現れているか、次の1時間をどの学習に充てるべきかが分かります。このスキルは、IELTS 練習用ボルトにすでに蓄積されているフィードバックファイルを読み込み、記録されたバンドスコアとエラータグを、そうした全体像にまとめます。

正しい情報源はフィードバックファイルです。feedback/ 内の各ファイルは、評価基準ごとのバンドスコアとエラータグのリストを含む YAML フロントマター（スキーマは以下を参照）で始まります。このスキルは、すでに記録されている内容を読み取り集計するだけです。下書きを再採点することはなく、まだフィードバックファイルがない受験についてバンドスコアを捏造することもありません。

次の場合に使用します

• 複数回の受験を通じた IELTS Writing の傾向を知りたい場合。
• どのエラーが最も繰り返し現れるか、あるいは弱点が改善しているかを知りたい場合。
• 週次／月次レポート、または全期間の継続的なスナップショットが必要な場合。
• feedback/ フォルダーや _dashboard/ を示し、その要約を求めている場合。

次の場合は使用しないでください

• 1つの下書きを採点してほしい場合 → ielts-writing-task1 または ielts-writing-task2 を使用します。
• 学習計画／スケジュールを立てたい場合 → ielts-learning-planner を使用します。
• フィードバックファイルがまだない場合 → その旨を伝えます。集計するものはありません。元の下書きからバンドスコアを推定してはいけません。

フィードバックのフロントマタースキーマ（読み取り対象）

ボルトの AGENTS.md が正式な定義です。レポートは次の形式に依存します。

フィールド	意味
task	1 または 2
prompt_id, version	受験を識別します。改訂版では prompt_id を共有します
date	ISO 形式の日付で、期間の分類に使用します
band_overall, band_cc, band_lr, band_gra	総合評価 ＋ Coherence/Cohesion、Lexical Resource、Grammatical Range & Accuracy
band_ta（Task 1）／band_tr（Task 2）	最初の評価基準：Task Achievement／Task Response
errors	ボルトで定められた固定タグの語彙から選んだリスト

band_ta と band_tr は、ファイルごとにどちらか一方のみです。レポートでは両者を1つの「最初の評価基準」の傾向線に統合し、Task 1 と Task 2 の進捗を並べて比較できるようにしつつ、それぞれの正しいラベルも維持します。

---

処理手順

ステップ 1 — ボルトとフィードバックファイルを見つける

feedback/ ディレクトリを探します。通常はボルトのルートにあり、attempts/ と _dashboard/ の隣にあります。ユーザーが特定のフォルダーを指定している場合は、それを使用します。.md ファイルを含む feedback/ フォルダーが見つからない場合は、そこで処理を中止して、その旨をユーザーに伝えます。報告するデータはありません。

ステップ 2 — 対象範囲を決める（本当に曖昧な場合のみ確認する）

対応している対象範囲は2つあり、実行時にユーザーが選択します。

• 累積 — これまでのすべての受験を対象とした、継続的なスナップショットです。「全体として自分の現状はどうか」を知るのに適しています。
• 期間 — date に基づいて受験を週次または月次の期間に分類し、推移を示します。「上達しているか」を知るのに適しています。

可能であれば、依頼内容から推測します（「月次レポート」→ 期間／月次、「全体としてどうか」→ 累積）。依頼が本当に不明確な場合にのみ確認してください。ユーザーが指定した場合は、タスク（1、2、または両方）や日付範囲で対象を絞り込むこともできます。

ステップ 3 — 集計スクリプトを実行する

バンドスコアを目視で読み取って集計しないでください。半バンド単位の平均や、数十件にわたるエラー件数は簡単に間違えます。数値に誤りがあれば進捗レポートの価値は失われます。フィードバックファイルのフロントマターをすべて解析し、正確な数値を JSON で返す、同梱のスクリプトを使用してください。

python3 scripts/aggregate_feedback.py --vault <VAULT_ROOT> --mode cumulative
# or, for a trend:
python3 scripts/aggregate_feedback.py --vault <VAULT_ROOT> --mode period --period monthly

便利なフラグ：--feedback-dir <PATH>（feedback/ がボルトのルートにない場合）、--task 1|2|all、--since YYYY-MM-DD、--until YYYY-MM-DD。このスクリプトはサードパーティ依存関係を必要としません。

JSON には、対象件数、評価基準ごとの平均（criterion1 は統合された TA/TR の評価基準）、error_frequency（頻度の高い順）、revision_deltas（複数バージョンがある各プロンプトについて、最初のバージョンから最新バージョンへのバンドスコアの変化）が含まれます。また、期間モードでは、同じ数値を periods[] の各期間に分けて表示します。

Step 4 — 古いエラーの間隔を空けた再確認を1つ行う

references/spaced-error-reprobes.md を読み、_dashboard/ielts-reprobe-ledger.yaml を管理します。存在しない場合は、記録済みのフィードバックから初期データを作成します。 再確認の期限を過ぎた項目があれば、優先項目を選ぶ前に、期限を過ぎた中で最も古いものをちょうど1つ含めます。最近のエラーのほうが頻繁に現れるという理由だけで、古いエラーを最近のエラーに置き換えてはいけません。

Step 5 — レポートを作成する

JSON を以下のテンプレートに当てはめます。数値はスクリプトが担当します。あなたの役割は、最も弱い評価基準、傾向の方向、最も根強いエラー、優先事項を示して解釈することです。表示するバンドは IELTS の方式に従って半バンド単位に丸めます（平均が 6.25 の場合、受験者が取得できない架空の半バンドではなく、「6前後」と表します）。受験回数が2回または3回しかない場合は、ノイズを過剰に読み取らず、傾向を判断するにはまだ十分ではないと明記します。

Task 1 の受験回については、ボルトのデータ精度ルールに従ってください。バンドには評価可能な内容がすでに反映されているため、記録どおりに報告し、ここでデータ精度を再検討しないでください。

Step 6 — レポートをボルトに書き込む

履歴を保持できるよう、_dashboard/ に日付入りのファイルとして書き込みます。例：_dashboard/progress-2026-06-24.md（累積）または _dashboard/progress-2026-06.md（月次）。既存の日付入りレポートは上書きしないでください。完全に一致するファイル名が存在する場合は、短いサフィックスを付けるか、ユーザーに確認します。ボルトの更新され続ける _dashboard/writing-progress.md（存在する場合）は Dataview で生成されます。ユーザーから明示的な更新依頼がない限り、変更しないでください。

ファイルを書き込んだ後、チャットでユーザーに3～4行の要約を伝えます。現在の状況、傾向の方向、繰り返し現れる主なエラー、最も効果の高い次の重点項目を含めます。ファイルの保存先も伝えます。

---

レポートの構成

このテンプレートを使用します。データのないセクション（例：まだ修正履歴がない場合）は、水増しせずに省略します。

# IELTS Writing Progress — <scope label, e.g. "Cumulative as of 2026-06-24" or "May 2026">

**Attempts covered:** <n> (<by task>) across <distinct_prompts> prompts
**Date range:** <earliest> → <latest>

## Band summary
| Criterion | Average | Read as |
|-----------|--------:|---------|
| Task Achievement / Response | x.x | ~band |
| Coherence & Cohesion | x.x | ~band |
| Lexical Resource | x.x | ~band |
| Grammatical Range & Accuracy | x.x | ~band |
| **Overall** | x.x | ~band |

One or two sentences: which criterion is the weakest anchor, which is the strength.

## Trend            
| Period | Attempts | Overall | TA/TR | CC | LR | GRA |
|--------|---------:|--------:|------:|---:|---:|----:|
| ...    | ...      | ...     | ...   | ...| ...| ... |

One or two sentences on direction (improving / flat / noisy), with the honesty caveat if the sample is small.

## Recurring errors
| Error tag | Count |
|-----------|------:|
| ...       | ...   |

Name the 2–3 most persistent tags and what they signal. Link to the vault's error notes where useful, e.g. [[errors/article]].

## Revision gains          
| Prompt | v→v | Overall change |
|--------|-----|---------------:|
| t2-001 | 1→2 | +0.5 |

Did revising actually move the score? One sentence.

## Old error due now       
**Error:** <tag>
**Fresh cue:** <one new sentence or micro-task>

Answer without opening the old correction. Require production or correction plus a
brief reason; recognition and rule naming do not pass.

## Top 3 priorities for the next stretch
1. ...
2. ...
3. ...

優先事項はデータに基づいて決めます。最も弱い評価基準、最も頻度の高いエラータグ、横ばいまたは低下しているスキルを取り上げます。具体的な項目を少数に絞ってください。修正項目を10個も並べたレポートは読まれません。

引き継ぎ

• 新しいドラフトに取り組む場合 → ielts-writing-task1 または ielts-writing-task2
• レポートをスケジュールにする場合 → ielts-learning-planner
• 目標を絞った語彙練習を作成する場合 → ielts-vocabulary-builder