这个Claude Skill 专治项目文件夹乱,让你的代码库从第一天就规范

你有没有这种感觉——项目做着做着,文件夹里堆满了乱七八糟的 新建文件夹 (2)、未命名-03.py、final_v3_REAL.ipynb?

每次换电脑、接新项目,光是搞懂「代码放哪里、数据在哪里、输出到哪里」就要花半小时。这种混乱不只是审美问题,它直接拖慢你的效率,增加出错概率,还让协作者一脸懵。

今天推荐一个 Claude Skill,专门解决这个问题。

它能做什么

folder-organization 是专门为研究和开发项目设计的文件夹结构标准化工具。只要一句话,Claude 就能帮你:

新建项目时自动生成标准结构:

project-name/
├── README.md
├── .gitignore
├── data/
│   ├── raw/        # 原始数据,不改动
│   ├── processed/  # 清洗后的数据
│   └── external/   # 第三方数据
├── notebooks/      # Jupyter 探索笔记
├── src/            # 可复用源代码
├── scripts/        # 独立脚本
├── tests/          # 测试文件
└── docs/           # 文档

命名规范也帮你定好了:全小写 + 连字符,.gitignore 自动排除大数据文件,README.md 模板直接生成。

适用场景

  • 搭建新项目——开局就规范,不留烂摊子
  • 重组现有混乱仓库——帮旧项目重新梳理目录和命名
  • 团队规范化——新成员看一眼就懂,不用反复问
  • 数据密集型项目——raw / processed 分离,实验可复现

为什么值得用

文件夹乱的最大代价不是「找不到文件」,而是每次切换上下文都要重建 mental model。当你用统一结构后:

  • 接手别人的项目,上手时间从几天降到几小时
  • 自动化脚本写起来简单多了(路径规范就是接口规范)
  • Git 历史更干净,.gitignore 不容易漏写

使用方法

安装超简单:

npx skills add https://github.com/Delphine-L/claude_global --skill folder-organization

然后在 Claude Code 里直接说:

「帮我在当前目录创建一个标准项目结构」

或者:

「帮我把这个混乱的项目重新组织一下,参照 folder-organization 的规范」

Claude 会自动分析现有文件、制定重组计划,征得你同意后执行。

总结

folder-organization 把项目结构这件事,从「靠自觉」变成了「靠工具」。开局规范,后续维护成本大幅下降;团队统一规范,协作效率肉眼可见地提升。

适合开发者、研究者、数据科学从业者——只要你的工作会生成一堆文件,它就有价值。

GitHub: https://github.com/Delphine-L/claude_global
Star: 13
安装命令: npx skills add https://github.com/Delphine-L/claude_global --skill folder-organization


GitHub: https://github.com/Delphine-L/claude_global

评论区

0 条评论

登录后可评论。

林小秋 11 阅读