matlab-generate-grader-assessments
Generate MATLAB Grader assessment item sets. Use when the user asks to create MATLAB Grader assessment items, generate MATLAB assessment materials, build MATLAB homework assessment items, QTI 3 portable assessment items, or mentions "grader assessment items". Produces complete assessment item folders with description, solution, template, tests, Function call blocks, and optional QTI 3 interchange files.
matlab · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add matlab/agent-skills-playground --skill matlab-generate-grader-assessments技能说明
name: matlab-generate-grader-assessments description: Generate MATLAB Grader assessment item sets. Use when the user asks to create MATLAB Grader assessment items, generate MATLAB assessment materials, build MATLAB homework assessment items, QTI 3 portable assessment items, or mentions "grader assessment items". Produces complete assessment item folders with description, solution, template, tests, Function call blocks, and optional QTI 3 interchange files. license: MathWorks BSD-3-Clause (see LICENSE) metadata: author: MathWorks version: "1.0"
MATLAB Grader Assessment Item Generator
Generate complete MATLAB Grader assessment item sets in the current agent session. Each assessment item produces
a subfolder with native artifact files (description, solution, template, tests) ready to paste into
MATLAB Grader. Function assessment items also include function_call.m for MATLAB Grader's
"Code to call your function" area. An optional QTI 3 interchange package can be created for
portability and sharing.
Terminology note: use "assessment item" in user-facing text. "Problem" may still appear only in legacy compatibility identifiers or when explaining older MATLAB Grader terminology.
Input
The user may have provided a learning objective in their request. If they did not, collect it in Step 1.
Reference Files
Before generating any artifacts, read the appropriate reference files from the references/
directory alongside this skill:
references/assessment-item-types.md— assessment item type definitions, class assessments, output structurereferences/assessment-research.md— research-informed formative and summative assessment methodreferences/options-prompt.md— how to generate assessment item optionsreferences/description-prompt.md— how to generate descriptions (by assessment item type)references/solution-prompt.md— how to generate solutions (by assessment item type)references/template-prompt.md— how to generate templates (by assessment item type)references/function-call-prompt.md— how to generate the student call block for Function assessment itemsreferences/tests-prompt.md— how to generate test cases (by assessment item type)references/qti3-prompt.md— how to generate optional QTI 3 item and manifest files
Read references/assessment-item-types.md and references/assessment-research.md now to load the
type definitions and assessment method.
Pipeline Overview
Step 1: Collect inputs (objective, assessment item type, class assessment if applicable, assessment purpose, output format)
Step 2: Generate 4 assessment item options (varied difficulty)
Step 3: User selects which assessment items to develop
Step 4: For each selected assessment item, generate artifacts sequentially
Step 5: Write files to output subfolders and optional QTI 3 package
Step 1: Collect Inputs
If the user provided a learning objective, confirm it. Otherwise, ask for one.
Collect the following one at a time:
1a. Learning Objective
If the user has not already provided one, ask: "What is the learning objective for these MATLAB Grader assessment items?"
1b. Assessment Item Type
Ask the user to choose an assessment item type:
- Script — student submits a .m script; assessed by workspace variables
- Function — student submits a .m function; assessed by input/output values
- Class — student submits a classdef .m file; assessed via instantiation
- Object usage — student submits a .m script that uses a provided class
1c. Class Assessment (only if assessment item type is Class)
If the user chose "Class", ask which aspect to assess:
- Constructor - property assignment (blank: obj.prop = arg lines)
- Constructor - computed property (blank: derived property computation)
- Instance method (blank: method body)
- Constant property (blank: value in properties (Constant) block)
- Operator overloading (blank: overloaded operator method body)
1d. Number of Options
Ask: "How many assessment item options should I generate? (default: 4)" Accept 2-6. Default to 4 if the user just presses enter or says "default".
1e. Output Directory
Ask: "Where should I write the assessment item folders? (default: current directory)" Default to the current working directory. The user can specify a path.
1f. Assessment Purpose
Ask: "Is this assessment primarily formative, summative, or both? (default: summative)" Default to:
- Formative if the user says practice, feedback, homework draft, tutoring, self-check, revision, lab prep, or low-stakes.
- Summative if the user says exam, grade, final submission, high-stakes, or does not specify.
- Both if the user explicitly wants practice and grading reuse.
Use references/assessment-research.md to apply the correct design rules:
- Formative: smaller scope, self-checks, diagnostic test names, and feedback-oriented evidence.
- Summative: objective-aligned independent tests, randomized hardcoding detection, edge cases, and minimal answer-revealing hints.
- Both: formative self-checks plus summative-grade tests.
1g. Optional QTI 3 Export
Ask: "Should I also create QTI 3 interchange files for portability? (default: no)" Default to no unless the user asks for QTI, portability, standards-based assessment items, interchange files, import/export payloads, or sharing between instructional designers.
If enabled, tell the user: "I will create the normal MATLAB Grader files plus a QTI 3 package. The QTI files preserve the prompt, template, function call block when applicable, solution, tests, and metadata for interchange; they do not make a generic QTI player execute MATLAB grading logic."
Step 2: Generate Assessment Item Options
Read references/options-prompt.md to construct the prompt.
Build the system prompt by:
- Starting with the base system prompt from the reference
- Replacing {NUM_OPTIONS} with the user's choice
- Appending the assessment-item-type-spe