用途:依据 Li 等人(2026)的 ExpSum 框架,让 Claude 生成满足工业文档标准的代码摘要,适用于编写 JSDoc、Javadoc、docstring、头注释,以及模块或包级别的批量摘要生成,尤其适合已有自动生成文档被认为“太泛”或不符风格、需要统一术语与分类的 API 文档场景。
主要能力:四阶段流水线。一,将函数建模为结构化元数据(签名、参数与类型、返回类型、文件路径、包名、依赖、控制流骨架、I/O 模式),并过滤占位参数(如 arg0、param1、_)、未知类型和停用词条目。二,用级联知识检索,将函数所在包上下文与项目知识库匹配,提取领域术语(如 RDBStore、AbilityContext、BundleInfo),按 TF-IDF 余弦相似度排序,并去除 75% 以上词元重叠的近重复术语。三,将函数分为五类:字段、过程、构造/工厂、回调/处理器、工具,并套用对应模板。四,按目标格式输出,仅在类型未表达时补充 @param、@returns、@throws。作者称在 HarmonyOS 工业基准上 BLEU-4 提升 26.7%、ROUGE-L 提升 20.1%,并援引研究称超 57% 的先进 LLM 摘要被专家拒收。
使用方式:当用户要求文档化函数、方法或类,或指出现有自动生成文档过于通用、不符风格时触发;按上述步骤提取、过滤、检索、分类、起草、校验并格式化。
限制:依赖已有的包文档、README 或 API 参考作为领域术语来源,全新代码库的术语检索素材有限;分类依赖命名与签名惯例,非约定命名可能误判需人工修正;面向函数/方法级摘要,类级或模块级文档需要额外架构上下文;动态类型且无类型提示的语言信号更弱。分类模糊时按名称与调用方意图选择主要类别。资料暂未提供安装命令或收费信息。