一、背景说明

Claude Code 作为终端端 AI 编程工具，在代码生成、问题排查和逻辑修改上有很不错的表现。但在实际项目开发过程中，原生版本存在一些通用性问题：

• 缺少对整体项目结构、文件依赖、函数调用关系的静态认知

• 处理代码需求时，依赖大量读取文件、检索内容，操作较为零散

• 不清楚历史代码风格与项目规范，生成的代码容易和现有项目脱节

• 修改代码时无法判断影响范围，容易产生隐性问题

为了解决这些使用上的不便，我基于 Claude Code 技能机制，自制了一套本地代码智能分析技能 Code Intelligence，用于辅助 AI 更好地理解本地项目，适配现有工程结构。

开源地址：https://github.com/SatelliteCoder/code-intelligence

二、项目定位

Code Intelligence 是一套运行在本地的静态代码分析脚本工具链，专门适配 Claude Code。

它不会替代 AI 生成能力，而是在 AI 执行编码、排错、重构操作前，提前完成项目信息采集与分析，让 AI 的操作更贴合项目本身的结构与规范。

所有分析流程均在本地完成，不向云端上传项目代码，保证本地代码安全性。

三、主要功能模块

这套技能覆盖了日常开发中最常用的七类场景，全程无需手动提供上下文，自动根据当前项目分析适配。

1. 智能代码编写适配

自动扫描项目目录结构、现有代码风格、模块分层逻辑。在编写新功能、新接口、新工具函数时，复用项目已有写法与架构习惯，保证新增代码和项目风格统一。

2. 错误与异常分析

结合本地预设的常见错误模式库，结合代码调用链路，辅助定位报错来源。相比于单纯根据报错文本猜测，能够结合项目实际代码逻辑给出更贴合的修复思路。

3. 代码重构与优化辅助

识别项目中常见的不规范代码结构，例如过长函数、深层嵌套、重复逻辑等。重构时优先采用最小改动原则，只优化问题代码，避免大范围无意义重写。

4. 自动化测试适配

自动识别项目当前使用的测试框架，根据函数结构、入参出参逻辑，生成适配项目风格的测试用例，减少手动写测试代码的重复工作。

5. 代码变更影响分析

分析指定函数、文件被哪些模块调用，梳理上下游依赖。在修改核心逻辑前，可以清晰看到变更影响范围，避免隐性 BUG。

6. 项目文档与代码解释

支持对单个函数、整个模块进行逻辑解释，同时可以批量生成注释、模块说明，适合项目整理、交接、归档场景。

7. 调试辅助建议

针对崩溃、超时、异步异常、内存问题等常见场景，给出对应的调试思路、断点位置和日志埋点建议，辅助快速定位问题。

四、技术实现特点

1. 纯标准库实现，无额外依赖

所有分析脚本基于 Python 标准库开发，无需安装第三方依赖包。只要本地具备 Python3.8+ 环境，即可直接运行，不污染项目环境，适配所有主流操作系统。

2. 基于 AST 语法树精准解析

针对 Python 代码采用原生 AST 语法树解析方式，替代传统正则匹配。可以精准识别函数定义、导入依赖、调用关系，不会被注释、字符串干扰，分析结果更稳定。

3. 本地安全沙箱限制

工具内置路径校验逻辑，严格限制仅能在当前项目目录内读取文件，自动忽略 .git、.env、密钥配置等敏感文件，避免隐私文件被意外读取，保障本地代码安全。

五、项目文件结构说明

项目内置多个独立的分析脚本，各司其职，既可以配合 Claude Code 自动运行，也可以单独执行：

• scan_structure.py：扫描项目结构，识别项目类型、核心目录与入口文件

• analyze_deps.py：分析文件之间的导入与依赖关系

• call_graph.py：生成项目内部函数调用关系

• refactor_suggestions.py：扫描不规范代码结构，给出重构建议

• test_framework_detect.py：自动识别项目测试框架

• error_patterns.json：通用错误场景库，用于辅助问题定位

六、安装使用方法

1. 一键安装（推荐）

在 Claude Code 会话内直接输入以下命令，即可自动部署加载技能：

/install https://github.com/SatelliteCoder/code-intelligence

2. 手动部署

将项目完整克隆至本地项目的 `.claude/skills/` 目录下即可：

git clone https://github.com/SatelliteCoder/code-intelligence.git .claude/skills/code-intelligence

3. 验证

重启 Claude Code，执行 /skills，列表中出现 code-intelligence 即代表加载成功。

七、总结

Claude Code 原生能力偏向“通用代码生成”，而这套 Code Intelligence 技能，主要用于补齐项目专属理解、结构分析、风格适配、风险校验的短板。

对于长期使用 Claude Code 进行项目开发、维护、重构的开发者来说，可以明显减少无效检索、风格不统一、盲目修改等问题，让 AI 编码更贴合个人与团队的实际项目习惯。

项目完全开源，后续会根据实际使用场景持续优化适配更多项目类型与开发场景，欢迎体验、交流、Star 支持。

开源地址：https://github.com/SatelliteCoder/code-intelligence