Code Intelligence Custom Skills for Claude Code

全周期代码智能助手定制 Skills。本项目提供了一套专为 Claude Code 设计的本地化脚本工具集，旨在赋予大语言模型（LLM）更强大的本地代码库感知、结构扫描、依赖分析和安全重构能力。

✨ 核心能力

通过这些定制脚本，Claude Code 可以实现以下 7 大智能操作：

能力维度	触发词示例	执行逻辑与底层脚本
代码编写	“实现”、“添加”、“创建”	结合 scan_structure.py 获取项目全貌，参考自定义风格生成代码。
错误诊断	“报错”、“bug”、“异常”	匹配 error_patterns.json 模式库，结合堆栈信息输出根因及修复建议。
代码重构	“重构”、“优化”、“升级”	使用 refactor_suggestions.py 识别长函数、深嵌套等代码异味。
测试生成	“生成测试”、“单元测试”	通过 test_framework_detect.py 自动识别当前项目的测试框架并生成对应测试。
影响分析	“影响分析”、“谁调用了”	运行 call_graph.py 和 analyze_deps.py 提取函数调用图和依赖树。
文档生成	“生成文档”、“解释代码”	扫描文件树并生成符合标准（如 Google Docstring）的代码注释或架构文档。
调试辅助	“怎么调试”、“加断点”	基于框架类型提供原生的调试命令（如 pdb, node --inspect 等）。

🛡️ 安全与工程化设计

在让 AI 拥有本地执行权限时，安全性是重中之重。本项目内置了严格的安全防护机制：

• 防路径遍历攻击：核心依赖 path_utils.py，确保所有文件操作都被严格限制在当前工作目录内，拒绝访问父级目录。
• 敏感文件隔离：自动跳过 .env, secrets.json, .git/, node_modules/ 等包含密钥或非业务代码的敏感文件和目录。
• 精准的 AST 解析：对于 Python 项目，放弃脆弱的正则表达式，全面采用 AST（抽象语法树）进行依赖分析和调用图生成，确保极高的准确率。
• 结构化输出：所有分析脚本均输出标准 JSON 格式，最大程度降低 LLM 的幻觉和解析错误。

📦 包含的工具集

• path_utils.py：基础路径安全验证与敏感目录黑名单。
• scan_structure.py：扫描项目文件树、识别项目类型（Node/Python/Go/Rust）及入口点。
• analyze_deps.py：分析文件间的导入与依赖关系。
• call_graph.py：提取静态函数定义与调用关系。
• refactor_suggestions.py：代码质量扫描（长函数、深层嵌套检测）。
• test_framework_detect.py：测试框架（pytest, jest, mocha, go test 等）自动探测。
• error_patterns.json：常见语言报错模式匹配库。

🚀 安装与使用

1. 克隆仓库 将本项目克隆到你的本地计算机中，或者直接将脚本文件复制到你目标项目的 scripts/ 目录下。

   git clone [https://github.com/SatelliteCoder/code-intelligence.git](https://github.com/SatelliteCoder/code-intelligence.git)

2. 配置 Claude Code 在你的 Claude Prompt 或自定义系统指令中，引入本仓库提供的 SKILL.md 的内容，让 Claude 知道它可以使用这些本地工具。

3. 定制代码规范

   • 编辑 style_guide.md 以匹配你团队的命名、缩进和语法规范。
   • 编辑 common_patterns.md 添加你们常用的设计模式（如单例模式、工厂模式等）。
   • Claude 在生成代码前会自动读取这些文件，确保输出风格与现有项目高度一致。

⚙️ 依赖要求

• Python 3.6+ (所有分析脚本均使用 Python 标准库，无需安装任何第三方依赖)
• Claude Code CLI 环境