Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →中文代码注释规范与自动生成,支持 Python/JavaScript/Go/Java 多语言
| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-07 | ✗→✓ | ▲ Improved | 27% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 17% | 0% |
| case-15 | ✗→✓ | ▲ Improved | 45% | 0% |
| case-17 | ✗→✓ | ▲ Improved | 30% | 0% |
| case-19 | ✗→✓ | ▲ Improved | -51% | 0% |
提供多语言代码注释规范,确保代码可读性和可维护性。支持 Python(docstring)、JavaScript(JSDoc)、Go、Java 等语言。
函数注释包含:功能描述、Args(参数名/类型/说明)、Returns(返回值类型/说明)、Raises(异常)、Example(示例)。
使用 @param/@returns/@throws 标签,支持类型推断。
| 问题 | 原因 | 解决方案 | |------|------|---------| | 注释与代码不一致 | 修改代码未更新注释 | CI 检查注释同步 | | 过度注释 | 注释显而易见的代码 | 只注释复杂逻辑 | | 注释风格不统一 | 无规范约束 | 使用 lint 工具检查 | | 缺少参数说明 | 偷懒省略 | CI 强制 docstring |
Other measured skills in the registry, with their headline benchmark lift.