Back to Details

ai-dev-tools-sync

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AI Dev Tools Sync

AI开发工具同步

Synchronize Claude Code and GitHub Copilot configurations to maintain feature parity.
同步Claude Code和GitHub Copilot的配置，以保持功能一致性。

Summary

概述

Goal: Synchronize Claude Code and GitHub Copilot configurations to maintain feature parity across both AI development tools.
StepActionKey Notes
1Identify change scopeSkills, prompts, agents, instructions, or workflows
2Map equivalentsClaude SKILL.md <-> Copilot prompt.md, etc.
3Apply changesUpdate both platforms' config files
4Verify parityEnsure both tools have matching capabilities
Key Principles:
  • Claude skills live in 
    .claude/skills/
    , Copilot prompts in 
    .github/prompts/
  • Copilot auto-reads Claude skills — avoid duplication where possible
  • Agents are shared in 
    .github/agents/
    for both platforms
目标： 同步Claude Code和GitHub Copilot的配置，确保这两款AI开发工具的功能保持一致。
步骤操作关键说明
1确定变更范围技能、提示词、Agent、指令或工作流
2映射等效项Claude的SKILL.md <-> Copilot的prompt.md等
3应用变更更新两个平台的配置文件
4验证一致性确保两款工具的功能匹配
核心原则：
  • Claude的技能存储在
    .claude/skills/
    ，Copilot的提示词存储在
    .github/prompts/
  • Copilot会自动读取Claude的技能——尽可能避免重复配置
  • Agent共享存储在
    .github/agents/
    ，供两个平台使用

When to Use

使用场景

Activate this skill when:
  • User asks to update Claude Code or Copilot setup
  • User wants to add/modify skills, prompts, agents, or instructions
  • User wants both tools to work similarly
  • User asks about AI dev tool configuration
在以下场景中激活该技能：
  • 用户要求更新Claude Code或Copilot的设置
  • 用户需要添加/修改技能、提示词、Agent或指令
  • 用户希望两款工具的功能保持一致
  • 用户咨询AI开发工具的配置问题

Quick Reference

快速参考

Claude CodeGitHub CopilotLocation
SKILL.mdSKILL.md
.claude/skills/
+ 
.github/skills/
skills/*/SKILL.mdprompts/*.prompt.md
.claude/skills/
+ 
.github/prompts/
agents/*.mdagents/*.md
.github/agents/
(shared)
workflows/*.md-
.claude/workflows/
CLAUDE.mdcopilot-instructions.mdRoot + 
.github/
-instructions/*.md
.github/instructions/
(applyTo patterns)
-chatmodes/*.chatmode.md
.github/chatmodes/
Claude CodeGitHub Copilot存储位置
SKILL.mdSKILL.md
.claude/skills/
+ 
.github/skills/
skills/*/SKILL.mdprompts/*.prompt.md
.claude/skills/
+ 
.github/prompts/
agents/*.mdagents/*.md
.github/agents/
（共享）
workflows/*.md-
.claude/workflows/
CLAUDE.mdcopilot-instructions.md根目录 + 
.github/
-instructions/*.md
.github/instructions/
（支持applyTo规则）
-chatmodes/*.chatmode.md
.github/chatmodes/

GitHub Copilot Features Catalog

GitHub Copilot功能目录

Complete catalog of GitHub Copilot customization features (as of 2026).
GitHub Copilot自定义功能完整目录（截至2026年）。

Configuration Files

配置文件

Repository-Level (
.github/
)

仓库级配置（
.github/
）

File/FolderPurposeFormat
copilot-instructions.md
Global instructions for all Copilot interactionsMarkdown
instructions/*.instructions.md
Path-scoped instructions with 
applyTo
frontmatter		Markdown + YAML
prompts/*.prompt.md
Reusable prompts (slash commands)Markdown + YAML
agents/*.md
Agent definitionsMarkdown + YAML
skills/*/SKILL.md
Agent skills with bundled resourcesMarkdown + YAML
chatmodes/*.chatmode.md
Custom chat personalitiesMarkdown + YAML
AGENTS.md
Master agent routing fileMarkdown
文件/文件夹用途格式
copilot-instructions.md
所有Copilot交互的全局指令Markdown
instructions/*.instructions.md
带
applyTo
前置元数据的路径范围指令		Markdown + YAML
prompts/*.prompt.md
可复用提示词（斜杠命令）Markdown + YAML
agents/*.md
Agent定义Markdown + YAML
skills/*/SKILL.md
附带资源的Agent技能Markdown + YAML
chatmodes/*.chatmode.md
自定义聊天个性Markdown + YAML
AGENTS.md
Agent路由主文件Markdown

Also Supported (Backward Compatibility)

兼容旧版本的配置

  • .claude/skills/
    - Copilot auto-reads Claude skills
  • CLAUDE.md
    - Copilot reads if present
  • GEMINI.md
    - Gemini CLI format
  • .claude/skills/
    - Copilot会自动读取Claude的技能
  • CLAUDE.md
    - Copilot会读取该文件（如果存在）
  • GEMINI.md
    - Gemini CLI格式

Feature Details

功能详情

Custom Instructions (
copilot-instructions.md
)

自定义指令（
copilot-instructions.md
）

Root instructions auto-included in every request.
markdown
undefined
根目录指令会自动包含在每个请求中。
markdown
undefined

Project Guidelines

项目指南

  • Use TypeScript for all new files
  • Follow BEM naming for CSS classes
undefined
  • 所有新文件使用TypeScript编写
  • CSS类遵循BEM命名规范
undefined

Path-Scoped Instructions (
.github/instructions/
)

路径范围指令（
.github/instructions/
）

Apply to specific file patterns via 
applyTo
:
yaml
---
applyTo: "src/Services/**/*.cs"
excludeAgent: ["code-review"] # Optional: exclude specific agents
---
通过
applyTo
应用到特定文件模式：
yaml
---
applyTo: "src/Services/**/*.cs"
excludeAgent: ["code-review"] # 可选：排除特定Agent
---

