Capability Profiles 是 senjuwoo/ultimate-ai-starter-bundle 中的一项技能,核心思路是:连接的 MCP 服务器数量应当是“能完成任务的最少数量”,并且随项目变化。该包把其余服务器作为 profile 停放,直到有任务需要时才启用。
用途
该技能用于按任务选择并启用合适的 MCP 服务器配置(profile),覆盖游戏制作与模组、Web/UI 与 3D 资产构建、发布准备、技能与 MCP 组合、任务 profile 选择以及故障诊断等场景。它回答的是“该打开哪个服务器”的问题;至于“已有能力与自行编写之间如何取舍、所选工具失败后怎么办”,则由 capability-routing 处理。
主要能力
- 提示优先的任务组合:用户描述结果而非服务器或 profile 名称。技能根据意图和已验证的项目证据,从 references/task-recipes.json 选择匹配条目,只加载与阶段相关的技能,并为真实存在的额外阶段组合配方(例如 game-unity + assets-3d + publication),而不是加载所有引擎。
- 通过工具发现解析已安装的包。共享的 profile 写入器消费同一份配方数据,不在 hook 中维护第二份映射。
- 提供 Set-McpProfile.ps1 脚本,支持 -Plan(只读 JSON)、-Providers、-Auto、-Unpark、-Enable、-Disable、-List、-Detect、-Park -CheckOnly 等参数。
- 提供 Migrate-HermesProfiles.ps1 用于 Hermes 原生拓扑的迁移(支持 dry-run 与 -Apply)。
- 提供 Measure-McpSchemaCost.ps1 测量已公布的紧凑 UTF-8 schema 字节数。
- 提供 Test-McpHandshake.ps1 进行传输层冒烟测试。
使用方式
普通任务接线保持项目范围,不触碰个人或非自有条目。只选择当前 provider。对于已授权的实现任务,应自行完成受支持的范围化设置,而不是把 profile 选择当作作业交给用户。未知任务会失败,机器级能力仍需显式 -Global。
常用命令示例:
TOOLS\Set-McpProfile.ps1 -Task game-unity,assets-3d -Path <owned-project> -Plan TOOLS\Set-McpProfile.ps1 -Task game-unity,assets-3d -Path <owned-project> -Providers Codex TOOLS\Set-McpProfile.ps1 -Auto -Path <project> TOOLS\Set-McpProfile.ps1 -Unpark melty -Path <project> TOOLS\Set-McpProfile.ps1 -Enable github -Path <project> TOOLS\Set-McpProfile.ps1 -List TOOLS\Set-McpProfile.ps1 -Detect -Path <project> TOOLS\Set-McpProfile.ps1 -Disable code-intel TOOLS\Migrate-HermesProfiles.ps1 TOOLS\Migrate-HermesProfiles.ps1 -Apply
-Auto 仅在项目显示其标记且机器满足要求时才写入 profile;无法运行的 profile 会被跳过并打印原因。
已安装不等于已启用:已安装指文件存在于磁盘;已配置指 provider 条目存在;已激活指 provider 接受其范围/信任并成功连接;可调用指所需工具通过了过滤和权限。不能把其中任一状态当作下一状态的证明。
适用场景
- 游戏制作与模组:Skyrim、Roblox、Saints Row、Unity、Godot、Blender 等。
- Web/UI 与 3D 资产构建。
- 发布准备(注意:发布准备不授权公开发布)。
- 技能与 MCP 组合、任务 profile 选择。
- 故障诊断。
限制
- 新游戏创建与对打包游戏进行模组是不同路线;已安装的 Unity 游戏不是 Unity 编辑器项目。
- 本包中 Unreal 没有经过审计的编辑器 MCP:应发现实际的引擎构建/烹饪/打包工具,使用现有原生/编辑器能力,而不是发明桥接。
- Melty 为选择性加入,仅在用户要求融合两个游戏或在 Melty 平台发布时适用;普通模组位于自己的项目文件夹,绝不默认使用 Melty。
- Universal Modder 是本地 CLI/技能,不是免费的本地模组 MCP;其上游 fal MCP 是单独认证的付费资产服务。
- 云 profile(Supabase)已在 7.9.7 中撤回,因为它是唯一需要账户和个人访问令牌的 profile,与本包默认的免费、本地、无密钥、无需注册相悖。
- Hermes 退出时会重写其配置,因此应用运行时写入 profile 配置不安全;Migrate-HermesProfiles.ps1 -Apply 在该状态下会拒绝执行。
- Kimi 没有建立项目范围;除非显式 -Global,否则跳过。
- 测量脚本的 bytes/4 是 schema token 估算,不是实际分词、提示使用量、缓存 token 或计费。
- 名为 ReadOnly 的工具不是操作系统安全边界:仍需检查实际操作、目标和权限。
- 关于具体价格、收费、平台支持范围等更多细节,资料暂未提供。