hkdse-ict-report

Generate HKDSE ICT class and per-student DOCX reports from AI-graded JSON data.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AKCqhzdy/dse-subject-grading --skill hkdse-ict-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hkdse-ict-report
Source: https://github.com/AKCqhzdy/dse-subject-grading/tree/main/skills/hkdse-ict-report
Command: npx skills add https://github.com/AKCqhzdy/dse-subject-grading --skill hkdse-ict-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, matplotlib, python-docx, Pillow, numpy, pydantic.

What problem does it solve?

本 Skill 專為 HKDSE ICT 考試的成績分析與報告製作而設計,能自動根據 AI 分級的 JSON 數據產出班級與個別學生的 DOCX 報告,並嵌入原始學生作答影像。

Core Features & Use Cases

  • 以 AI 分級 JSON 作為輸入,完成班級成績概覽、逐生分析與評語、以及 DOCX 報告組裝。
  • 報告內容以繁體中文呈現,只有技術識別符與檔名使用英文,便於跨系統整合。
  • 支援嵌入學生答題影像、產出圖表與成績分佈分析,適用於班級層面與個別學生的回饋。
  • 常見情境包括:產出班級綜合報告、為每位學生生成個別回饋與改進建議、以及分析等級分佈與題目表現。

Quick Start

Run the workflow to convert AI-graded JSON into both class-level and per-student DOCX reports.

Frequently Asked Questions about hkdse-ict-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate DOCX class reports from AI-graded JSON data?

You can generate DOCX class reports by loading AI-graded JSON data into the workflow, which orchestrates end-to-end generation of class-level and per-student reports with embedded student answer images and performance charts.

Can I embed original student answer images into individual DOCX feedback reports?

Yes, the report generation process embeds original student answer images directly into the per-student DOCX feedback reports alongside level-based performance analysis and individual comments.

What Python environment do I need for automated HKDSE ICT report generation?

Automated HKDSE ICT report generation requires Python 3.12+ along with pandas, matplotlib, python-docx, Pillow, numpy, and pydantic libraries to process grading results and assemble DOCX files.

How does data visualization work for class-level performance analysis in DOCX reports?

Data visualization for class-level performance analysis uses matplotlib and numpy to generate charts from AI-graded JSON data, which are then embedded into the final DOCX reports to show grade distribution and question performance.

Does the report generation workflow support Traditional Chinese text output?

Yes, the report content is presented in Traditional Chinese, while only technical identifiers and filenames use English to facilitate cross-system integration.

What input file structure is required for HKDSE ICT level-based performance analysis?

Level-based performance analysis requires AI-graded JSON inputs located in the output/{year}/ directory and rubric configuration files in rubric/{grade_year}/level_division.json to process grading results accurately.