microsoft/tool-rename-deprecation

Was macht tool-rename-deprecation?

Stelle sicher, dass umbenannte integrierte Tool-Referenzen die Abwärtskompatibilität wahren. Verwende dies beim Umbenennen eines toolReferenceName, tool set referenceName oder eines anderen Tool-Identifikators. Führe dies bei JEDWEDER Änderung am Tool-Registrierungscode aus. Deckt legacyToolReferenceFullNames für Tools und legacyFullNames für Tool-Sets ab.

Übersicht

Wenn du ein integriertes Tool oder ein Tool-Set umbenennst, müssen ältere Referenzen auf die alten Namen weiterhin funktionieren. Dieses Skill bietet eine Anleitung, um:

• legacyToolReferenceFullNames in der Tool-Registrierung zu setzen
• legacyFullNames in der Tool-Set-Registrierung zu setzen
• Zu überprüfen, dass alle alten Referenzen noch aufgelöst werden können

Verwendung

Führe dieses Skill bei jeder Änderung aus, die einen Tool-Identifikator betrifft.

Beispiel: Tool umbenennen

Ändere in der Tool-Definition:

@tool(
    referenceName="neuer-tool-name",
    legacyToolReferenceFullNames=["alter-tool-name"]
)
async def mein_neues_tool():
    ...

Beispiel: Tool-Set umbenennen

tool_set(
    name="neuer-tool-set-name",
    legacyFullNames=["alter-tool-set-name"]
)

Wichtige Hinweise

• Platzhalter (*) können in legacyToolReferenceFullNames verwendet werden, um mehrere ältere Versionen abzudecken (z. B. "alter-name-v1.*").
• Teste die Abwärtskompatibilität immer, indem du Aufrufe mit den alten Namen gegen deine Pipeline ausführst.
• CI/CD: Integriere dieses Skill als Schritt in deiner CI/CD-Pipeline, um Brüche vor der Bereitstellung zu erkennen.

Unterstützte Plattformen

Dieses Skill ist für den Einsatz mit:

• Claude Code
• Cursor
• Codex

...sowie anderen KI-Agenten, die Tool-Registrierungen verwalten.

Fehlerbehebung

Problem: Alte Referenz wird nicht aufgelöst

Stelle sicher, dass:

1. Der Legacy-Name genau dem ursprünglichen Namen entspricht (inkl. Groß-/Kleinschreibung).
2. Die Legacy-Namen im selben Registrierungsdatei wie die Neudefinition eingetragen sind.
3. Kein anderer Tool- oder Tool-Set-Eintrag den gleichen Legacy-Namen verwendet (Konflikte vermeiden).

Problem: Platzhalter funktionieren nicht

Platzhalter werden nur für die Suche nach Legacy-Namen unterstützt, nicht für exakte Übereinstimmungen. Teste mit * am Ende des Namens.

Siehe auch

• Offizielle Dokumentation zur Tool-Registrierung
• Beispiele zur Abwärtskompatibilität