Backend C# Guidelines

后端C#开发指南

Use PlatformValidationResult for validation...
undefined
Use PlatformValidationResult for validation...
undefined

Prompts (
.github/prompts/
)

提示词（
.github/prompts/
）

Reusable via 
/prompt-name
in chat:
yaml
---
mode: agent # Optional: agent, chat, edit
---
在聊天中通过
/prompt-name
调用：
yaml
---
mode: agent # 可选：agent、chat、edit
---

Debug this issue

调试此问题

  1. Analyze the error
  2. Find root cause
  3. Propose fix
undefined
  1. 分析错误信息
  2. 定位根本原因
  3. 提出修复方案
undefined

Agent Skills (
.github/skills/
)

Agent技能（
.github/skills/
）

Folder structure with SKILL.md + bundled resources:
skills/my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/
包含SKILL.md及关联资源的文件夹结构：
skills/my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/

Chat Modes (
.github/chatmodes/
)

聊天模式（
.github/chatmodes/
）

Custom chat personalities with tool restrictions:
yaml
---
name: security-reviewer
tools: ["read", "grep", "glob"] # Restrict tools
---
带工具限制的自定义聊天个性：
yaml
---
name: security-reviewer
tools: ["read", "grep", "glob"] # 限制可用工具
---

Security Review Mode

安全审查模式

Focus only on security vulnerabilities...
undefined
仅关注安全漏洞...
undefined

Agents (
.github/agents/
)

Agent（
.github/agents/
）

Specialized agent definitions:
yaml
---
name: frontend-developer
description: UI/UX implementation specialist
---
专业化的Agent定义：
yaml
---
name: frontend-developer
description: UI/UX实现专家
---

Frontend Developer Agent

前端开发Agent

Specializes in React, TypeScript, CSS...
undefined
专注于React、TypeScript、CSS...
undefined

Sync Patterns

同步模式

Patterns for keeping Claude Code and GitHub Copilot configurations synchronized.
保持Claude Code和GitHub Copilot配置同步的模式。

Skill Sync

技能同步

