create-custom-agent

create-custom-agent 技能概览

create-custom-agent 技能可帮助你为专门化的 AI 角色创建 VS Code 自定义 agent 文件（.agent.md）。它最适合需要可复用 agent 配置的人：要有明确的工具、指令和交接逻辑，而不是临时拼一个 prompt。无论你在构建规划类、审阅类，还是任务专用 agent，这个技能都能为 create-custom-agent 的 Skill Authoring 流程提供一个结构化起点。

这个 create-custom-agent 技能是做什么的

当你想定义 agent 应该如何思考、可以使用哪些工具，以及完成后下一步该怎么走时，就该用 create-custom-agent。它面向的是 agent 脚手架搭建，而不是通用的 prompt 写作。

适合谁安装

如果你在 VS Code 中工作，希望在仓库或用户配置目录里生成 .agent.md 文件，或者需要让不同任务、不同协作者之间的 agent 行为保持一致，就应该安装 create-custom-agent 技能。

它的价值在哪里

它的核心价值是保持一致性：这个技能会把模糊的角色想法，落成一个带 frontmatter、工具限制和交接逻辑的具体 agent 文件。这样在搭建自定义 agent 工作流时，能明显减少猜测成本。

如何使用 create-custom-agent 技能

安装 create-custom-agent 技能

先从你的 skills 管理器执行安装步骤，例如：npx skills add dotnet/skills --skill create-custom-agent。安装完成后，打开 .agents/skills/create-custom-agent 下的技能文件，并把 SKILL.md 作为主要指南来使用。

把粗略想法转成可用的 prompt

想要更好的 create-custom-agent usage，建议一开始就把这些输入给全：agent 名称、简短描述、目标角色、允许使用的工具，以及任何交接目标。像“帮我做一个 agent”这种弱请求，通常只会得到一个很泛的结果；更好的写法是“创建一个用于 C# PR 的代码审查 agent，只允许 read、search 和 comment 工具，并在完成后交接给 fixer agent”。

先读这些文件

先从 SKILL.md 开始，再查看该技能在文件中引用的任何仓库上下文。这个仓库里没有额外的 helper 文件夹，所以最快的路径，是在生成自己的 .agent.md 之前，先认真看清 workflow、inputs 和 constraint 这些部分。

用更实际的工作流

先起草 persona，再决定工具范围，最后定义交接逻辑。这个顺序很重要，因为工具权限和后续路由，对 agent 的实际行为影响往往比命名或品牌包装更大。

create-custom-agent 技能 FAQ

create-custom-agent 只适用于 VS Code agent 吗？

是的，这个技能的重点就是 VS Code 自定义 agent 和 .agent.md 编写。如果你需要的是 .instructions.md 或 .prompt.md，那就不是这个安装项。

它和普通 prompt 有什么不同？

prompt 是一次性的，而 custom agent 是可复用、受约束的。create-custom-agent 指南适合在你需要一个带工具权限和工作流交接的持久化 agent 定义时使用，而不只是写一条聊天指令。

它适合新手吗？

如果你已经清楚自己希望 agent 承担什么工作，那它是适合新手的。若角色、工具或交接路径还不明确，它就没那么友好，因为这些选择会直接决定生成文件的质量。

什么情况下不该用它？

如果你是在直接编辑现有 agent、制作 instruction 文件，或者只需要一个一次性、用完即弃的 prompt，那就不要用 create-custom-agent。

如何改进 create-custom-agent 技能

给技能更强的源输入

提升质量最大的办法，是先给出更具体的 agent brief：任务领域、成功标准、允许使用的工具、禁止使用的工具，以及流程中的下一个 agent。输入越清楚，生成后需要的返工就越少。

留意常见失败模式

最常见的问题是 persona 过于空泛、工具集合过宽，以及交接逻辑和真实 workflow 对不上。如果输出看起来很泛，通常不是技能不行，而是你的 prompt 描述的是一个角色，不是一个具体工作。

在第一版之后继续迭代

先把第一版 .agent.md 当草稿用，再根据真实使用情况收紧描述文字、工具限制和交接条件。对于 create-custom-agent 技能的输出来说，通常小幅调整约束，比整文件重写更能改善行为。

用你的仓库需求来验证

在发布之前，先检查这个 agent 是否符合你仓库里的规范、安全边界和团队 workflow。最好的 create-custom-agent 结果，不是看起来最漂亮的 persona，而是能真正匹配实际运行环境的那一个。