Sculpt Code 是一个用于重塑代码质量的技能,适用于任何编程语言。默认审查范围为分支改动(git diff main...HEAD),也支持暂存改动或用户显式指定的文件与目录;范围不明确时会先询问。它会先完整读取所有变更文件,理解现有代码模式,再按八个维度逐项检查,并对每条发现标注 file_path:line_number。八个维度包括:删除真正未使用的导入、函数、类等并先在代码库中搜索确认;命名需体现意图并遵循仓库既有约定;函数超过约 50 行、文件超过约 400 行时考虑拆分;嵌套最多 3 层,用提前返回和守卫条件扁平化;采用语言原生与仓库既有模式;识别重复实现并复用已有辅助函数;整理 TODO,使用项目规定的 TODO_IMPROVE、TODO_OPTIMIZE、TODO_TECHDEBT、FIXME、HACK 等前缀,每条注明 What 与 Why;降低可读性与认知负担,注释只解释为什么,保留 IMPORTANT、NOTE、CRITICAL、DEV_NOTE 标记。Python 代码库还会加载 references/python.md。它直接应用修改,而非只生成报告,最后按文件列出改动并给出总结。限制:不改变可工作的抽象、类型提示、测试代码,以及团队有意使用的领域模式;除明确要求外必须保留原有业务逻辑。
cmd-sculpt-code
通用与其它
更新于 10-16 02:37