VS Code Agent 定制助手
帮助创建、修复和排查 VS Code Agent 定制文件及其加载问题。
技能明确限制适用范围，建议使用只读子代理探索，并要求确认工作区或用户范围；但创建流程仍允许直接读写文件，未明确逐项用户确认、敏感数据流、回滚机制或外部工具权限，因此扣分。
决策表、创建步骤、边界和常见陷阱较一致，且提供前置校验要求；但引用的参考文档和工具可用性依赖外部环境，缺少针对失败、异常输入和实际关键路径的可诊断反馈，静态审查不支持超过10分。
描述包含明确触发场景和“不适用”范围，覆盖多种 VS Code 定制文件；但用户输入、预期输出、语义触发边界以及中文和中国大陆网络环境适配说明不足，因此扣分。
采用主文档加分层参考文档的结构，包含模板、位置、命名、渐进加载、许可证和官方来源线索；但技能自身没有版本、变更记录、维护责任或更新路径，且依赖外部文档，故未满分。
能够指导选择定制原语、创建文件并进行基础验证，核心任务具有直接帮助；但没有可验证的代表性输出或执行结果，实际完成质量依赖宿主代理和未提供的工具，静态校准限制在7分以内。
内容包含可审计的模板、规则和仓库内 CI/测试背景，但所给 CI 与测试并未覆盖该技能的关键流程，也没有第三方执行证据或独立复现结果，因此仅给有限分数。
- 创建步骤涉及读写定制文件和可能执行钩子命令；使用前应对目标路径、工具权限、命令内容和备份/回滚方案进行人工确认。
- 参考文档通过外部官方链接补充，离线或受限网络环境下可能无法完成全部验证。
- 技能声明的触发与文件发现依赖宿主代理的语义识别，可能出现漏触发或误触发。
它能做什么 & 适用场景
这是 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 与目录名不匹配的问题。
优缺点一览
- 覆盖多种 VS Code Agent 定制文件，而不局限于单一文件类型。
- 提供从范围确定、原语选择、文件创建到验证的完整创建流程。
- 明确区分 Instructions、Skills、Prompts、Hooks 和 Custom Agents 的适用场景。
- 包含 applyTo、description、YAML frontmatter 和文件位置等常见故障点的具体检查方向。
- 源材料没有提供独立的测试套件、成功率或兼容性验证结果。
- 源材料没有说明该技能集合的具体安装命令。
- 技能依赖文件系统读写、提问工具和子代理等运行环境能力；不具备这些能力的客户端需要适配。
- 它明确排除一般编程问题、运行时错误诊断、MCP 配置和 VS Code 扩展开发。
如何安装
源材料没有提供该技能集合的安装命令。该技能在仓库中的路径是 extensions/copilot/assets/prompts/skills/agent-customization/SKILL.md。SKILL.md 列出的技能目录位置包括 .github/skills/<name>/、.agents/skills/<name>/ 和 .claude/skills/<name>/；将其用于其他环境时，应遵循目标 Agent Skills 客户端的安装方式。
如何使用
向支持该技能的 Agent 描述具体定制任务，例如：“检查为什么我的 .instructions.md 没有生效，并修复 applyTo 模式。”也可以请求：“为项目创建一个自定义 Agent，限制可用工具并包含正确的 YAML frontmatter。”如果只是根据已知模式创建单个文件，或快速修复 YAML frontmatter，应直接编辑文件，因为该技能明确将这些列为无需调用技能的单一操作。