SuperAPI AI 工具集

file-name-wizard

编程与开发

查看项目

更新于 10-16 05:04

技能介绍

用途:对代码库中所有文件名和命名约定进行系统性审计,找出不一致、反模式及违反命名标准之处。它只做审计,不重命名文件。

主要能力:先用 Glob 找出源码、配置、文档、测试等全部文件并建立待办清单;读取根目录及各目录的 AGENTS.md,提取显式命名规则(文件名模式、目录结构、组件/工具/测试/配置/常量命名等),并识别目录内的隐式惯例与分组模式(如 *.service.ts)。随后逐文件分析:当前命名约定、是否描述清晰、是否符合显式与隐式标准,并读取文件内容核验名称与内容是否匹配。问题分类包括大小写错误、混用约定、模糊或误导性名称、临时/迁移/版本后缀等反模式、放错目录或缺少分组后缀等组织问题。

使用方式:作为代理技能触发,用户要求检查命名约定时运行。流程分阶段:发现与标准提取、逐文件审计并记录(文件、现用约定、应为约定、问题、建议名称、严重度)、模式分析(系统性问题、离群文件、缺失标准)、生成报告,最后按手册创建带 audit 标签的 tk 工单,并向用户给出简要摘要。

报告结构:包含执行摘要、按严重度(CRITICAL/HIGH/MEDIUM/LOW)与按目录分组的问题、模式分析、AGENTS.md 覆盖情况、统计(按问题类型、严重度、文件类型)及详细文件列表。

适用场景:需要统一大型或多人协作代码库命名风格、补充缺失的命名文档、或在重构前摸清命名债务时。

限制:仅审计,绝不编辑或重命名文件;不跳过待办清单中的任何文件;结论依赖 AGENTS.md 与已有惯例,若仓库缺少相关文档则只能给出建议标准。具体支持的框架细节和输出格式以技能定义为准。