Fastexcel
npx -y skills add chengliang4810/jimuqu-skills --skill fastexcelAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
辅助开发、配置、调试和解释 FastExcel / cn.idev.excel Excel 读写库。只要用户提到 FastExcel、cn.idev.excel、EasyExcel、@ExcelProperty、ExcelReader、ExcelWriter、ReadListener、AnalysisEventListener、Converter、ReadCellData、WriteCellData、WriteSheet、FillConfig、FillWrapper、模板填充、Excel 导入导出、下拉框、合并单元格、大数值精度、ExcelDataConvertException，或需要根据 FastExcel 官方开源仓库确认 API 与行为，都必须使用此技能。此技能只记录通用 FastExcel 能力，不写入某个业务项目的专属规范。
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
4.4 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it
FastExcel 开发技能
你在辅助 FastExcel（cn.idev.excel:fastexcel）相关开发、导入导出、模板填充、自定义转换器和问题排查。本技能基于官方开源仓库和项目真实用法整理；若目标项目版本不同，先以目标项目版本为准。
官方仓库：https://github.com/fast-excel/fastexcel
首要原则
- 先判定任务类型：写 Excel、读 Excel、同步小数据读取、监听器大数据读取、自定义 Converter、样式/列宽/合并、模板填充、多 sheet、多表、CSV、异常处理或安全排查。
- 优先查证源码：不确定的 builder 方法、注解属性、监听器生命周期、Converter 方法签名、资源关闭行为，必须查官方仓库或当前项目依赖版本的源码。
- 不要混用 Hutool Excel / Apache POI / EasyExcel 旧包名：当前库包名是
cn.idev.excel，工厂类EasyExcel实际继承FastExcelFactory。 - 资源必须关闭：
ExcelReader、ExcelWriter都有finish()/close()；doRead/doWrite/doReadSync会 finish，但手动 build 的 writer/reader 要显式 finish 或 try-with-resources。 - 导入默认流式监听优先：大文件不要
doReadSync()一次性读入内存；监听器内分批处理。 - 安全边界：导入限制文件大小/行列数；导出注意公式注入；大数值要防 Excel 15 位精度丢失；模板和文件路径不要接受不可信路径。
资料入口
按任务读取对应 reference，必要时再读官方仓库或当前项目依赖源码：
- 源码结构与核心 API：
references/source-map.md - 写 Excel 与模板填充：
references/write-fill.md - 读 Excel 与监听器：
references/read-listener.md - 注解、Converter、样式与处理器：
references/annotation-converter-style.md - 排查与安全注意：
references/debugging-security.md
工作流
写 Excel
- 确认输出目标：文件、路径、
OutputStream。 - 确认 head 类和字段注解：
@ExcelProperty(value/index/order/converter)。 - 简单单 sheet 用
EasyExcel.write(...).sheet(name).doWrite(data)。 - 多 sheet/模板/多次写入用
ExcelWriter writer = EasyExcel.write(...).build()+WriteSheet，最后finish()。 - 需要样式、列宽、合并、下拉框时注册对应 WriteHandler。
读 Excel
- 小文件可
doReadSync()，大文件用AnalysisEventListener或ReadListener。 - 确认 head 类、sheetNo/sheetName、header 行数、numRows 限制。
- 在 listener 中处理
invokeHeadMap、invoke、onException、doAfterAllAnalysed。 - 转换异常优先看
ExcelDataConvertException的 rowIndex/columnIndex。
自定义 Converter
- 实现
Converter<T>。 - 返回
supportJavaTypeKey()和supportExcelTypeKey()。 - 实现
convertToJavaData(...)和/或convertToExcelData(...)。 - 字段级指定：
@ExcelProperty(converter = XxxConverter.class)；全局注册用 builderregisterConverter(...)。
常用查证命令
# 在 https://github.com/fast-excel/fastexcel 克隆仓库根目录执行
# 核心 API
rg "class FastExcelFactory|class EasyExcel|class ExcelWriter|class ExcelReader" fastexcel/src/main/java/cn/idev/excel
# 注解、Converter、监听器
rg "@interface ExcelProperty|interface Converter|interface ReadListener|class AnalysisEventListener" fastexcel/src/main/java/cn/idev/excel
输出规范
- 全程中文；Java 类名、方法名和注解保持原样。
- 涉及源码机制时引用
path:line。 - 不确定时说“源码中未确认”，不要套 Alibaba EasyExcel 旧版本或 Hutool POI API。
- 代码示例要包含资源关闭、异常处理和大文件边界。
- 安全相关默认提醒：导入限大小/行数、导出防公式注入、大数值转字符串、模板路径可信。