GitHub Copilot 代码迁移指令生成器 | 自动分析代码演进与生成转换规则
generate-custom-instructions-from-codebase by github/awesome-copilot
安装命令
npx skills add https://github.com/github/awesome-copilot --skill generate-custom-instructions-from-codebase🇨🇳中文介绍
迁移与代码演进指令生成器
配置变量
${MIGRATION_TYPE="Framework Version|Architecture Refactoring|Technology Migration|Dependencies Update|Pattern Changes"}
<!-- 迁移或演进类型 -->
${SOURCE_REFERENCE="branch|commit|tag"}
<!-- 源参考点（迁移前状态） -->
${TARGET_REFERENCE="branch|commit|tag"}
<!-- 目标参考点（迁移后状态） -->
${ANALYSIS_SCOPE="Entire project|Specific folder|Modified files only"}
<!-- 分析范围 -->
${CHANGE_FOCUS="Breaking Changes|New Conventions|Obsolete Patterns|API Changes|Configuration"}
<!-- 变更的主要关注点 -->
${AUTOMATION_LEVEL="Conservative|Balanced|Aggressive"}
<!-- Copilot 建议的自动化级别 -->
${GENERATE_EXAMPLES="true|false"}
<!-- 是否包含转换示例 -->
${VALIDATION_REQUIRED="true|false"}
<!-- 应用前是否需要验证 -->
生成的提示词
"分析两个项目状态之间的代码演进，为 GitHub Copilot 生成精确的迁移指令。这些指令将指导 Copilot 在未来修改期间自动应用相同的转换模式。请遵循以下方法：
### 第一阶段：对比状态分析
#### 结构变更检测
- 比较 ${SOURCE_REFERENCE} 和 ${TARGET_REFERENCE} 之间的文件夹结构
- 识别移动、重命名或删除的文件
- 分析配置文件中的变更
- 记录新增和移除的依赖项
#### 代码转换分析
${MIGRATION_TYPE == "Framework Version" ?
"- 识别框架版本间的 API 变更
- 分析正在使用的新功能
- 记录已废弃的方法/属性
- 注意语法或约定变更" : ""}
${MIGRATION_TYPE == "Architecture Refactoring" ?
"- 分析架构模式变更
- 识别引入的新抽象
- 记录职责重组
- 注意数据流变更" : ""}
${MIGRATION_TYPE == "Technology Migration" ?
"- 分析一种技术被另一种技术替换的情况
- 识别功能等价性
- 记录 API 和语法变更
- 注意新的依赖项和配置" : ""}
#### 转换模式提取
- 识别已应用的重复性转换
- 分析从旧格式到新格式的转换规则
- 记录例外情况和特殊情况
- 创建前后对应矩阵
### 第二阶段：迁移指令生成
创建一个 `.github/copilot-migration-instructions.md` 文件，结构如下：
\`\`\`markdown
# GitHub Copilot 迁移指令
## 迁移上下文
- **类型**: ${MIGRATION_TYPE}
- **从**: ${SOURCE_REFERENCE}
- **到**: ${TARGET_REFERENCE}
- **日期**: [GENERATION_DATE]
- **范围**: ${ANALYSIS_SCOPE}
## 自动转换规则
### 1. 强制转换
${AUTOMATION_LEVEL != "Conservative" ?
"[AUTOMATIC_TRANSFORMATION_RULES]
- **旧模式**: [OLD_CODE]
- **新模式**: [NEW_CODE]
- **触发条件**: 何时检测到此模式
- **操作**: 自动应用的转换" : ""}
### 2. 需要验证的转换
${VALIDATION_REQUIRED == "true" ?
"[TRANSFORMATIONS_WITH_VALIDATION]
- **检测到的模式**: [DESCRIPTION]
- **建议的转换**: [NEW_APPROACH]
- **所需验证**: [VALIDATION_CRITERIA]
- **替代方案**: [ALTERNATIVE_OPTIONS]" : ""}
### 3. API 对应关系
${CHANGE_FOCUS == "API Changes" || MIGRATION_TYPE == "Framework Version" ?
"[API_CORRESPONDENCE_TABLE]
| 旧 API | 新 API | 备注 | 示例 |
| --------- | --------- | --------- | -------------- |
| [OLD_API] | [NEW_API] | [CHANGES] | [CODE_EXAMPLE] | " : ""} |
### 4. 需要采用的新模式
[DETECTED_EMERGING_PATTERNS]
- **模式**: [PATTERN_NAME]
- **使用场景**: [WHEN_TO_USE]
- **实现方式**: [HOW_TO_IMPLEMENT]
- **优势**: [ADVANTAGES]
### 5. 需要避免的过时模式
[DETECTED_OBSOLETE_PATTERNS]
- **过时模式**: [OLD_PATTERN]
- **避免原因**: [REASONS]
- **替代方案**: [NEW_PATTERN]
- **迁移步骤**: [CONVERSION_STEPS]
## 文件类型特定指令
${GENERATE_EXAMPLES == "true" ?
"### 配置文件
[CONFIG_TRANSFORMATION_EXAMPLES]
### 主要源文件
[SOURCE_TRANSFORMATION_EXAMPLES]
### 测试文件
[TEST_TRANSFORMATION_EXAMPLES]" : ""}
## 验证与安全
### 自动控制点
- 每次转换后需要执行的验证
- 验证变更需要运行的测试
- 需要监控的性能指标
- 需要执行的兼容性检查
### 人工介入
需要人工干预的情况：
- [COMPLEX_CASES_LIST]
- [ARCHITECTURAL_DECISIONS]
- [BUSINESS_IMPACTS]
## 迁移监控
### 跟踪指标
- 自动迁移的代码百分比
- 需要人工验证的数量
- 自动转换的错误率
- 每个文件的平均迁移时间
### 错误报告
如何向 Copilot 报告错误的转换：
- 改进规则的反馈模式
- 需要记录的例外情况
- 需要对指令进行的调整
\`\`\`
### 第三阶段：上下文示例生成
${GENERATE_EXAMPLES == "true" ?
"#### 转换示例
为每个识别出的模式生成：
\`\`\`
// 迁移前 (${SOURCE_REFERENCE})
[OLD_CODE_EXAMPLE]
// 迁移后 (${TARGET_REFERENCE})
[NEW_CODE_EXAMPLE]
// COPILOT 指令
当您看到此模式 [TRIGGER] 时，请按照以下步骤将其转换为 [NEW_PATTERN]: [STEPS]
\`\`\`" : ""}
### 第四阶段：验证与优化
#### 指令测试
- 在测试代码上应用指令
- 验证转换的一致性
- 根据结果调整规则
- 记录例外情况和边界情况
#### 迭代优化
${AUTOMATION_LEVEL == "Aggressive" ?
"- 优化规则以最大化自动化
- 减少检测中的误报
- 提高转换准确性
- 记录经验教训" : ""}
### 最终结果
使 GitHub Copilot 能够：
1. **自动应用** 未来修改期间相同的转换
2. **保持一致性** 与新采用的约定
3. **避免过时模式** 通过自动提供替代方案
4. **加速未来迁移** 通过利用已获得的经验
5. **减少错误** 通过自动化重复性转换
这些指令将 Copilot 转变为智能迁移助手，能够一致且可靠地重现您的技术演进决策。
"
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
