Skip to main content
Glama

scobees_copy_aufgabe

Copies an existing task into an outline or another learning path or subject, preserving worksheet, attachments, solutions and settings; optionally set the name, description and worksheet replacements.

Instructions

Kopiert eine bestehende Aufgabe in eine Gliederung oder direkt in einen Lernpfad – auch in einen anderen Lernpfad oder ein anderes Fach. scobees kopiert dabei Beschreibung, Arbeitsblatt, Anhänge, Musterlösungen, Kachelbild und alle Einstellungen; die Kopie ist danach unabhängig vom Original. Optional gleich anpassen: name, description_html und ersetzungen fürs Arbeitsblatt (wie scobees_patch_arbeitsblatt, alles oder nichts – passt eine Ersetzung nicht genau einmal, wird gar nicht erst kopiert). Für übernommene Aufgaben immer dieses Werkzeug nehmen statt Lesen und Neu-Anlegen: nichts wird abgeschrieben, keine Datei neu hochgeladen. Unteraufgaben einer Wahlpflichtaufgabe lassen sich nicht kopieren, und eine Wahlpflichtaufgabe ist kein Ziel (erst in die Gliederung kopieren, dann mit scobees_move hineinschieben).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>",
      "parent_id": "<parent_id>"
    },
    "name": "scobees_copy_aufgabe"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesID der Aufgabe, die kopiert wird (LI-…)
nameNoNeuer Name der Kopie, optional
parent_idYesZiel: Gliederung oder Lernpfad (LI-…)
sort_orderNoPosition im Ziel, 0-basiert; ohne Angabe ans Ende
ersetzungenNoErsetzungen im Arbeitsblatt der Kopie; jedes „alt“ muss im Markdown der Quelle genau einmal vorkommen.
description_htmlNoNeue Beschreibung der Kopie (HTML), optional

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.18

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden and does so: it enumerates exactly what is copied (Beschreibung, Arbeitsblatt, Anhänge, Musterlösungen, Kachelbild, alle Einstellungen), states the copy becomes independent of the original, and discloses the all-or-nothing atomicity of ersetzungen. It also flags structural limitations that would otherwise cause silent failures.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the core copy action and destination before the details, with no filler sentences. It is a dense single paragraph, though, so the constraint and fallback clauses are easy to skim past.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 6-parameter mutation with no annotations and no output schema, the description covers sources, destinations, copied content, restrictions and alternatives thoroughly. The one gap is what the call returns (e.g., the new ID or the created task), which an agent must discover empirically.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3; the description goes further by framing name, description_html and ersetzungen as optional in-place adaptations and by spelling out the all-or-nothing replacement rule. It adds little about sort_order or the parent_id semantics, which the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Kopiert eine bestehende Aufgabe") plus both possible destinations (Gliederung, Lernpfad), and even calls out the cross-Lernpfad/cross-Fach case. An agent can distinguish this from create_aufgabe or update_aufgabe on the description alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly prescribes this tool over the alternative workflow ("statt Lesen und Neu-Anlegen"), and gives a concrete fallback procedure for the Wahlpflichtaufgabe case (copy into the Gliederung first, then scobees_move). It also states a hard exclusion for Unteraufgaben einer Wahlpflichtaufgabe.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.