开发与工程 ✓ Microsoft · 官方

VS Code Agent 定制助手

帮助创建、修复和排查 VS Code Agent 定制文件及其加载问题。

55/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 194k
最近更新
11 天前
License
MIT
vscodeagent-customizationcustom-agentsprompt-files
+3instructions-filesyaml-frontmatterapplyto-patterns

这个 Skill 能做什么,适合哪些场景?

这是 Visual Studio Code Code - OSS 仓库中的工作流技能,专门处理 Agent 定制文件。它覆盖 .instructions.md、.prompt.md、.agent.md、SKILL.md、copilot-instructions.md 和 AGENTS.md 的创建、更新、审查、修复与调试。它还帮助排查定制内容为何未被加载或调用,并指导 applyTo 模式、工具限制、自定义 Agent 工作模式和 YAML frontmatter 的配置。该技能不适用于一般编程问题、运行时调试、MCP 服务器配置或 VS Code 扩展开发。

读取并写入 Agent 定制文件;根据用户需求选择 agent instructions、File Instructions、Prompts、Hooks、Custom Agents 或 Skills 等定制类型;通过提问澄清需求;在需要时使用只读子代理探索代码库;检查文件位置、YAML frontmatter 语法和 description 字段;解释 applyTo 模式、工具限制、定制 Agent、提示词与技能之间的选择。对于已知模式下的单文件创建或快速 YAML 修复,它建议直接编辑文件而不调用本技能。

适合
  • 开发者希望为整个项目保存始终生效的编码偏好,需要创建或修改 copilot-instructions.md 或 AGENTS.md。
  • 团队成员发现某个 .instructions.md 没有生效,需要检查文件位置、description 或 applyTo 模式。
  • 用户想创建一个带工具限制或上下文隔离的自定义 Agent,需要在 Custom Agent、Skill 和 Prompt 之间做选择。
  • 用户要把领域知识打包为按需工作流,需要规划 SKILL.md 及其参考资料、脚本或模板组织方式。
  • 用户遇到 YAML frontmatter 静默失效,需要修复字段、缩进、引号或 name 与目录名不匹配的问题。

如何安装这个 Skill?

使用前请注意
  • 创建步骤涉及读写定制文件和可能执行钩子命令;使用前应对目标路径、工具权限、命令内容和备份/回滚方案进行人工确认。
  • 参考文档通过外部官方链接补充,离线或受限网络环境下可能无法完成全部验证。
  • 技能声明的触发与文件发现依赖宿主代理的语义识别,可能出现漏触发或误触发。
开始前你需要
Agent 需要具备
  • 本地文件系统

源材料没有提供该技能集合的安装命令。该技能在仓库中的路径是 extensions/copilot/assets/prompts/skills/agent-customization/SKILL.md。SKILL.md 列出的技能目录位置包括 .github/skills/<name>/、.agents/skills/<name>/ 和 .claude/skills/<name>/;将其用于其他环境时,应遵循目标 Agent Skills 客户端的安装方式。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/vscode.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/extensions/copilot/assets/prompts/skills/agent-customization" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 检查为什么我的 .instructions.md 没有生效,并修复 applyTo 模式。
  • 为项目创建一个自定义 Agent,限制可用工具并包含正确的 YAML frontmatter。

向支持该技能的 Agent 描述具体定制任务,例如:“检查为什么我的 .instructions.md 没有生效,并修复 applyTo 模式。”也可以请求:“为项目创建一个自定义 Agent,限制可用工具并包含正确的 YAML frontmatter。”如果只是根据已知模式创建单个文件,或快速修复 YAML frontmatter,应直接编辑文件,因为该技能明确将这些列为无需调用技能的单一操作。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖多种 VS Code Agent 定制文件,而不局限于单一文件类型。
  • 提供从范围确定、原语选择、文件创建到验证的完整创建流程。
  • 明确区分 Instructions、Skills、Prompts、Hooks 和 Custom Agents 的适用场景。
  • 包含 applyTo、description、YAML frontmatter 和文件位置等常见故障点的具体检查方向。
局限
  • 源材料没有提供独立的测试套件、成功率或兼容性验证结果。
  • 源材料没有说明该技能集合的具体安装命令。
  • 技能依赖文件系统读写、提问工具和子代理等运行环境能力;不具备这些能力的客户端需要适配。
  • 它明确排除一般编程问题、运行时错误诊断、MCP 配置和 VS Code 扩展开发。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
VS Code Agent 定制助手 本页 ✓ Microsoft · 官方 55 · 谨慎使用 ★ 194k 11 天前 MIT
可复用提示词创建器 ✓ Microsoft · 官方 45 · 不推荐 ★ 194k 11 天前 MIT
代码库初始化定制器 ✓ Microsoft · 官方 45 · 不推荐 ★ 194k 11 天前 MIT
SkillCheck Free 64 · 推荐 ★ 41 14 天前 MIT
Claude Code Agent 开发指南 ✓ Anthropic · 官方 54 · 谨慎使用 ★ 38k 11 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
55/ 100 五分制 2.8 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全16 / 25 · 3.2/5

技能明确限制适用范围,建议使用只读子代理探索,并要求确认工作区或用户范围;但创建流程仍允许直接读写文件,未明确逐项用户确认、敏感数据流、回滚机制或外部工具权限,因此扣分。

2可靠稳定8 / 20 · 2.0/5

