用途:该技能用于给 Java 代码补充注释,覆盖类注释、方法注释与字段注释,帮助完善代码文档。当用户提到给 Java 代码添加注释、生成 JavaDoc、添加类/方法/属性注释、文档注释等关键词时触发,支持中英文口令。
主要能力:可处理 Controller、Service、ServiceImpl、Application Service、Domain Service、Feign 服务接口、Mapper、Model、Entity、BO、DTO、VO、DAO、Repository、Configuration、Component、Utility、Exception 等组件类型。支持两种注释标准:默认的标准 JavaDoc,以及严格的《JAVA 编程规范》格式(描述需用 <p> 包裹,@param 需声明参数类型,@return 需声明返回类型,@exception 需写完整包名)。技能内置模板与参考文档目录,如 templates/controller-comment-template.md、reference/javadoc-standards.md 等。
使用方式:按四步流程执行——先扫描代码库与相关文档建立整体理解;再让用户确认需注释的组件类型与注释层级;随后按组件类型生成待办清单,列出类名、方法名、字段名;最后按类注释→方法注释→属性注释的顺序执行,每完成一个类更新待办清单并展示进度。
适用场景:为现有 Java 项目批量补充规范注释、生成 JavaDoc、统一团队注释风格。
限制:只添加注释、不改动代码逻辑;具体模板细节与示例需参考技能内目录文件。资料未提供安装命令、收费方式与平台信息。