mcpField
F
file-analysis

file-analysis

github.com/athola开发343121 次安装1 天前更新
代码仓库

关于 file-analysis

file-analysis 是面向开发者的代码库结构分析技能，适用于架构评审、初探陌生代码库或估算工作范围。它梳理目录与文件模式，并记录可能的复杂度热点。

主要功能

  1. 01识别项目与工作区根目录
  2. 02绘制目录结构
  3. 03统计各扩展名文件
  4. 04识别配置与生成文件
  5. 05记录大型文件和深层目录

适用场景

  1. 01为架构评审准备结构信息
  2. 02修改前梳理陌生代码库
  3. 03估算重构或迁移范围

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill file-analysis

安装后在 Claude Code 中输入/file-analysis确认已加载。

详细介绍

文件分析

适用场景

  • 在架构评审前，了解模块边界和文件组织方式。
  • 探索不熟悉的代码库时，先梳理结构再进行更改。
  • 为重构或迁移工作估算范围提供依据。

不适用场景

  • 通用代码探索——使用 Explore Agent
  • 搜索特定模式——直接使用 Grep

必需的 TodoWrite 项

  1. file-analysis:root-identified
  2. file-analysis:structure-mapped
  3. file-analysis:patterns-detected
  4. file-analysis:hotspots-noted

完成相应步骤后，将每个项目标记为已完成。

步骤 1：识别根目录（file-analysis:root-identified）

  • 使用 pwd 确认分析根目录。
  • 记录任何 monorepo 边界、工作区根目录或子项目路径。
  • 根据清单文件（package.json、Cargo.toml、pyproject.toml 等）记录项目类型（语言、框架）。

步骤 2：梳理结构（file-analysis:structure-mapped）

  • 运行 tree -L 2 -d 或 find . -type d -maxdepth 2，了解顶层目录布局。
  • 识别标准目录：src/、lib/、tests/、docs/、scripts/、configs/。
  • 记录可能影响后续分析的非标准组织模式。

步骤 3：检测模式（file-analysis:patterns-detected）

  • 使用 find . -name "*.ext" -not -path "*/.venv/*" -not -path "*/__pycache__/*" -not -path "*/node_modules/*" -not -path "*/.git/*" | wc -l 按扩展名统计文件数量。
  • 识别主要语言及其文件分布情况。
  • 记录配置文件、生成的文件和供应商依赖项。
  • 运行 wc -l $(find . -not -path "*/.venv/*" -not -path "*/__pycache__/*" -not -path "*/node_modules/*" -not -path "*/.git/*" -name "*.py" -o -name "*.rs" | head -20)，抽样查看文件大小。

步骤 4：记录热点（file-analysis:hotspots-noted）

  • 识别大型文件（潜在的“上帝对象”）：find . -type f -exec wc -l {} + | sort -rn | head -10。
  • 标记可能表明复杂度较高的深层嵌套目录。
  • 记录命名约定或存放位置异常的文件。

完成标准

  • TodoWrite 项目均已完成，并包含具体观察结果。
  • 后续工作流（架构评审、重构）具备结构背景信息。
  • 已记录文件数量、目录布局和热点，供参考。

评论

支持 Markdown