用途:Clean Code 是一个原子技能(atomic skill),职责单一,用于代码质量分析与改进建议,具备幂等性。
主要能力:接收代码与语言参数,输出 quality_score(0-100)、issues(问题列表)、metrics(代码度量)与 suggestions(改进建议)。问题项包含类别、严重级别、位置、当前写法、建议写法与规则。度量包含代码行数、平均/最大函数长度、平均参数数、圈复杂度、命名得分与注释比例。规则覆盖命名(变量、函数、类、布尔值)与函数(长度、参数、嵌套层级)。
使用方式:输入需提供 code(必填,长度 1 至 100000)与 language(必填,支持 typescript、javascript、python、java、csharp、go、ruby、kotlin、rust、php)。可选 focus(naming、functions、comments、formatting,默认全选)、style_guide(如 airbnb、google、pep8)与 strictness(relaxed、normal、strict,默认 normal)。失败重试最多 3 次,指数退避,仅对 TIMEOUT 与 RATE_LIMIT 重试;INVALID_SYNTAX 与 UNSUPPORTED_LANGUAGE 不重试。
适用场景:代码审查、重构前评估、质量门禁与教学反馈。依赖 syntax_parser 与 metrics_calculator,可被 clean-code 绑定智能体与重构流程消费。
限制:仅支持上述语言;代码含语法错误时无法分析;具体收费、平台与效果暂未提供。