用途:这是一个面向公共 API 文档的文档注释编辑技能,用于根据用户请求在合适位置更新代码中的文档注释。
主要能力与规则:修改前需获取并审阅相关代码上下文(即实现源代码);任何情况下都不能更改公共 API 的命名或签名;注释中不得出现 VS Code、Visual Studio Code 或类似产品术语(会触发 lint 错误);遵循美式英语语法、拼写与标点;摘要与描述注释尽量用完整句子并以句号结尾;尽可能合理地使用 {@link <symbol>} 引用代码符号,若 @link 带自定义标签则保留该标签,例如 {@link Uri address} 中的 address;对注释中的代码元素和关键字使用代码格式,例如 undefined;注释每行最长 120 个字符。
Cleanup 模式:当用户以 cleanup 作为提示要求“清理”文档注释时,只能修复语法、标点、格式和拼写错误,不得新增、删除或扩充现有注释。
限制:资料未提供具体安装命令、平台支持范围或收费信息。