vs code 的 agent customizations(智能体自定义)功能通过 skills over mcp 策略,允许开发者在本地或工作区级别直接管理 ai 代理的行为,而无需依赖复杂的远程 mcp 服务器配置。首次授权时,系统会提示用户确认对特定技能或工具的访问权限,确保操作安全;随后,用户可以通过 settings.json 或 ui 界面定义自定义规则、提示词和工具链,实现精细化的 agent 行为控制。

如何首次授权并启用 Agent Customizations
首次启用时,需在 VS Code 设置中开启 ai.agent.customizations.enabled 并配置基础路径。系统会自动扫描工作区内的 .vscode/agent-customizations.json 文件,若不存在则引导创建。授权过程涉及信任检查,确保自定义脚本不被恶意篡改。

{
"ai.agent.customizations": {
"enabled": true,
"path": ".vscode/agent-customizations.json",
"trustLevel": "workspace"
}
}上述配置将自定义范围限定在工作区,避免全局影响。执行后,VS Code 会在状态栏显示“Agent Ready”标识,表示已加载本地策略。
如何通过 Skills over MCP 管理工具链
Skills over MCP 允许将传统 MCP 工具封装为可复用的“技能”,并通过 JSON 描述其输入输出。在 agent-customizations.json 中,可以定义多个 skill 节点,每个节点指定对应的 MCP 端点或本地命令。例如,将 git 操作封装为 git-skill,限制其仅能读取状态而非提交代码。

{
"skills": [
{
"name": "git-skill",
"type": "mcp",
"endpoint": "http://localhost:3000/git",
"permissions": ["read-only"]
}
]
}此配置确保 Agent 只能调用只读 Git 接口,防止意外修改仓库。实际运行时,Agent 会根据权限过滤可用工具列表。
当自定义技能冲突时如何处理优先级
若多个技能定义了相同名称的工具,VS Code 依据 agent-customizations.json 中的 priority 字段决定生效顺序。高优先级技能覆盖低优先级同名工具。例如,若 custom-git 优先级高于内置 git,则 Agent 优先使用自定义逻辑。冲突解决机制不依赖手动干预,而是自动按配置文件排序。


















