用途:对代码库进行深度分析,理解其中的代码模式、架构与实现细节。该命令通过 codebase-analyst 智能体完成分析,属于只读操作,侧重于理解而非修改代码。
主要能力:跨文件识别模式;分析架构,包括依赖、结构、分层;探索实现细节,了解代码如何工作;分析横切关注点,如错误处理、日志、认证;识别技术债务。
使用方式:根据参数决定分析范围。若提供主题或概念(如 authentication、error handling),查找相关代码并分析模式、实现与一致性,识别入口点、数据流和依赖;若提供目录或路径(如 src/components/),分析该模块的架构与结构、使用的模式和约定,并梳理内部依赖;若提供问题(如 how does the API handle errors?),研究并回答架构问题,给出代码引用与示例,解释设计决策;若不带参数,给出高层代码库概览,识别主要模块及关系,突出关键模式与约定。
调用示例(保持原样): /code-quality:analyze authentication /code-quality:analyze "error handling patterns" /code-quality:analyze "how API endpoints work" /code-quality:analyze src/components/ /code-quality:analyze "the database layer" /code-quality:analyze "how does caching work in this codebase?" /code-quality:analyze "what design patterns are used?" /code-quality:analyze
输出格式:智能体按 Analysis: [Topic/Scope] 结构返回结果,包含 Overview 高层摘要、Key Patterns 关键模式及位置、Architecture 结构层次依赖、Code References 代码引用(path/to/file.ext:line 及说明)、Recommendations 理解或改进建议。
适用场景:快速理解陌生代码库、定位某概念的全部相关实现、梳理模块架构与依赖、回答架构问题、识别技术债务。
限制:仅做只读分析,不修改代码;需要 codebase-analyst 智能体支持;实际分析范围与深度取决于提供的参数;资料未提供安装方式、收费、价格及平台等信息。