Tw Edu Assessment Theory — Development skill for Claude Code

tw-edu-assessment-theory

這是給 Claude 用的教育測驗與評量 Skill，內容以台灣情境為主。 它讓 Claude 懂試題分析（難度 P、鑑別度 D、誘答力、信度），也能讀會考、學測、分科、統測的官方統計報表， 另外附命題理論和審題檢核表，出卷、改卷、準備教檢都用得到。

能做什麼

情境	你可以這樣問	Claude 會做的事
準備教師資格考	「這題教檢評量題答案為什麼是 C？」	依考點整理解題，指出常見陷阱（OF／FOR／AS、常模／標準參照、多元評量）
分析自己班的考卷	「幫我算這次段考的鑑別度」＋上傳作答 CSV	跑 item_analysis.py，算出 P、D、選項分布、KR-20，並給每題保留／修改／刪除建議
判斷考卷品質	「這份考卷出得好不好？」	看難度配置、鑑別度分布、誘答選項是否有效
出卷、命題	「幫我出一份八年級數學段考，附雙向細目表」	依命題理論做雙向細目表、配置難度、設計誘答選項，最後用審題檢核表自檢
讀大型考試報表	「分析 115 會考數學的試題分析報告」	解析心測中心、大考中心、技專校院入學測驗中心公告的 PDF／xlsx，找出負鑑別題和問題選項

安裝

Claude Code

# 方法一：直接 clone 到個人 skills 目錄
git clone https://github.com/u8961310/tw-edu-assessment-theory.git ~/.claude/skills/tw-edu-assessment-theory

# 方法二：用 skills CLI
npx skills add u8961310/tw-edu-assessment-theory

裝好後重開 Claude Code 就會自動載入，不需要手動呼叫。

claude.ai（網頁版／桌面版）

1. 在本頁按 Code → Download ZIP 下載
2. 到 claude.ai 的 設定 → 功能（Capabilities），確認「程式碼執行」已開啟
3. 在 Skills 區塊上傳 ZIP

Python 套件（只有分析報表才需要）

pip install -r requirements.txt

分析自己班的作答資料（`item_analysis.py`）只用 Python 標準函式庫，不必裝任何套件。

怎麼用

Skill 會在對話提到相關關鍵字時自動啟用，例如「鑑別度」「難度」「試題分析」「誘答力」「信度」「雙向細目表」「會考試題分析」「出卷」等。 你照平常說話就好，不需要記指令。

範例一：分析班上段考

準備兩個 CSV 檔（格式見 `examples/`）：

**responses.csv**：第一欄是學號，後面每欄一題，首列是題號。選擇題填學生選的字母，非選擇題填得分。

學號,1,2,3,4,5,6
S01,A,C,B,D,A,4
S02,A,C,B,D,B,5

**key.csv**：一列，依題號順序填正解；非選擇題填 `max=滿分`。

A,C,B,D,A,max=5

在 Claude 裡上傳這兩個檔，說「幫我做試題分析」就可以。也可以自己跑：

python scripts/item_analysis.py examples/responses.csv examples/key.csv
# 高低分組預設取 27%，小班可調：--group 0.33

輸出會列出每題的 P、D、高低分組答對率、Ebel 判讀、處置建議和各選項的高／低分組選答比例，最後附 KR-20 信度。

`examples/` 裡的資料是虛構的，只用來示範格式。

範例二：讀官方大型考試報表

先到官方網站下載報表（本 repo 不附原始檔）：

考試	來源	腳本
國中教育會考	心測中心 各科試題分析 PDF	cap_parse_items.py → cap_parse_meta.py → cap_analyze_items.py
學測、分科	大考中心 統計圖表 xls	xls2xlsx.py（選用）→ `ceec_analy