决策表、创建步骤、边界和常见陷阱较一致,且提供前置校验要求;但引用的参考文档和工具可用性依赖外部环境,缺少针对失败、异常输入和实际关键路径的可诊断反馈,静态审查不支持超过10分。

3适用触发11 / 15 · 3.7/5

描述包含明确触发场景和“不适用”范围,覆盖多种 VS Code 定制文件;但用户输入、预期输出、语义触发边界以及中文和中国大陆网络环境适配说明不足,因此扣分。

4规范维护11 / 15 · 3.7/5

采用主文档加分层参考文档的结构,包含模板、位置、命名、渐进加载、许可证和官方来源线索;但技能自身没有版本、变更记录、维护责任或更新路径,且依赖外部文档,故未满分。

5有效结果6 / 15 · 2.0/5

能够指导选择定制原语、创建文件并进行基础验证,核心任务具有直接帮助;但没有可验证的代表性输出或执行结果,实际完成质量依赖宿主代理和未提供的工具,静态校准限制在7分以内。

6证据核验3 / 10 · 1.5/5

内容包含可审计的模板、规则和仓库内 CI/测试背景,但所给 CI 与测试并未覆盖该技能的关键流程,也没有第三方执行证据或独立复现结果,因此仅给有限分数。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 5b3e1be7be9e 评估证据[1][2][3][4][5][6][7][8][9][10][11][12][13][14][15][16][17]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能会显示为聊天中的 slash command 吗?
不会。其 frontmatter 将 user-invocable 设为 false,并说明它不应显示为 slash command。
它会自动修改我的项目文件吗?
它被设计为读取和写入定制文件,但实际修改仍取决于宿主 Agent 是否提供并授权文件系统工具。创建文件后应检查路径、frontmatter 和 description。
它能排查所有 Agent 或编程问题吗?
不能。它针对 Agent 定制文件及其未加载、未调用等问题;一般编程问题、运行时调试、MCP 服务器配置和 VS Code 扩展开发不在范围内。
什么时候不应该调用它?
如果只是根据已知模式创建一个文件,或快速修复单个 YAML frontmatter 问题,SKILL.md 建议直接编辑文件,不需要调用该技能。

同仓库的其他 Skills

均来自 microsoft/vscode

开发与工程 ✓ Microsoft · 官方

可复用提示词创建器

把重复任务整理成可复用的 .prompt.md 文件。

★ 194k FS 45 不推荐 11 天前
开发与工程 ✓ Microsoft · 官方

代码库初始化定制器

探索代码库并生成或更新帮助 AI 编程代理工作的定制文件。

★ 194k FS 45 不推荐 11 天前
开发与工程 ✓ Microsoft · 官方

项目指令创建器

把对话中的规则和偏好整理成项目指令文件。

★ 194k FS 51 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

工具重命名兼容性检查

防止内置工具重命名破坏现有提示词与工具配置。

★ 194k FS 63 推荐 11 天前
开发与工程 ✓ Microsoft · 官方

Copilot 会话故障诊断

基于会话日志解释 Copilot CLI 为何出现异常行为。

★ 194k FS 51 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

工作流技能构建器

把对话中的工作方法整理成可复用的 SKILL.md。

★ 194k FS 50 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

Copilot 聊天故障排查

通过 Copilot Chat 调试日志解释代理行为、工具调用和加载失败。

★ 194k FS 49 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 配置策略维护助手

规范 VS Code 企业配置策略的注册、导出与验证。

★ 194k FS 59 推荐 11 天前
设计与前端 ✓ Microsoft · 官方

VS Code 设计哲学

用价值、原则和设计动作,把“看起来不对”转化为可执行的界面改进。

★ 194k FS 58 推荐 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 集成浏览器架构指南

帮助开发者安全理解和修改 VS Code 集成浏览器的跨进程架构。

★ 194k FS 56 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

Code OSS 启动与调试

为 VS Code 源码构建提供隔离启动、Playwright 自动化和多进程调试端口。

★ 194k FS 54 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 崩溃转储符号化

将原生 VS Code 崩溃转储转换为带方法名的可读回溯。

★ 194k FS 53 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 聊天定制编辑器开发技能

帮助开发者安全修改并测试 VS Code 的聊天定制管理界面。

★ 194k FS 52 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 集成测试运行助手

帮助你在 VS Code 源码仓库中准确运行和筛选集成测试。

★ 194k FS 52 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

运行命令配置助手

为 VS Code Agent Session 配置和更新运行按钮命令。

★ 194k FS 48 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 性能调查工作流

自动化复现 VS Code 场景并采集性能与内存证据。

★ 194k FS 47 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

VS Code 本地 Web 工作台

在本地 vscode.dev 中验证 VS Code 工作台和 Agents 窗口改动。

★ 194k FS 53 谨慎使用 11 天前
开发与工程 ✓ Microsoft · 官方

自定义代理创建器

根据工作目标和对话上下文创建专用的 .agent.md 代理文件。

★ 194k FS 42 不推荐 11 天前
开发与工程 ✓ Microsoft · 官方

Copilot Chat OpenTelemetry 埋点指南

为 Copilot Chat 统一设计和维护 OpenTelemetry 埋点。

★ 194k FS 60 推荐 11 天前
开发与工程 ✓ Microsoft · 官方

Agent 主机端到端测试助手

用严格的回放夹具维护 VS Code Agent 主机端到端测试。

★ 194k FS 56 谨慎使用 11 天前

相关 Skills