Skip to content

Comments

feat(skill): add migration skill for transitioning from FastExcel to Fesod#858

Merged
psxjoy merged 3 commits intoapache:mainfrom
alaahong:feature/migration_skill_202602
Feb 22, 2026
Merged

feat(skill): add migration skill for transitioning from FastExcel to Fesod#858
psxjoy merged 3 commits intoapache:mainfrom
alaahong:feature/migration_skill_202602

Conversation

@alaahong
Copy link
Member

@alaahong alaahong commented Feb 20, 2026

Purpose of the pull request

This commit introduces a new skill that facilitates the migration of Java projects from FastExcel 1.3 to Apache Fesod. The skill provides detailed instructions for updating dependencies, renaming packages, and handling breaking changes.
Related: #857

As Skill is an open standard for mostly IDE, so raise this as common upgrade script.

Here is one screenshot since Skill ran:
image

below is the sample upgrade result:
alaahong/fastexcel-legacy-demo@d0e6abf

What's changed?

  • Supports both legacy namespaces: cn.idev.excel.* and org.apache.fesod.excel.*
  • Implements a three-phase migration process for gradual updates
  • Includes comprehensive documentation for developers

Checklist

  • I have read the Contributor Guide.
  • I have written the necessary doc or comment.
  • I have added the necessary unit tests and all cases have passed.

…Fesod

This commit introduces a new skill that facilitates the migration of
Java projects from FastExcel 1.3 to Apache Fesod. The skill provides
detailed instructions for updating dependencies, renaming packages,
and handling breaking changes.

- Supports both legacy namespaces: cn.idev.excel.* and
  org.apache.fesod.excel.*
- Implements a three-phase migration process for gradual updates
- Includes comprehensive documentation for developers
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a comprehensive migration skill document to facilitate the transition of Java projects from FastExcel 1.3 (cn.idev.excel:fastexcel:1.3.0) to Apache Fesod 2.0.1-incubating. The skill provides detailed, phase-by-phase instructions for updating dependencies, renaming packages, and handling the breaking changes introduced when the library was donated to the Apache Software Foundation. The migration path is designed to be gradual, allowing developers to stop after each phase and run tests.

Changes:

  • Added a 433-line migration skill document in .github/skills/fastexcel-to-fesod/SKILL.md
  • Documented 5 migration phases: dependency swap, package import rename, entry class rename, CGLIB class name updates, and encoding safety
  • Included comprehensive import mapping tables covering core classes, read/write APIs, handlers, annotations, converters, enums, exceptions, and metadata

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Replaced deprecated FastExcel import statements with their Fesod
equivalents in the SKILL.md documentation. This change ensures
consistency and clarity in the migration process.

- Removed unused imports
- Updated documentation to reflect new import paths
…WriteBasicParameter

Updated the import statements in SKILL.md to replace
references to cn.idev.excel with org.apache.fesod for
ReadBasicParameter and WriteBasicParameter.

This change aligns the code with the new Fesod package structure.
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@psxjoy psxjoy merged commit 9866d26 into apache:main Feb 22, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants