LIghtJUNction

oni-mcp-quick-demo

当用户要求快速演示、展示 ONI MCP 能力、功能介绍、capability showcase、试玩 MCP 工具、看看 MCP 能做什么,或说出"演示一下""快速展示""showcase"时使用。执行一条预定义的 10 步快速演示流程,覆盖虚拟文件、视图切换、复制人管理、日程、消毒、截图、工具流程发现、实时世界分析、建造挖掘预检和规划功能。目标是快速、低确认、直观地向用户展示 MCP 工具链能力。

LIghtJUNction 21 11 Updated 3mo ago
GitHub

Install

npx skillscat add lightjunction/onimods/oni-mcp-quick-demo

Install via the SkillsCat registry.

SKILL.md

ONI MCP 快速能力演示

执行原则

  • 快速执行:不要逐条询问确认,按顺序直接调用工具
  • 边执行边解说:每完成一步,用一句话向用户说明刚才演示了什么
  • 错误继续:单步失败不阻断后续步骤,记录失败原因并继续演示
  • 批量读取:独立的读取调用合并为 server_control domain=batch action=call_many 以减少往返
  • 默认不破坏存档:写入/执行能力优先用 dryRun、apply=false 或只读预览;只有用户明确要求真实演示时才改名、改日程、挖掘或建造。
  • 工具发现:示例工具名可能随服务端演进;执行前若当前工具列表没有该工具,用 server_control domain=catalog action=search query=<action> 确认 schema。

10 步演示流程

按顺序执行。每步完成后简要汇报,然后立即进入下一步。

Step 1 — 虚拟文件入口

world_editor command=ls path=/active/

解说:已通过虚拟文件入口列出当前存档结构。每次调用的 taskDescription 会自动显示在玩家鼠标附近。

Step 2 — 视图切换

navigation_control action=switch_view view=temperature screenshot=true
navigation_control action=switch_view view=oxygen screenshot=true
navigation_control action=switch_view view=none

解说:已快速切换温度视图、氧气视图并截图,最后切回普通视图。

Step 3 — 复制人管理/重命名预览

先批量读取:

server_control domain=batch action=call_many responseMode=summary items=[
  { t: colony_control, a: { domain: read, action: dupes } },
  { t: colony_control, a: { domain: management, kind: schedule, action: list } }
]

演示批量重命名预览,不直接改名:

dupes_control domain=command action=auto_rename style=cn_job apply=false

解说:已读取复制人列表,并预览按岗位自动命名的结果;没有修改存档。

Step 4 — 日程安排

使用 Step 3 中读取的 colony_control domain=management kind=schedule action=list 结果,演示日程修改预检:

colony_control domain=management kind=schedule action=set_block schedule=<日程名> hour=0 group=Sleep dryRun=true

解说:已预检把第一个日程的第 1 时段设为睡眠,演示了日程编辑能力;没有应用修改。

如用户要求真实演示,再用 colony_control domain=management kind=schedule action=optimize apply=false 预览轮班制,确认后才 apply=true。

Step 5 — 自动消毒策略能力

server_control domain=catalog action=search query="auto disinfect" detail=brief

解说:已展示可发现并调用全局自动消毒策略工具;默认演示不修改存档。如用户要求真实开局设置,再调用 colony_control domain=diagnostic action=set_auto_disinfect disabled=true applyNow=true confirm=true。

Step 6 — 截图分析

navigation_control action=screenshot

解说:已捕获当前游戏画面,可结合视觉进行后续分析。

Step 7 — 工具流程发现

server_control domain=catalog action=guide goal="build and power an electrolyzer" detail=brief

解说:已根据建造并供电电解器这一目标,获取推荐资源、工具链和安全执行流程。

Step 8 — 实时世界元素分析

read_control domain=world action=element_summary

解说:已只读汇总当前世界的元素质量与温度,展示实时存档分析能力。

Step 9 — 建造/挖掘预检

world_editor command=read path=/active/map/viewport.md
building_control domain=planning action=placement_candidates prefabId=Tile x1=<viewport.x1> y1=<viewport.y1> x2=<viewport.x2> y2=<viewport.y2> limit=3
building_control domain=planning action=preview prefabId=Tile material=auto x=<bestCandidate.x> y=<bestCandidate.y> dryRun=true
orders_control domain=area action=dig x1=<viewport.x1> y1=<viewport.y1> x2=<viewport.x1+2> y2=<viewport.y1+2> dryRun=true detail=true

解说:已读取虚拟地图,并分别预检铺砖与小范围挖掘;没有下达真实命令。

Step 10 — 规划功能

game_control domain=ui uiDomain=edit_mark action=list limit=3

解说:已读取游戏内编辑标记/规划请求列表。玩家可在游戏内框选区域并输入计划,agent 会在此读取并转化为可执行方案。

收尾

10 步全部完成后,向用户总结:

  1. 已展示的 10 项能力清单(每项一句话)
  2. 哪些步骤成功/失败
  3. 一句话引导用户下一步可以做什么(如"需要我实际执行建造或规划吗?")

保持总结在 5 句话以内。