code-explorer

code-explorer — Claude Code 源码解读 Plugin

一个为 Claude Code 设计的源码探索插件，帮助你快速读懂陌生代码库。

功能特点

• 四种分析模式：快速解答（单函数）/ 标准分析（单模块）/ 深度探索（整项目）/ 改进建议（多维度审计）
• 多语言专项策略：Go、Python、JavaScript/TypeScript 各有专属分析套路
• 参考脚本自动化：自动检测语言、查找入口点、获取 Git 历史上下文
• ASCII art 可视化：自动生成架构图、时序图、状态机图
• Git 洞察：结合提交历史解释代码演变背景
• Claude Code Hooks：智能交互增强，运行时追踪与保护

安装

方式一：Plugin 安装（推荐）

claude plugin add github:googs1025/claude-code-explorer-skill

Plugin 方式支持自动更新和版本管理，一行命令即可完成安装。

方式二：Legacy 脚本安装

适用于不支持 Plugin 的旧版本 Claude Code：

git clone https://github.com/googs1025/claude-code-explorer-skill.git
cd claude-code-explorer-skill
bash install.sh

安装脚本会自动完成以下步骤：

1. 将 Skill 文件复制到 ~/.claude/skills/code-explorer/
2. 安装 Git Hooks（仅当前仓库开发用）
3. 安装 Claude Code Hooks 到 ~/.claude/hooks/code-explorer/
4. 注册 Hooks 到 ~/.claude/settings.json

本地开发测试

# 以 Plugin 方式加载本地目录
claude --plugin-dir ./

使用方式

安装后，在 Claude Code 中用以下任意方式触发：

# 显式调用
/code-explorer src/main.go
/code-explorer handleRequest

# 自然语言触发（自动识别）
帮我理解 handleRequest 的执行流程
解释这个项目的架构
这段代码的核心逻辑是什么
为什么这里要用 goroutine？
这个接口是怎么用的
帮我看懂这个项目

# 建议模式触发
这个项目可以有哪些改进
帮我看看哪些地方需要改进
给我列出修改建议
这个模块可以增加什么功能

分析模式

模式	触发条件	输出
快速模式	单函数、单变量、单行疑问	简洁解释 + 注意点
标准模式	单个文件、单个模块	完整四阶段分析 + ASCII art 图
深度模式	整个项目、架构梳理	宏观扫描 → 确认范围 → 深入分析
建议模式	询问改进、优化、建议	七维度扫描 → 分优先级改进建议清单

模式边界：快速/标准/深度模式专注于理解代码，不会主动输出优化建议；只有明确询问改进或优化时才进入建议模式。

四阶段分析流程（标准/深度模式）

Phase 1: 宏观扫描 → 识别技术栈、目录结构、依赖、架构分层
Phase 2: 关键路径追踪 → 定位核心函数、追溯调用链、数据流追踪
Phase 3: 抽象与可视化 → 伪代码重构、ASCII art 图表、设计模式识别
Phase 4: 综合解释 → 一句话总结、设计意图、潜在风险、Git 洞察

输出示例

标准/深度模式输出结构：

## 核心功能摘要
[一句话，不超过 50 字]

## 架构/流程图
[ASCII art 文字图]

## 关键逻辑拆解
入口点 → 核心流程 → 数据流向

## 深度洞察
设计意图 / 关键依赖 / Git 背景 / 注意事项

## 建议深入探索
[引导性问题]

建议模式输出结构：

## 🎯 改进建议概览
[项目/模块名] — 共 N 条建议（🔴 X 条 / 🟡 Y 条 / 🟢 Z 条）

## 🔴 Critical — 必须修复
位置 / 问题 / 建议 / 影响

## 🟡 Major — 建议修复
位置 / 问题 / 建议

## 🟢 Minor — 可以改进
位置 / 建议

## 🚀 功能增强建议
基于项目特征的新功能建议

## 📊 建议优先级路线图
按实施顺序排列的改进路径

建议模式七大分析维度

维度	关注点
🐛 代码质量	代码坏味道、DRY 违反、复杂度过高
🔒 安全加固	输入校验、注入风险、敏感数据处理
⚡ 性能优化	N+1 查询、不必要的循环、内存泄漏
🧪 测试覆盖	缺失测试、边界 case、核心路径未覆盖
📦 功能增强	TODO/FIXME、未完成的实现
🏗️ 架构改进	耦合度、模块边界、设计模式
📝 文档与 DX	缺失文档、过时注释、CI/CD 改进

支持语言

语言	策略文件	特色检查
Go	lang/go.md	goroutine 泄漏、channel 死锁、interface 边界
Python	lang/python.md	框架识别、循环导入、装饰器追踪
JavaScript/TypeScript	lang/javascript.md	XSS 风险、类型安全、框架路由
其他语言	通用策略	入口点搜索、依赖文件扫描、目录结构推断架构分层

参考脚本

Skill 内置三个辅助脚本，分析时自动执行：

脚本	功能	示例输出
detect_lang.sh	检测项目语言、版本、框架	lang=go, framework=gin
find_entry.sh <lang>	按语言查找入口点和路由注册	./cmd/server/main.go
git_context.sh [file]	获取 Git 历史、活跃文件、贡献者	最近 20 条提交、Top 5 活跃文件

Claude Code Hooks

插件自动配置以下 Claude Code Hooks，增强分析体验：

Hook	触发时机	功能
pre-prompt.sh	UserPromptSubmit — 用户提交 prompt 时	检测深度/探索分析意图，交互式确认分析范围、关注重点和详细度，注入配置到上下文
post-bash.sh	PostToolUse(Bash) — Bash 工具执行后	验证 detect_lang / find_entry / git_context 脚本输出，创建会话标记
post-read.sh	PostToolUse(Read) — Read 工具执行后	追踪文件读取数量，Phase 1 上限(5个)和总上限(10个)时提醒
on-stop.sh	Stop — 会话结束时	输出本次会话读取统计，清理临时文件

Hooks 工作流程

用户输入 prompt
    │
    ▼
pre-prompt.sh 检测关键词
    │
    ├─ 匹配「架构/整体/overview...」→ 深度分析配置交互
    ├─ 匹配「解释/理解/how/why...」→ 探索分析配置交互
    └─ 无匹配 → 直接通过
    │
    ▼
Claude 执行分析（调用 Bash/Read 工具）
    │
    ├─ post-bash.sh → 验证脚本输出，创建会话标记
    └─ post-read.sh → 计数读取文件数，超限提醒
    │
    ▼
会话结束
    │
    ▼
on-stop.sh → 输出统计，清理临时文件

注意：pre-prompt.sh 内置超时保护（10 秒），TTY 不可用时自动使用默认配置，不会阻塞 Claude Code。

Git Hooks（开发者用）

项目还包含用于开发本 Skill 时的 Git Hooks：

Hook	功能
git-hooks/pre-commit	对暂存的 .sh 文件执行 shellcheck 检查
git-hooks/commit-msg	验证 commit message 符合 Conventional Commits 格式

这些 Git Hooks 仅在本项目开发时使用，不影响用户项目。

项目结构