unity-bookmark
GitHub管理Unity场景视图的书签功能，支持保存、恢复、列出和删除相机视角及选中状态。提供标准化API以辅助3D场景导航与机位记忆。
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 and saved viewpoints"
}
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Saving or restoring Scene View viewpoints
- Bookmarking camera angles
- Navigating saved scene locations
- 保存或恢复场景视角、收藏机位、在已存位置间切换
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
-
5ee8388
Current 2026-08-17 04:10
根SKILL.md精简至6.2KB，协议细节移至references目录；新增SKILL_GUIDE.md及manual-* advisory模块；更新版本锚点至2.6.0并添加CHANGELOG条目。
-
25d511e
2026-08-13 09:13
压缩描述至约5191字符，并将路由说明移至Triggers章节
-
e49379b
2026-07-31 06:53
v2.4.0：变更操作模式逻辑，bookmark_set和bookmark_goto升级为FullAuto（需grant），仅bookmark_list保持SemiAuto；修复旧版文档错误描述。
- ec9f870 2026-07-05 14:39