Both platforms support skills in 
.github/skills/
. Copilot also reads 
.claude/skills/
.
Best Practice: Create skills in 
.github/skills/
for maximum compatibility.
.github/skills/my-skill/
├── SKILL.md          # Both platforms read
├── scripts/          # Executable scripts
├── references/       # Progressive disclosure docs
└── assets/           # Templates, images
两个平台均支持
.github/skills/
中的技能。Copilot还会读取
.claude/skills/
中的内容。
最佳实践： 在
.github/skills/
中创建技能，以获得最大兼容性。
.github/skills/my-skill/
├── SKILL.md          # 两个平台均可读取
├── scripts/          # 可执行脚本
├── references/       # 渐进式披露文档
└── assets/           # 模板、图片

Prompt/Command Sync

提示词/命令同步

Claude CodeGitHub Copilot
.claude/skills/my-cmd.md
.github/prompts/my-cmd.prompt.md
Invoked via 
/my-cmd
Invoked via 
/my-cmd
or 
#prompt:my-cmd
Sync Strategy:
  1. Create in 
    .github/prompts/
    (both read)
  2. Or maintain duplicates if behavior differs
Claude CodeGitHub Copilot
.claude/skills/my-cmd.md
.github/prompts/my-cmd.prompt.md
通过
/my-cmd
调用		通过
/my-cmd
或
#prompt:my-cmd
调用
同步策略：
  1. 在
    .github/prompts/
    中创建（两个平台均可读取）
  2. 如果行为不同，则维护两份配置

Instructions Sync

指令同步

Claude CodeGitHub Copilot
CLAUDE.md
(root)
.github/copilot-instructions.md
Single fileMulti-file with 
applyTo
patterns
Sync Strategy:
  1. Keep core rules in both files
  2. Use 
    .github/instructions/
    for path-scoped rules (Copilot-specific)
  3. Reference detailed docs from both files
Claude CodeGitHub Copilot
CLAUDE.md
（根目录）
.github/copilot-instructions.md
单文件形式支持applyTo规则的多文件形式
同步策略：
  1. 在两个文件中保留核心规则
  2. 使用
    .github/instructions/
    配置路径范围规则（Copilot专属）
  3. 在两个文件中引用详细文档

Agent Sync

Agent同步

Both platforms read 
.github/agents/*.md
.
Single Source: Maintain agents in 
.github/agents/
only.
两个平台均读取
.github/agents/*.md
。
单一数据源： 仅在
.github/agents/
中维护Agent配置。

Workflow Sync

工作流同步

Claude has workflow orchestration. Copilot uses chat modes.
Claude WorkflowCopilot Equivalent
Sequential agent chainsChat mode switching
.claude/workflows/
.github/chatmodes/
Claude支持工作流编排，Copilot使用聊天模式。
Claude工作流Copilot等效功能
顺序Agent链聊天模式切换
.claude/workflows/
.github/chatmodes/

Decision Matrix

决策矩阵

FeatureLocationReason
Skills
.github/skills/
Maximum compatibility
Prompts
.github/prompts/
Both platforms read
Agents
.github/agents/
Shared location
InstructionsBoth filesPlatform-specific nuances
Workflows
.claude/workflows/
Claude-specific
Chat Modes
.github/chatmodes/
Copilot-specific
功能存储位置原因
技能
.github/skills/
最大兼容性
提示词
.github/prompts/
两个平台均可读取
Agent
.github/agents/
共享存储位置
指令两个文件平台特定差异
工作流
.claude/workflows/
Claude专属
聊天模式
.github/chatmodes/
Copilot专属

Common Sync Tasks

常见同步任务

Add New Skill

添加新技能

bash
mkdir -p .github/skills/new-skill
bash
mkdir -p .github/skills/new-skill

Create SKILL.md with frontmatter

创建带前置元数据的SKILL.md

Add references/ and scripts/ as needed

根据需要添加references/和scripts/

undefined
undefined

Add New Prompt

添加新提示词

bash
undefined
bash
undefined

Create in .github/prompts/ for both platforms

在.github/prompts/中创建，供两个平台使用

touch .github/prompts/new-prompt.prompt.md
undefined
touch .github/prompts/new-prompt.prompt.md
undefined

Update Core Instructions

更新核心指令

  1. Edit 
    CLAUDE.md
  2. Edit 
    .github/copilot-instructions.md
  3. Keep essential rules in sync
  1. 编辑
    CLAUDE.md
  2. 编辑
    .github/copilot-instructions.md
  3. 保持核心规则同步

Add Path-Scoped Instructions (Copilot)

添加路径范围指令（Copilot专属）

bash
undefined
bash
undefined

Copilot-specific feature

Copilot专属功能

touch .github/instructions/backend-cqrs.instructions.md
touch .github/instructions/backend-cqrs.instructions.md

Add applyTo: "src/Services/**/Command.cs"

