打通任督二脉：让你的 GitHub Copilot 瞬间学会 Claude Code 的所有绝招 > **目标读者**：希望在 VSCode/Zed 编辑器中直接复用 Claude Code 强大本地能力的开发者、DevOps 工程师、AI 工具流搭建者。 > **核心价值**：通过自动化映射机制，打破 Claude Code CLI 与编辑器 Copilot 之间的"生殖隔离"，实现一套 Ski…
目标读者：希望在 VSCode/Zed 编辑器中直接复用 Claude Code 强大本地能力的开发者、DevOps 工程师、AI 工具流搭建者。
核心价值：通过自动化映射机制，打破 Claude Code CLI 与编辑器 Copilot 之间的"生殖隔离"，实现一套 Skills/Agents 双端复用。
阅读时间：8 分钟
你是否遇到过这种割裂的体验：在终端里，Claude Code 配置了强大的 tech-blog 技能，能一键生成高质量博客；配置了 code-review Agent，能深度审查代码。但在 VSCode 编辑器里，面对 GitHub Copilot，你却只能用最基础的自然语言对话，Copilot 对你精心调教的那些本地技能一无所知。
这就像是你拥有一本绝世武功秘籍（Claude Code Skills），但你的随身保镖（Copilot）却是个只会打直拳的门外汉。
如果我们能建立一种机制，自动将 Claude Code 的所有能力"注册"给 Copilot，会发生什么？
本文将深度解析如何通过一个 Node.js 扫描脚本，自动生成"能力映射表"，让 Copilot 瞬间"读取"并掌握你所有的本地 Skills、Agents 和 Commands。
Claude Code 的核心优势在于其高度可定制的 Local Skills（本地技能）和 Agents（智能体）。这些定义通常以 Markdown 文件的形式存储在 ~/.claude/skills 或 ~/.claude/agents 目录中。
然而，GitHub Copilot 运行在编辑器的上下文中，它无法直接通过系统路径去"扫描"和"理解"这些散落在文件系统中的技能定义。
我们需要一个"中间层"——Mapping Files（映射文件）。
这就像是给 Copilot 准备的一份"技能菜单"。菜单上不仅列出了有什么菜（Skill Name），还写明了这道菜是什么味道（Description），以及大厨在哪里（File Path）。Copilot 拿到这份菜单，就能根据你的需求点菜了。
为了实现这一目标，我 Vibe 了一个名为 scan-and-generate.mjs 的自动化脚本。它的核心职责是：遍历目录 -> 提取元数据 -> 生成 Markdown。
脚本的设计必须足够通用，以支持 Skills、Agents、Commands 以及插件（Plugins）中的各种资源。我们在代码中定义了一个强大的 CONFIG 对象：
constCONFIG={mappings:[{id:"skills",name:"Local Skills",outputFile:"skills-mapping.md",sourceDir:ROOT_DIR+"/skills/",sourcePattern:"*/SKILL.md",// 锁定 SKILL.md 文件frontmatterFields:["description","name"],// 提取关键元数据groupBy:(file)=>{// 智能分组逻辑，按功能类别归档const relative = file.replace(ROOT_DIR+"/skills/","");const skillName = relative.split("/")[0];returngetSkillCategory(skillName);},},// ... 其他映射配置（Agents, Commands等）],};
这段配置定义了"去哪找"（sourceDir）、'找什么'（sourcePattern）以及"怎么展示"（groupBy）。特别是 frontmatterFields，它直接从 Markdown 的头部元数据（Frontmatter）中提取技能描述，这是 Copilot 理解技能用途的关键。
脚本不仅是简单的列表生成，还包含了智能的分类逻辑。例如，getSkillCategory 函数维护了一个映射表，将杂乱的技能归类为 'Content & Writing'、'Development'、'Project Management' 等类别。
// 示例：将技能映射到类别const categories ={"tech-blog":"Content & Writing","code-review":"Code Analysis",zustand:"Development",// ...};
这种结构化的输出对于 LLM（大语言模型）非常友好。当 Copilot 阅读这份文档时，它能建立起结构化的认知：'哦，如果用户要写文章，我应该去 Content & Writing 分类下找找。'
仅仅列出文件是不够的，我们还需要告诉 Copilot 如何使用 这些技能。脚本会读取 templates 目录下的指令模版，并将其嵌入到生成的 Markdown 头部。
以 skills-mapping.md 为例，生成的头部包含这样的指令：
'当用户激活本地技能时… 1. 识别技能引用… 3. 使用 Read 工具读取 SKILL.md 文件… 4. 将技能规则应用到当前会话…'
这相当于给 Copilot 植入了一段"元指令"（Meta-Prompt），教它如何加载和执行外部技能。
#!/usr/bin/env node/** * Scan and Generate Mapping Documents * 扫描 ~/.claude/ 目录并生成映射文档 */import{ readFileSync, writeFileSync, mkdirSync, existsSync, lstatSync, readdirSync,}from"fs";import{ globSync }from"glob";import{ dirname, basename, join }from"path";import{ fileURLToPath }from"url";const __dirname =dirname(fileURLToPath(import.meta.url));constROOT_DIR= process.env.HOME+"/.claude";constOUTPUT_DIR=join(__dirname,"output");constTEMPLATES_DIR=join(__dirname,"templates");// 确保输出目录存在if(!existsSync(OUTPUT_DIR)){mkdirSync(OUTPUT_DIR,{recursive:true});}// 扫描配置constCONFIG={mappings:[{id:"commands",name:"Local Commands",outputFile:"commands-mapping.md",sourceDir:ROOT_DIR+"/commands/",sourcePattern:"**/*.md",exclude:["CLAUDE.md"],frontmatterFields:["description","argument-hint","allowed-tools"],groupBy:(file)=>{const relative = file.replace(ROOT_DIR+"/commands/","");const parts = relative.split("/");return parts.length >1?capitalize(parts[0]):"General";},getShortcut:(file, frontmatter)=>{const relative = file .replace(ROOT_DIR+"/commands/","").replace(".md","").replace(/\//g,":");return relative ?"/"+ relative :"/";},getName:(frontmatter, title, file)=>{return frontmatter.name || title ||basename(file,);},},{:,name:,outputFile:,sourceDir:ROOT_DIR+,sourcePattern:[,],exclude:[],frontmatterFields:[,],groupBy:(file)=>{const match = file.match(/plugins\/cache\/([^\/]+)\/([^\/]+)/);(match){returnformatPluginName(match[1], match[2]);};},getShortcut:(file, frontmatter)=>{const cmdMatch = file.match(/[\/\.](claude\/)commands\/([^\/]+)\.md$/);const cmdName = cmdMatch ? cmdMatch[2]:(file,);const orgMatch = file.match(/plugins\/cache\/([^\/]+)\//);const org = orgMatch ? orgMatch[1]:;+(org ? org.replace(,)+:)+ cmdName;},getName:(frontmatter, title, file)=>{const match = file.match(/[\/\.](claude\/)commands\/([^\/]+)\.md$/); frontmatter.name || match?.[2]||(file,);},},{:,name:,outputFile:,sourceDir:ROOT_DIR+,sourcePattern:[,],exclude:[],frontmatterFields:[,],groupBy:(file)=>{const match = file.match(/plugins\/cache\/([^\/]+)\/([^\/]+)/);(match){returnformatPluginName(match[1], match[2]);};},subgroupBy:(file)=>{const relative = file.split(/agents\//)[1];(!relative);const parts = relative.split(); parts.length >1?capitalize(parts[0]):;},getShortcut:null,getName:(frontmatter, title, file)=>{ frontmatter.name || title ||(file,);},},{:,name:,outputFile:,sourceDir:ROOT_DIR+,sourcePattern:,exclude:[,],frontmatterFields:[,],groupBy:(file)=>{const match = file.match(/plugins\/cache\/([^\/]+)\/([^\/]+)/);(match){returnformatPluginName(match[1], match[2]);};},getShortcut:null,getName:(frontmatter, title, file)=>{ frontmatter.name || title ||(file,);},},{:,name:,outputFile:,sourceDir:ROOT_DIR+,sourcePattern:,exclude:[],frontmatterFields:[,],groupBy:(file)=>{const relative = file.replace(ROOT_DIR+,);const skillName = relative.split()[0];returngetSkillCategory(skillName);},getShortcut:null,getName:(frontmatter, title, file)=>{ frontmatter.name || title ||(file,);},},{:,name:,outputFile:,sourceDir:ROOT_DIR+,sourcePattern:,exclude:[],frontmatterFields:[,],groupBy:(file)=>{const relative = file.replace(ROOT_DIR+,);const parts = relative.split(); parts.length >1?capitalize(parts[0]):;},getShortcut:null,getName:(frontmatter, title, file)=>{ frontmatter.name || title ||(file,);},},],};// 工具函数functionformatPluginName(org, plugin){const displayNames ={thedotmack:,:,:,:,};const orgDisplay = displayNames[org]|| org;const pluginDisplay = plugin === org ?:` ()`; orgDisplay + pluginDisplay;}functioncapitalize(str){(!str); str.charAt(0).toUpperCase()+ str.slice(1);}functiongetSkillCategory(skillName){const categories ={:,:,:,:,zustand:,:,:,:,:,:,:,codeagent:,:,claudeception:,:,:,:,:,:,:,figma2code:,}; categories[skillName]||;}functionparseFrontmatter(content){const result ={};const match = content.match(/^---\n([\s\S]*?)\n---/);(!match) result;const yamlContent = match[1];const lines = yamlContent.(); currentKey =null; multilineValue =[]; isMultiline =;( i =0; i < lines.length; i++){const line = lines[i];const colonIndex = line.indexOf();// 检查是否是新的键值对(colonIndex >0&&!line.startsWith()&&!line.startsWith()){// 保存之前的多行值(isMultiline && currentKey){ result[currentKey]= multilineValue.().trim(); multilineValue =[]; isMultiline =;}const key = line.slice(0, colonIndex).trim();const value = line.slice(colonIndex +1).trim();// 检查是否是多行格式 (> 或 |)(value ===|| value ===){ currentKey = key; isMultiline =; multilineValue =[];}{// 单行值 currentKey = key; result[key]= value.replace(/^\[|\]$/g,).replace(/,\s*/g,);}}elseif(isMultiline && line.trim()){// 多行值的内容行（忽略空行） multilineValue.push(line.trim());}}// 保存最后一个多行值(isMultiline && currentKey){ result[currentKey]= multilineValue.().trim();} result;}functiongetTitle(content){const lines = content.split();(const line of lines){(line.startsWith()){ line.replace(,).trim();}}returnnull;}functionscanFiles(pattern, exclude =[]){const patterns = Array.isArray(pattern)? pattern :[pattern]; files =[];(const p of patterns){ files = files.concat(globSync(p,{ignore: exclude }));}[...newSet(files.filter((f)=>!lstatSync(f).isDirectory()))];}// 获取插件目录下的最新版本号functiongetLatestVersion(versions){(versions.length ===0)returnnull;// 分离语义版本和非语义版本const semverVersions =[];const nonSemverVersions =[];(const v of versions){// 语义版本格式: x.y.z (可能带有 pre-release 标签)(/^\d+\.\d+(\.\d+)?(-[a-zA-Z0-9.-]+)?$/.test(v)){ semverVersions.push(v);}{ nonSemverVersions.push(v);}}// 如果有语义版本，使用 semver 比较(semverVersions.length >0){// 简单的 semver 比较函数constcompareSemver=(a, b)=>{constparse=(v)=>{const parts = v.split()[0].().map(Number);const preRelease = v.split()[1]||;{major: parts[0]||0,minor: parts[1]||0,patch: parts[2]||0, preRelease,};};const pa =parse(a);const pb =parse(b);(pa.major !== pb.major) pb.major - pa.major;(pa.minor !== pb.minor) pb.minor - pa.minor;(pa.patch !== pb.patch) pb.patch - pa.patch;// 处理 pre-release: 正式版 > pre-releaseif(!pa.preRelease && pb.preRelease)return-1;(pa.preRelease &&!pb.preRelease)return1;return0;}; semverVersions.(compareSemver)[0];}// 否则使用字母序最后一个 nonSemverVersions.().pop();}// 获取插件目录下所有版本目录functiongetPluginVersions(pluginPath){(!existsSync(pluginPath))[];const entries =readdirSync(pluginPath,{withFileTypes:}); entries .filter((entry)=> entry.isDirectory()).map((entry)=> entry.name);}// 过滤文件，只保留每个插件最新版本的内容functionfilterLatestVersionFiles(files, patterns, exclude =[]){if(files.length ===)return files;// 解析文件路径,提取插件标识和版本// 格式: plugins/cache/{org}/{plugin}/{version}/...const pluginVersions =newMap();// key: "org/plugin", value: versionfor(const file of files){const match = file.match(/plugins\/cache\/([^\/]+)\/([^\/]+)\/([^\/]+)/);if(match){const org = match[];const plugin = match[];const version = match[];const key =`/`;if(!pluginVersions.has(key)){ pluginVersions.(key, version);}{const currentLatest = pluginVersions.get(key);const candidateVersions =[currentLatest, version];const latest =getLatestVersion(candidateVersions); pluginVersions.(key, latest);}}}// 重新扫描获取最新版本的实际文件const latestFiles =newSet();const sourceDir =ROOT_DIR+;(const[key, version]of pluginVersions){const[org, plugin]= key.split();const versionPath =(sourceDir, org, plugin, version);(existsSync(versionPath)){(const pattern of patterns){const fullPattern =(versionPath, pattern);const matched =globSync(fullPattern,{ignore: exclude,}); matched.forEach((f)=> latestFiles.add(f));}}}[...latestFiles];}functiongroupFiles(files, groupBy, subgroupBy =null){const ={};(const file of files){const category =groupBy(file);(![category]){ [category]= subgroupBy ?{}:[];}(subgroupBy){const subcategory =subgroupBy(file);(![category][subcategory]){ [category][subcategory]=[];} [category][subcategory].push(file);}{ [category].push(file);}} ;}functiongetAgentUsageInstructions(mappingId){// 模板文件映射const templateFiles ={commands:,:,:,:,skills:,agents:,};const templateFile = templateFiles[mappingId];(!templateFile){;}const templatePath =(TEMPLATES_DIR, templateFile);(!existsSync(templatePath)){ console.warn(`Warning: Template file not found: `);;}try{returnreadFileSync(templatePath,);}catch(error){ console.warn(`Warning: Failed to template file: `, error,);;}}functiongenerateMarkdown(mapping, ){ md =`---\nversion: 1.0\nlastUpdated: \n---\n\n`; md +=`# 映射表\n\n`; md +=`本文件从 \`\` 目录自动扫描生成。\n\n`;// 添加 Agent 使用流程说明const usageInstructions =getAgentUsageInstructions(mapping.id);(usageInstructions){ md += usageInstructions;} md +=`---\n\n`;const categories = Object.keys().(); totalCount =0;(const category of categories){const group = [category]; md +=`## \n\n`;(mapping.subgroupBy &&typeof group ===){const subcategories = Object.keys(group).();(const subcategory of subcategories){const files = group[subcategory]; md +=`### \n\n`; md +=generateTable(mapping, files, totalCount); totalCount += files.length;}}{const files = Array.isArray(group)? group : group[category]||[]; md +=generateTable(mapping, files, totalCount); totalCount += files.length;}} md +=`---\n\n`; md +=`*最后更新：*\n`; md;}functiongenerateTable(mapping, files, startIndex){(files.length ===0); md =;const hasShortcut = mapping.getShortcut !==null;(hasShortcut){ md +=`| 快捷方式 | 名称 | 描述 | 完整路径 |\n`; md +=`|----------|------|------|----------|\n`;}{ md +=`| 名称 | 描述 | 完整路径 |\n`; md +=`|------|------|----------|\n`;}(const file of files.sort()){ md +=generateRow(mapping, file)+;} md +=; md;}functiongenerateRow(mapping, filePath){const content =readFileSync(filePath,);const frontmatter =parseFrontmatter(content);const title =getTitle(content);const shortPath = filePath.replace(process.env.HOME,);const name = mapping.getName(frontmatter, title, filePath);const shortcut = mapping.getShortcut ? mapping.getShortcut(filePath, frontmatter):; description = frontmatter.description ||;// Clean up description - remove surrounding quotes presentif(description.startsWith()&& description.endsWith()){ description = description.slice(1,-1);}(shortcut){`| | | | \`\` |`;}`| | | \`\` |`;}(){ console.log();(const mapping ofCONFIG.mappings){ console.log(` Processing: ...`);const patterns = Array.isArray(mapping.sourcePattern)? mapping.sourcePattern :[mapping.sourcePattern]; files =[];(const pattern of patterns){// Prepend sourceDir to all patternsconst fullPattern =(mapping.sourceDir, pattern); files = files.concat(globSync(fullPattern,{ignore: mapping.exclude }));} files =[...newSet(files.filter((f)=>!lstatSync(f).isDirectory()))];// 插件 mapping 需要过滤只保留最新版本(mapping.id.startsWith()){ files =filterLatestVersionFiles(files, patterns, mapping.exclude);}(files.length ===0){ console.log(` Warning: No files found `);;}const =groupFiles(files, mapping.groupBy, mapping.subgroupBy);const markdown =generateMarkdown(mapping, );const outputPath =(OUTPUT_DIR, mapping.outputFile);writeFileSync(outputPath, markdown,);const totalItems = Object.values().reduce((sum, group)=>{if(mapping.subgroupBy &&typeof group ==="object"){return sum + Object.values(group).reduce((s, f)=> s + f.length,);}return sum +(Array.isArray(group)? group.length :);},); console.log(` Generated: ( items)`);} console.log("\nAll mapping documents generated successfully!");}run();
## Agent 使用流程 当用户输入命令时，按以下步骤执行： 1. **解析命令快捷方式** - 顶层命令：直接查找表格（格式：`/command`） - 嵌套命令：解析 category:command 格式（格式：`/category:command`） 2. **查找映射表** - 在对应分类表格中查找快捷方式列 - 获取完整路径字段 3. **读取命令文件** - 使用 Read 工具读取完整路径对应的 .md 文件 - 解析 frontmatter 获取 allowed-tools 和其他元数据 4. **执行命令** - 按照命令文件中的指令执行 - 严格使用 frontmatter 中指定的 allowed-tools - 如果未指定 allowed-tools，使用默认工具集 ---
tech-blog万事俱备，现在的核心问题是：体验如何？
假设你已经运行了脚本，生成了 skills-mapping.md。
@workspace 或直接打开 skills-mapping.md 文件，让 Copilot 读取这个文件。skills-mapping.md。tech-blog 条目，描述匹配 '技术博客文章创作工具'。~/.claude/skills/tech-blog/SKILL.md。tech-blog 的 Prompt 规则（如 3W 框架、金句要求）。tech-blog 的深度版风格，生成了一篇结构完美的文章。这通过一次简单的映射，打破了工具间的壁垒。 你在 Claude Code 里沉淀的每一次 Prompt 优化、每一个 Agent 调教，现在都能无缝同步给编辑器里的 Copilot。
'工欲善其事，必先利其器'。但在 AI 时代，我们面临的问题往往不是器不够利，而是"器"太多且互不相通。
通过 scan-and-generate.mjs 这样一个小巧的胶水脚本，我们不仅仅是生成了一份文档，更是建立了一座桥梁。它连接了 CLI 的灵活性与 IDE 的便捷性，连接了系统级的能力与编辑器级的交互。
现在，去运行你的扫描脚本，把你的 Claude Code 变成 Copilot 的最强外脑吧。
@mappings/scan-and-generate.mjs
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online