开发与工程 ✓ Microsoft · 官方 chat-customizationagent-instructionscustom-agentscodebase-explorationproject-conventions

代码库初始化定制器

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

FollowSkills 评估 · FSRS-2.0
不推荐
45/ 100 五分制 2.3 / 5
信任安全15 / 25 · 3.0/5

技能明确限制仅创建或修改聊天定制文件,并禁止直接执行参数中的任务,体现了基本范围控制;但未要求修改前用户确认、未说明敏感信息和外部数据流、缺少备份或回滚方案,因此扣分。

可靠稳定6 / 20 · 1.5/5

工作流步骤总体一致,包含发现、探索、生成合并和迭代;但依赖未提供的 agent-customization、可选的 chronicle 和未具体定义的子代理行为,且没有异常输入、权限失败或探索失败时的诊断处理,因此按静态上限保守扣分。

适用触发8 / 15 · 2.7/5

目标用户和核心场景较清楚:为 AI 编码代理生成或更新仓库级定制文件,并支持可选关注领域;但触发语义、非适用边界、复杂仓库分层条件和中文/中国大陆网络适配没有充分说明,因此扣分。

规范维护8 / 15 · 2.7/5

具备名称、描述、参数提示、禁用模型自动调用标记和分步工作流,也引用了仓库文档、MIT 许可证及官方组织来源;但缺少版本、变更记录、明确维护责任、安装依赖说明、示例和故障排查,且文件名搜索列表存在 AGENT.md 与前文 AGENTS.md 不一致,因此扣分。

有效结果5 / 15 · 1.7/5

技能有望通过探索构建命令、架构、约定和陷阱来产出可直接帮助代理的定制文件,并要求输出变更表;但没有代表性输出或结果验证,效果依赖相关技能和代码库探索质量,且可能需要人工复核,因此按静态上限保守评分。

证据核验3 / 10 · 1.5/5

技能文本本身可审计,仓库还提供一般性的 CI、测试脚本和治理信息;但没有针对该技能的测试、执行记录或第三方复现证据,现有 CI 不能证明该路径的关键流程,因此仅给有限可验证性分数。

证据充分度: 评估于 2026年7月20日 审查版本 5b3e1be7be9e
使用前请注意
  • 执行前应确认将要创建或修改的具体文件,并保留可恢复备份;当前文本没有回滚流程。
  • 相关 agent-customization 和 chronicle 技能未在证据中提供,缺失时可能导致流程无法完成或输出质量下降。
  • 应修正 AGENT.md 与 AGENTS.md 的命名不一致,并补充失败处理、示例、版本和维护信息。
  • 未说明中文交互或中国大陆网络环境下的可用性;若依赖不可达的海外服务,应提前披露。
查看完整评分方法 →

它能做什么 & 适用场景

init 用于为 AI 编程代理创建或更新代码库定制文件,包括 AGENTS.md、.github/copilot-instructions.md、skills 和 custom agents。它会先探索项目结构、现有约定、构建与测试信息及文档,再生成或合并相关文件。该命令只处理聊天定制文件,不会执行用户参数中描述的实际开发任务。它位于 microsoft/vscode 仓库的 Agent Skill 集合中,该仓库采用 MIT 许可证。

命令会搜索既有代理指令文件、README 及相关规则文件,探索代码库中的构建、测试、架构、约定和文档信息,然后创建或更新适合 AI 编程代理使用的聊天定制文件。新文件优先使用 AGENTS.md;若已有 AGENTS.md 或 .github/copilot-instructions.md,则更新并保留有价值的内容。它还会在完成后输出新增或修改文件的表格,并建议下一步可创建的相关 agent customization。

  1. 维护大型代码库的团队,希望新加入的 AI 编程代理能快速了解项目约定、架构边界和常用开发命令。
  2. 已有 AGENTS.md 或 .github/copilot-instructions.md 但内容过时的项目维护者,希望在保留有效信息的同时更新指导内容。
  3. 创建新项目的开发者,希望根据项目描述生成初始的代理指令、技能或 custom agents。
  4. 希望围绕某个主题补充代理规则的开发者,例如为测试、前端或后端工作建立更聚焦的定制内容。

优缺点一览

优点
  • 覆盖从现有约定发现到定制文件生成或合并的完整流程。
  • 强调链接已有文档而不是重复嵌入内容,有助于保持指导文件精简。
  • 会保留已有文件中的有价值内容,并优先使用 AGENTS.md。
  • 适用于新项目初始化和既有项目的指导内容维护。
