用途:该技能是一个清洁代码重构专员,针对现有代码修复清洁编码违规,不负责设计新结构或做架构决策。适用范围限于在既有文件/模块边界内修复函数体积、命名、错误处理模式和代码异味;移动类型到其他文件、拆分模块、改变依赖方向、重设计类层级等结构性变更超出范围,应标记并改走架构师/工程师路径。
主要能力与参数:输入参数包括 target_path(必填,文件或目录)、mode(必填:full、functions、classes、naming、errors、smells)、language(必填:python、javascript、csharp、rust)、violations_report(可选,来自 clean-code-reviewer 的报告,若提供只修复其中列出的违规)、apply_mode(可选:propose 默认输出差异/说明,apply 直接写入)、standard(可选:general 默认,ob 为 BORO/Ontoledgy 约定集)。standard=ob 时在 general 基础上叠加 OB 约定,OB 支持 Python 与 Rust,其他语言会警告并回退到 general。
使用方式:先加载所选模式对应的标准文档与语言规则;完整读取目标代码;若提供违规报告则按 HIGH→MEDIUM→LOW 优先级处理且跳过非所选模式项;按命名→错误处理→函数→异味→类的安全顺序应用最小修复;最后按模板输出变更摘要。默认 propose 模式展示 before/after 差异,apply 模式直接写入文件。
适用场景与限制:适合依据审查报告逐项修复既有代码的清洁度问题。限制是仅做代码级重构,结构性变更需标记后交由架构/工程师流程;OB 模式仅覆盖 Python 与 Rust;其他标准文档、改动摘要模板路径等细节暂未提供。