添加applyTo: "src/Services/**/Command.cs"

undefined
undefined

Sync Process

同步流程

Step 1: Understand Current Setup

步骤1：了解当前配置

Read these files to understand current configuration:
.claude/workflows/orchestration-protocol.md
.claude/workflows/primary-workflow.md
.github/copilot-instructions.md
.github/AGENTS.md
CLAUDE.md
读取以下文件以了解现有配置：
.claude/workflows/orchestration-protocol.md
.claude/workflows/primary-workflow.md
.github/copilot-instructions.md
.github/AGENTS.md
CLAUDE.md

Step 2: Research Latest Features

步骤2：研究最新功能

Search web for:
  • "GitHub Copilot features setup 2026"
  • "GitHub Copilot custom instructions agents skills prompts"
  • "GitHub Copilot agent mode workspace context"
See the GitHub Copilot Features Catalog section above for the full feature catalog.
搜索以下内容：
  • "GitHub Copilot features setup 2026"
  • "GitHub Copilot custom instructions agents skills prompts"
  • "GitHub Copilot agent mode workspace context"
可参考上方的GitHub Copilot功能目录获取完整的功能信息。

Step 3: Identify Sync Opportunities

步骤3：识别同步机会

Compare capabilities and identify gaps:
  • Skills missing in one platform
  • Inconsistent prompt/instruction behavior
  • Agent definitions that differ
对比功能差异，找出需要同步的内容：
  • 某一平台缺失的技能
  • 不一致的提示词/指令行为
  • 存在差异的Agent定义

Step 4: Implement Changes

步骤4：实施变更

For each change:
  1. Skills: Create in both 
    .claude/skills/
    and 
    .github/skills/
  2. Prompts: Create in both 
    .claude/skills/
    and 
    .github/prompts/
  3. Instructions: Update both 
    CLAUDE.md
    and 
    .github/copilot-instructions.md
  4. Agents: Update 
    .github/agents/
    (shared by both)
针对每一项变更：
  1. 技能：在
    .claude/skills/
    和
    .github/skills/
    中同时创建
  2. 提示词：在
    .claude/skills/
    和
    .github/prompts/
    中同时创建
  3. 指令：更新
    CLAUDE.md
    和
    .github/copilot-instructions.md
  4. Agent：更新
    .github/agents/
    （两个平台共享）

Compatibility Notes

兼容性说明

  • Copilot reads 
    .claude/skills/
    automatically (backward compatibility)
  • Both read 
    .github/prompts/*.prompt.md
  • Both read 
    .github/agents/*.md
  • Both read 
    AGENTS.md
    in root or 
    .github/
  • Both support path-based instruction files via 
    applyTo
    in frontmatter
  • Copilot会自动读取
    .claude/skills/
    （向后兼容）
  • 两个平台均读取
    .github/prompts/*.prompt.md
  • 两个平台均读取
    .github/agents/*.md
  • 两个平台均读取根目录或
    .github/
    中的
    AGENTS.md
  • 两个平台均支持通过前置元数据中的
    applyTo
    配置基于路径的指令文件

Sources

参考来源

IMPORTANT Task Planning Notes

重要任务规划说明

  • Always plan and break many small todo tasks
  • Always add a final review todo task to review the works done at the end to find any fix or enhancement needed
  • 始终将任务拆分为多个小的待办项
  • 始终在最后添加一个最终审核待办项，用于检查已完成的工作，找出需要修复或优化的内容