局限
  • 来源没有提供独立安装命令或宿主客户端安装步骤。
  • 依赖相关的 `agent-customization` skill 获取不同定制文件类型的详细信息。
  • SKILL.md 将 `disable-model-invocation` 设为 true,因此不能依赖模型自动调用,使用时需要显式触发。
  • 来源没有展示该技能自身的测试套件、平台覆盖或失败恢复机制。

如何安装

提供的 README 没有记录该技能集合的独立安装命令。技能文件位于仓库中的 extensions/copilot/assets/prompts/skills/init/SKILL.md;如需使用集合,应按照宿主 Agent Skills 客户端的安装方式处理,具体步骤未在来源中说明。

如何使用

显式调用 init 命令。可以不带参数以生成或更新通用代码库定制文件,也可以附带一个关注领域或模式,例如调用 init 并指定“测试约定”,让它聚焦于该主题。命令开始时会简短告知用户正在探索代码库并处理定制文件;完成后会列出新增或修改的文件及其用途。

常见问题

这个技能会直接执行用户参数中的开发任务吗?
不会。参数可以指定要记录的定制主题或新项目描述,但命令只创建或修改聊天定制文件,不会开始执行参数中描述的任务。
它会修改哪些类型的文件?
目标包括 `.github/copilot-instructions.md`、`AGENTS.md`、skills 和 custom agents。生成新文件时优先选择 AGENTS.md;如果已有相关指令文件,则更新现有文件。
使用它需要网络或特定运行时依赖吗?
来源只明确显示它需要读取和写入代码库文件;没有记录网络服务、MCP 服务器或 Node.js、Python 等特定运行时依赖。
这个技能是否免费或有许可证限制?
它包含在 microsoft/vscode 仓库中,该仓库源代码采用 MIT 许可证。来源没有说明独立于该仓库的单独分发条款。

同仓库的其他 Skills

均来自 microsoft/vscode

开发与工程 ✓ Microsoft · 官方

工具重命名兼容性检查

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

开发与工程 ✓ Microsoft · 官方

Copilot Chat OpenTelemetry 埋点指南

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

开发与工程 ✓ Microsoft · 官方

VS Code 配置策略维护助手

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

设计与前端 ✓ Microsoft · 官方

VS Code 设计哲学

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

开发与工程 ✓ Microsoft · 官方

Agent 主机端到端测试助手

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

开发与工程 ✓ Microsoft · 官方

VS Code 集成浏览器架构指南

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

开发与工程 ✓ Microsoft · 官方

VS Code Agents 窗口会话架构

帮助代理安全实现和修复 VS Code Agents 窗口功能。

开发与工程 ✓ Microsoft · 官方

智能提交助手

根据仓库惯例生成提交信息并安全提交代码变更。

开发与工程 ✓ Microsoft · 官方

Agent Host 日志分析

定位 Agent Host 导出日志中的会话、传输与主机问题。

开发与工程 ✓ Microsoft · 官方

VS Code 单元测试助手

在 VS Code 源码仓库中按文件、测试名称或匹配模式运行单元测试。

开发与工程 ✓ Microsoft · 官方

VS Code Agent 定制助手

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

开发与工程 ✓ Microsoft · 官方

Code OSS 启动与调试

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

开发与工程 ✓ Microsoft · 官方

VS Code 无障碍开发助手

为 VS Code 交互式功能提供可执行的无障碍实现规范。

设计与前端 ✓ Microsoft · 官方

VS Code CSS 布局规范

用 VS Code 规范构建稳健的 CSS 布局与文本截断体验

开发与工程 ✓ Microsoft · 官方

VS Code Chat 性能实验室

基准测试聊天渲染性能,并检测会话中的内存泄漏。

开发与工程 ✓ Microsoft · 官方

组件夹具与截图测试

帮助你为 VS Code 组件创建稳定、可主题化的截图测试夹具。

开发与工程 ✓ Microsoft · 官方

VS Code 冒烟测试助手

运行、筛选并调试 VS Code 端到端冒烟测试。

开发与工程 ✓ Microsoft · 官方

VS Code 崩溃转储符号化

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

开发与工程 ✓ Microsoft · 官方

VS Code 本地 Web 工作台

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

开发与工程 ✓ Microsoft · 官方

反馈执行器

读取当前会话反馈并落实对应代码修改。

相关 Skills