unity-bookmark
GitHub管理Unity场景视图书签,支持保存当前相机视角与选中对象、快速跳转至已存位置、列出或删除书签。适用于保存机位、恢复视角或在已标记场景位置间导航。
Trigger Scenarios
Install
npx skills add Besty0728/Unity-Skills --skill unity-bookmark -g -y
SKILL.md
Frontmatter
{
"name": "unity-bookmark",
"description": "Manage Scene View bookmarks — save the current selection plus camera pivot\/rotation\/size under a name, then jump back later. Use when saving or restoring Scene View viewpoints, bookmarking a camera angle, or navigating between saved scene locations, even if the user just says \"标记视角\" or \"存个机位\". 管理 Scene View 书签(以命名方式保存当前选中对象与相机 pivot\/旋转\/大小,之后快速跳回);当用户要保存或恢复场景视角、收藏某个机位、或在已存位置间切换时使用。"
}
Bookmark Skills
Save and recall Scene View camera positions.
Guardrails
Operating Mode (v1.9 three-tier):
- Approval (default): 只有
bookmark_list标SkillMode.SemiAuto(纯读),Approval 模式下可直接执行,无需走 grant 协议。bookmark_set(Operation.Create,写入书签表)与bookmark_goto(Operation.Execute,改动编辑器选中对象与 Scene View 视角)都有副作用,走默认SkillMode.FullAuto,Approval 模式下需 grant。与workflow模块文档保持一致(以 C#WorkflowSkills.cs的特性标注为准)。 - Auto / Bypass: SemiAuto and FullAuto run directly.
- Auto-forbidden in this module:
bookmark_delete(SkillOperation.Delete). Reachable only under Bypass mode or via a user-managed Allowlist entry; the grant flow returnsMODE_FORBIDDEN. Bookmarks themselves are in-memory only —bookmark_deleteonly removes the entry, no asset I/O.
DO NOT (common hallucinations):
bookmark_savedoes not exist → usebookmark_setbookmark_load/bookmark_restoredo not exist → usebookmark_gotobookmark_removedoes not exist → usebookmark_delete- Bookmarks save Scene View position + current selection, not scene state
Routing:
- For workflow snapshots (object state undo) → use
workflowmodule - For scene save/load → use
scenemodule
Skills
bookmark_set
Save current Scene View camera position as a bookmark. Parameters:
bookmarkName(string): Bookmark name.
bookmark_goto
Move Scene View camera to a saved bookmark. Parameters:
bookmarkName(string): Bookmark name.
bookmark_list
List all saved bookmarks. Parameters: None.
bookmark_delete
Delete a saved bookmark. Parameters:
bookmarkName(string): Bookmark name.
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.
Version History
-
e49379b
Current 2026-07-31 06:53
v2.4.0:变更操作模式逻辑,bookmark_set和bookmark_goto升级为FullAuto(需grant),仅bookmark_list保持SemiAuto;修复旧版文档错误描述。
- ec9f870 2026-07-05 14:39


