SuperAPI AI 工具集

codebase-research

写作与研究

查看项目

更新于 10-16 02:32

技能介绍

用途:在现有项目里新增功能、文件、组件、模块或服务前,先研究代码库中已有的实现与约定,确保新代码与项目保持一致。核心原则是“未先理解现有代码,不写新代码”。

主要能力:搜索相似文件、函数、导入依赖、错误处理、命名规范、文件组织、测试模式与配置方式;分析命名、结构、状态管理、校验、日志、导出方式等约定;在无先例时,先确认确实不存在,再有意建立新约定并记录理由。

使用方式:按“搜索→分析→匹配→构建”流程执行。先扫描相关目录,用 glob 找相似文件,用 grep 查模式与导入,查看测试文件;写新代码前至少审阅 2 个相似文件。找到模板后,复制其结构、替换领域细节,并对照模板检查一致性。若确实无先例,至少用 3 种方式确认,可参考外部仓库,但新约定需与项目整体风格一致。

适用场景:向已有代码库添加功能、创建新文件或模块、实现可能已存在的模式、为现有功能写测试、添加错误处理/日志/校验逻辑;尤其适合已有架构模式、自定义工具、命名规范或测试约定的项目。

限制:资料未提供具体安装命令、平台支持、收费方式或效果数据。该技能不替代重构任务,也不应因个人偏好引入新库或新结构;若项目已有等价实现,应优先复用。