unity-history

このモジュールのスキルを呼び出す前に： 名前や説明から推測したパラメーターを使ってスキルを呼び出そうとしている場合は、いったん中止してください。まずこのファイルを読むか、GET /skills/recommend?includeSchema=true でスキーマを取得してください。recommend/schema からすでにパラメーター定義を取得している場合は、そのまま dryRun に進めます。

トリガー

• 取り消し履歴の確認または移動
• 取り消し／やり直しの実行
• 変更内容の監査

履歴スキル

Unity Editor の取り消し／やり直し履歴を管理します。

動作モード

このモジュールの history_get_current（読み取り専用）は SkillMode.SemiAuto であり、いずれのモードでもそのまま実行できます。history_undo／history_redo はシーンの状態を変更するため、デフォルトの SkillMode.FullAuto（Operation=Execute）であり、Approval モードでは grant が必要です。NeverInSemi の高リスクスキルは含まれていません。

history_undo／history_redo は Unity 独自のネイティブな Undo/Redo スタックを再生します。その内容は workflow モジュールのタスクスナップショットのように書き込みカテゴリで分類できないため、workflow_undo_task／workflow_session_undo とは異なり、ペイロードレベルの SURFACE_EXCLUDED チェックはありません。

禁止事項（よくある誤った想定）：

• history_list／history_get は存在しません → 現在の取り消しグループには history_get_current を使用してください
• history_clear は存在しません → API から Unity の取り消し履歴を消去することはできません
• history_save は存在しません → 取り消し履歴は Unity によって自動的に管理されます

振り分け：

• 単純な取り消し／やり直しには → history_undo／history_redo（このモジュール）、または editor_undo／editor_redo
• 永続的なタスク単位の取り消しには → workflow モジュールを使用してください
• 会話単位の取り消しには → workflow モジュールの workflow_session_undo を使用してください

スキル

history_undo

最後の操作（または複数の操作）を取り消します。

パラメーター	型	必須	デフォルト	説明
steps	int	いいえ	1	実行する取り消し手順の数

戻り値： { success, undoneSteps }

history_redo

最後に取り消した操作（または複数の操作）をやり直します。

パラメーター	型	必須	デフォルト	説明
steps	int	いいえ	1	実行するやり直し手順の数

戻り値： { success, redoneSteps }

history_get_current

現在の取り消しグループの名前を取得します。

パラメーターはありません。

戻り値： { success, currentGroup, groupIndex }

正確なシグネチャ

正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく GET /skills/schema または unity_skills.get_skill_schema() で定義されています。