mcpField
O
organize

organize

github.com/alexanderstephenthompson生产力37 次安装
代码仓库

关于 organize

以人的导航思路为核心的文件夹结构设计、审查与重组技能,采用背景、执行、检索三阶段框架,并提供模板、命名建议和结构审计脚本。

主要功能

  1. 01L1/L2/L3 导航框架
  2. 02个人与团队目录模板
  3. 03迁移与命名指导
  4. 04结构审计脚本
  5. 05脚手架与杂乱项评估

适用场景

  1. 01规划个人或团队网盘目录
  2. 02重组现有文件夹结构
  3. 03审查目录结构问题
  4. 04判断空文件夹是模板槽位还是杂乱项

安装

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

$npx skills add https://github.com/alexanderstephenthompson/claude-hub --skill organize

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
home-drive-template.md
work-drive-template.md
references/
lifecycle.md
naming-patterns.md
transit-folders.md
migration-guide.md
scripts/
audit_structure.py

详细介绍

组织技能

版本: 1.2 来源: L1/L2/L3 认知阶段框架

文件夹结构应符合大脑的导航方式,而不是数据库存储记录的方式。


北极星

目标: 你始终清楚自己身处何处,以及正在寻找什么。

定义: 任何人(或 AI)都应能在 3 次选择内找到文件,无须猜测它在哪个文件夹中。

问题迹象: 如果你打开一个文件夹后感到迷茫,说明结构设计失败了。


快速入门

已经知道自己需要什么?从这里开始:

我想……前往
整理个人/家庭硬盘assets/home-drive-template.md — 选择领域,构建 L2,让 L3 自然形成
整理企业/团队硬盘assets/work-drive-template.md — Fulfill/Maintain/Grow 框架
重新整理杂乱的现有硬盘references/migration-guide.md — 分阶段迁移
正确命名文件和文件夹references/naming-patterns.md — 各层级的命名惯例
检查硬盘的结构问题scripts/audit_structure.py <path> — 自动化健康检查

如需了解完整框架,请继续阅读。


L1/L2/L3 框架

文件夹导航分为三个认知阶段。每个阶段回答不同的问题,文件夹名称应与该层级的思维类型相匹配。

L1:上下文(名词/领域)

问题:「我正在什么领域中行动?」

大脑模式: 确定方位。在开始工作前,先定位自己所处的领域。

文件夹名称通常是名词——表示活动的大致领域。基于思维模式的动词(例如,Fulfill、Maintain、Grow)在能触发相同的方位转换时也适用:

Drive/
├── Finance/
├── Marketing/
├── Operations/
├── Production/
├── Legal/
└── Personal/

判断方法: 只要你还在缩小领域范围,就仍处于 L1。你可能会依次打开多个文件夹,但只要每次点击都在回答「我属于哪个领域?」,就仍处于 L1。

成功标志: 你的思维自然从「我在哪里?」转向「我想做什么?」

L2:执行(动词/结果/主题类别)

问题:「我想完成什么?」——或者在创意类/领域繁杂的项目中,「我正在处理哪种类型的事物?」

大脑模式: 锁定目标。你已选定一个领域,现在要选择目标或主题重点。

文件夹名称是动词、结果或主题类别——表示在此完成的工作:

Marketing/                    # Business example — verbs/outcomes
├── Launch/
├── Grow/
├── Campaign/
├── Brand/
└── Analyze/

Arctic/                       # Creative example — subject categories
├── Locations/                # "I'm working on PLACES"
├── Residents/                # "I'm working on CHARACTERS"
└── Lore/                     # "I'm working on STORY"

L2 不要求文件夹名称必须是动词。 在创意、世界构建或领域繁杂的项目中,主题类别(地点、角色、资产、环境)只要能触发大脑从确定方位转向明确意图,就可作为 L2。判断标准是你的思维是否切换模式,而不是文件夹名称是否为动词。

判断方法: 只要你还在缩小目标、工作模式或主题重点的范围,就处于 L2。当你开始寻找特定成果时,L2 就结束了。

成功标志: 你的思维从「我在做什么?」转向「我需要哪个东西?」

L3:检索(对象/成果)

问题:「我需要的具体东西是什么?」

大脑模式: 取用。你已选定一个结果,现在要拿到所需的东西。

文件夹名称是具体对象——也就是成果本身:

Campaign/
├── Q1-2025-Product-Launch/
│   ├── Brief.docx
│   ├── Timeline.xlsx
│   ├── Assets/
│   └── Results.pdf
└── Q2-2025-Brand-Refresh/
    └── ...

判断方法: 当你正在浏览查找特定文件或成果时,就处于 L3。你知道自己想要什么,只是在找到它。


核心原则:层级代表认知阶段

这些层级并非文件夹的实际数量,而是描述你在导航时所处的思维状态。

情景点击的文件夹数实际层级
Work > Clients > Acme Corp3 个文件夹仍处于 L1——你还在回答「我属于哪个领域?」
Finance > Accounts Payable2 个文件夹L1 → L2 转换——你的思维从领域转向结果
Campaign > Q1 Launch > Brief.docx3 个文件夹L1 → L2 → L3——完整的认知递进

判断标准不是「点了多少个文件夹?」,而是「我的思维是否切换了模式?」


诊断守则

在诊断某个结构是否损坏或某个层级是否缺失之前,请先进行以下检查:

检查项如果是 →
用户能否在不迷失方向的情况下,通过 3 次决策找到自己的文件?结构有效——不要重组
即使文件夹名称与框架的术语不一致,认知转换是否依然发生?层级已具备——不要为了强行符合动词/名词规范而重命名
平行分支中的结构是否一致且可预测?模式有效——记录下来,不要扁平化
该领域是否本质上具有层级结构(地理、物理空间、分类体系)?预期会有更长的 L1 导航路径——不要误认为缺少 L2

框架服务于导航,而不是反过来。 如果有人能够顺畅地导航,那么无论文件夹名称是动词、名词还是主题类别,结构都是有效的。诊断人们实际遇到的问题,而不是理论上的标签不匹配。


脚手架评估

空文件夹不总是杂乱内容。在创意项目和内容密集型项目中,预先搭建的文件夹结构有实际用途——它们表达“这里是未来内容的位置”,并确保平行分支之间保持一致。在将空结构标记为问题之前,请判断它是有意搭建的脚手架,还是零散的杂乱内容。

有意搭建的脚手架(应予以认可)

脚手架通过以下检查时,便发挥了作用:

信号表现
一致的模板同一结构在平行分支中统一重复(例如,每个生物群系都有相同子类型的地点 + 居民)
反映领域模型文件夹模板对应真实结构——分类体系、物理空间或内容管线——并且之后需要填充内容
逐步填充有些分支已有实际内容,其他分支仍是占位内容。模板内的工作正在进行
占位约定通用名称(编号位置、“想法 1/2/3”)显然是临时标记,待内容到位后再重命名
深度有限脚手架在到达内容层之前,不会超过 2-3 层空文件夹

遇到通过这些检查的脚手架时,应认可它是有用的结构,而不是建议移除。指出哪些位置已填入内容、哪些还没有,但不要建议拆除框架。

示例——世界构建项目中的良好脚手架:

VR World/
├── Arctic/
│   ├── Locations/
│   │   ├── Commercial/
│   │   │   ├── _Ideas/
│   │   │   └── Winter Lodge Restaurant/    ← named, filling in
│   │   ├── Natural/
│   │   │   └── _Ideas/
│   │   └── Residential/
│   │       └── Dream House/                ← built out with rooms
│   └── Residents/
│       └── Alexander Borealis/             ← named character
├── Forest/                                  ← same template, different fill state
│   └── Residents/
│       ├── Big Bear/                        ← fully developed
│       └── Zebra Fox/
└── Desert/                                  ← same template, less filled
    └── ...

该模板保持一致,反映了世界构建领域(生物群系 × 内容类型),并且正逐步填入实际内容。空位置是内容路线图,而不是噪音。

示例——内容管线中的良好脚手架:

character-types/
├── bears/images/
│   ├── head/        (31 files)              ← filling in
│   ├── body/        (15 files)
│   └── tail/        (0 files)               ← empty but expected
├── dogs/images/
│   ├── head/        (26 files)
│   └── legs-and-feet/ (28 files)
└── foxes/images/                            ← mostly empty, work not started yet

25 个物种使用相同的身体部位模板。熊和狗的内容已填充充分;狐狸尚未开始。空文件夹是生产管线中的任务位置。

零散的杂乱内容(应标记)

出现以下情况时,脚手架已变成杂乱内容:

信号表现
没有重复模式空文件夹只是个别存在,并非模板的一部分
平行分支不对称同级分支的结构各不相同,且没有领域原因可以解释这种差异
任何位置都没有内容整棵目录树都是空的——没有任何分支包含实际内容
长期搁置且没有计划创建已有数月,从未使用,也没有相关工作计划
用途模糊文件夹名称无法说明其中应包含什么内容(New Folder、Stuff、temp)
每种情况的处理方式
发现操作
模板一致,且仍在积极填充保留。 肯定它是有用的框架
模板一致,但处处过时标记为可能已弃用。询问是否仍计划开展相关工作
模式不完整,应用不一致建议补全模式——保持一致,或移除不符合模式的内容
零散的空文件夹,且没有固定模式建议移除。 有内容时再创建文件夹
关键判断标准

删除这个空文件夹会丢失信息吗? 如果文件夹名称和位置能告诉你“这里是存放[特定类型内容]的地方”,那它就是框架。如果删除它不会让任何人搞不清内容该放在哪里,那它就是杂乱项。


渐进式披露

该框架采用渐进式披露——每个层级只展示你当前做决定所需的信息:

Step 1: See 5-8 arenas          (L1 — which world?)
Step 2: See 3-6 outcomes         (L2 — which goal?)
Step 3: See the artifacts         (L3 — grab the thing)
各层级的理想数量
层级目标拆分前的上限
L1 领域5-812
每个领域的 L2 目标3-610
每个目标的 L3 成果物不定30(然后分组)

如果任何层级超过上限,就说明需要拆分或重组。


命名规范

L1 名称:宽泛、稳定、易识别
模式示例
使用名词Finance、Marketing、Operations、Legal
首字母大写顶层领域使用标题式大小写
保持稳定这些名称很少变化——它们代表你生活或工作的领域
不包含日期日期应放在 L2 或 L3,而非 L1
L2 名称:以行动为导向,便于浏览
模式示例
使用动词或结果Launch、Grow、Hire、Ship、Fulfill
或者使用清晰的流程名称Onboarding、Reporting、Budgeting
允许限定时间范围在需要区分重复事项时使用 2025-Budget、Q1-Campaign
L3 名称:具体、描述清晰、易于查找
模式示例
具体明确使用 Invoice-2025-03-Acme.pdf,而不是 Invoice.pdf
按时间顺序排列时添加日期前缀2025-03-15_Meeting-Notes.md
添加类型后缀,便于浏览Logo-Primary.png、Logo-Dark.png
避免歧义每个名称都应足够独特,以便通过搜索找到
通用命名规则
规则原因
大小写风格一致为每个层级选定标题式大小写、kebab-case 或 snake_case,并始终遵循
将区分性词语放在前面使用 Budget-2025,而不是 2025-Budget(除非按日期排序更重要)
不使用特殊字符仅使用 A-Z、0-9、-、_ 和空格(适用时)
根据上下文调整的命名规则
上下文可以使用空格吗?必须使用连字符/下划线吗?原因
个人/创意文件盘可以不需要——可读性更重要Winter Lodge Restaurant 比 Winter-Lodge-Restaurant 更易读。操作系统原生支持空格
代码项目和网站不可以可以——使用连字符或下划线空格会影响脚本、URL、命令行命令和版本控制
共享/团队文件盘视情况而定遵循团队规范团队内部保持一致比任何单条规则都重要

不要将代码命名规范用于个人文件盘,也不要将个人命名规范用于代码库。 根据环境选择合适的规则。

文件名语义

文件名应让人一眼看出文件包含什么。好的文件名无需打开文件就能回答“这是什么?”。

非语义化名称(标记这些文件)
模式示例问题
哈希/ID 字符串50bacb7db3dbda5ba74ce3b7e51aa624.jpg无法说明任何信息
通用默认名称Untitled.png、download (1).jfif难以区分
截图自动命名Screenshot (163).png截图里是什么?
纯时间戳photo_2021-03-15_09-25-00.jpg只说明何时,不说明内容
AI 提示词作为文件名alexandersthompson_UI_design_of_a_Forest...png太长,哈希被截断
平台导出名称IMG_20200417_180854_994.jpg相机胶卷 ID
好的文件名有哪些特点
原则示例
描述内容ice-cave-interior.jpg,而不是 89381.jpg
使用你的词汇bear-head-front-view.png,而不是 head-01.jpg
与同类文件区分开moraine-lake-sunrise.jpg 和 crater-lake-aerial.jpg
长度适中3-6 个词
将有用的元数据作为后缀保留desert-canyon-ref_antelope-canyon.jpg
何时标记,何时忽略
情况操作
经过整理、用于最终存放的文件夹中的文件标记——这些是你之后会再查看的内容
_Ideas/ 或参考文件夹中的文件如果有 10 个以上带哈希/时间戳的文件,则标记
中转文件夹(~)中的文件忽略——中转内容仍在处理中
脚手架占位文件中的文件忽略——内容到位后会重命名
少量且视觉内容一目了然的文件优先级较低
建议更好的名称

标记非语义化名称时,根据以下信息建议替代名称:

  1. 文件夹上下文——位于 Arctic/Locations/Natural/_Ideas/ 中的文件,可能是自然/景观参考资料
  2. 文件的可见内容——如果能看清图片,就描述你看到的内容
  3. 同类文件——如果无名称文件旁边有已命名文件,就沿用其命名模式
  4. 不必追求完美——snowy-village.jpg 比 241076.jpg 好,即使它并未完整描述内容

决策指南:这个文件该放在哪里?

问问自己……如果是 →
这是我现在正在进行的工作吗?该项目/活动的 L2 成果文件夹
这是我会查阅但不会编辑的参考资料吗?相关 L1 领域内的 Reference/
这是我会在多个项目中重复使用的模板吗?_Templates/(共享或按领域划分)
这是已完成的交付物吗?生成它的成果中的 L3 产物
这是我需要访问的其他人的产出吗?指向所有者 L2 的快捷方式/链接,而不是副本
我确实不知道_Unsorted/——在每周回顾时整理

活跃内容与参考资料:意图测试

文件夹类型用途思维模式示例
活跃(进行中)进行中的工作、项目、交付物“我正在产出一些东西”Launch/、Ship/、Hire/
参考(查阅)查阅资料、政策、标准、指南“我正在查找答案”Reference/、Policies/、Standards/

测试问题:“我打开这个文件夹是为了开展工作,还是为了查找资料?”

  • 如果两者都有 → 拆分成两个 L2 文件夹。活跃文件夹存放工作,并链接到参考文件夹。
  • 工作完成后,活跃文件夹会归档。参考文件夹则长期保留。

重叠内容的处理

当前文件夹负责工作,参考文件夹负责知识。它们相互链接,绝不重复存放。

情况处理方式
文件可能属于两个 L1 领域根据文件的产出者确定主要归属。另一个领域使用快捷方式
文件既是进行中的工作,也是参考资料现在放在工作文件夹中。项目完成后再移至参考文件夹
两个团队都需要同一个文件由其中一个团队负责。另一个团队使用快捷方式。如果双方都不负责 → _Shared/
同一数据有不同格式保留一个事实来源。规范版本存放在负责方的文件夹中

绝不重复存放。 两份副本意味着其中一份会过时。


系统文件夹

用于支持结构而非存放内容的基础设施文件夹。使用前导下划线。

系统文件夹用途范围
_Archive/已完成且不再活跃的工作每个 L2 成果文件夹内
_Unsorted/暂存尚无明确归属的文件每个驱动器一个(顶层)
_Templates/可重复使用的文档模板每个 L1 领域内,或在顶层共享
_Shared/没有单一负责方的跨职能内容仅限顶层
系统文件夹规则
规则原因
始终以下划线开头与内容文件夹分开排序,视觉上也更醒目
绝不嵌套系统文件夹_Archive/_Archive/ 是危险信号——应将其扁平化
_Unsorted/ 是临时文件夹它是收件箱,不是永久归档位置。每周检查
_Shared/ 必须有充分理由其中的每个文件都应有无法归属于单一领域的原因
不要预先创建系统文件夹首次需要归档时再添加 _Archive/,不要提前创建

中转文件夹

存放正在移往已知目的地的内容的文件夹。使用前导波浪号(~)。与目的地未知的 _Unsorted/ 不同。

文件夹用途
~Transfer/将内容移入项目时的暂存区
~Import/从外部来源接收的内容
~Migrate/在不同组织结构之间迁移的内容

关键规则:始终以波浪号开头,添加日期后缀(~Transfer 2026-02/),多会话迁移时包含 _STATUS.md,内容清空后删除。

完整详情(命名约定、生命周期、过时信号、分析范围),请参阅 references/transit-folders.md。


文件生命周期

Created → Active → Completed → Archived → (Deleted)

文件会根据项目状态在不同阶段之间流转。在 L2 层级归档(成果文件夹内的 _Archive/)。默认保留——存储成本低,后悔代价高。

完整的生命周期规则、归档策略和维护频率(每周/每月/每季度),请参阅 references/lifecycle.md。


按规模调整

规模L1 对应内容L2 侧重点关键考虑因素
个人(一人)生活领域:Career、Finances、Home、Media、Personal轻量——项目名称或简单成果大多数文件存放在 L3
团队(小组)思维模式:Fulfill、Maintain、Grow结构化——流程、项目、时间段明确每个 L1 领域的负责方
组织(公司)部门或业务单元在团队间强制执行命名约定让访问控制与 L1 边界保持一致

危险信号

看到以下情况时,请停下来重新组织:

问题问题所在修正方法
兜底文件夹Misc/、Other/、Stuff/、New Folder/确定真正的 L1 领域或 L2 结果
嵌套过深(6 层以上)在同一个分支中混合了不同认知阶段将 L1、L2、L3 关注点分开,扁平化结构
L1 层级仅按日期命名的文件夹顶层的 2024/、2025/日期应放在 L2 或 L3 层级——优先放置领域
重复文件名同一个文件出现在两个位置确定归属位置,从其他位置建立链接
所有内容都放在一个文件夹中一个目录中有 100 多个文件按 L2 结果或 L3 产物类型拆分
名称含糊不清Documents/、Files/、Data/替换为具体的领域名称
层级混杂Finance/Invoice-2025-03.pdf(跳过了 L2)补上结果层级:Finance/Accounts-Payable/Invoice-2025-03.pdf

反模式

反模式表现形式失败原因
文件柜僵化的分类与思考方式不符迫使你记住任意的位置
按时间顺序堆放所有内容都先按日期排序日期无法帮助你按主题查找内容
镜像文件夹结构与组织架构图完全一致组织架构会变化;文件不会自行重新整理
完美主义者零散的空文件夹,没有一致的模板,也没有任何内容随意创建的空文件夹会制造杂乱,却无法传达意图。(注意:采用一致模板并逐步填充属于脚手架,而非完美主义——参见 脚手架评估)
扁平世界所有内容都放在一个巨型文件夹中,依赖搜索搜索失效或上下文丢失时就行不通了

例外:何时打破规则

本框架中的每条规则都有合理的例外。关键在于:有意识地打破规则,而不是无意为之。

L1 层级优先按日期组织
例外示例合理原因
税务/法律合规2024-Tax-Returns/、2025-Tax-Returns/法律要求本质上按年度划分。年份就是领域
学术学期Fall-2025/、Spring-2026/每个学期都是一个独立的世界

**判断标准:**时间段真的是首要的组织原则,而不只是习惯吗?

L1 领域超过 12 个
例外示例合理原因
以客户为主的业务每个主要客户对应一个 L1 领域每个客户确实都是一个独立的世界
多物业管理每处物业对应一个 L1 领域实际地点是自然的领域划分方式

**判断标准:**合并任意两个领域,是否会迫使你在同一个文件夹中不断切换上下文?

文件很多的扁平 L3 层级
例外示例合理原因
照片库按日期命名的活动文件夹中有 200 多张照片你是通过视觉浏览,而不是阅读名称
日志文件单个文件夹中的按时间顺序排列的日志按日期排序,按新近程度访问

**判断标准:**不细分子组,你仍然能找到需要的内容吗?如果搜索或按日期排序就足够了,就不要强行创建人为分类。

例外的一般规则

如果要打破规则,请在该层级的 _README.md 中写下原因。如果你无法清楚说明理由,就不应该打破规则。


质量检查

在认定某个磁盘“已整理好”之前,请确认以下规则都得到遵守。

结构检查
检查项通过条件
每个 L1 领域至少有一个活跃的 L2 成果顶层没有空领域碍眼
没有 L2 文件夹同时用于开展工作和查阅参考资料拆分为独立的行动/知识文件夹
每个活跃的 L2 文件夹都包含素材、子文件夹,或属于一致的模板框架没有零散、一次性的空文件夹
不同领域之间没有重复的 L3 素材每份素材都有一个归属,其他位置使用快捷方式
_Unsorted/ 中的项目少于 20 个你在坚持每周整理
命名检查
检查项通过条件
L1 名称是名词(领域)顶层没有动词、日期或缩写
L2 名称体现意图(动词、成果或主题类别)看名称就知道这里要做什么
L3 名称足够具体,便于通过搜索查找没有 Document.pdf 或 Notes.txt
每一层内的大小写风格一致同一层级没有混用 Title-Case 和 lowercase
命名方式符合使用场景个人硬盘上可以用空格;代码项目中必须使用连字符/下划线
边界检查
检查项通过条件
活跃文件夹包含工作内容,而非参考资料参考资料有自己的文件夹
参考文件夹包含供查阅的资料,而非活跃项目工作内容有自己的文件夹
_Shared/ 只包含真正跨职能的项目不能用作杂物堆放处
归档文件夹位于各自的 L1 领域内不是会丢失上下文的顶层 Archive/

应用此框架

步骤 1:审查当前结构

列出你的顶层文件夹。对每个文件夹,问自己:

  • 这显然是一个 L1 领域(一个活动领域)吗?
  • 还是其他内容?(日期、项目、杂项)
步骤 2:设计 L1 领域

写下生活或工作中的 5-8 个主要领域。它们将成为你的 L1 文件夹。这些领域应当自然且稳定。

步骤 3:为每个领域设计 L2 成果

为每个领域列出你在那里实际会做的 3-6 件事。这些就是你的 L2 文件夹。

步骤 4:让 L3 自然形成

不要预先创建 L3 结构。随着你实际产出素材,让它自然形成。结构应随工作而定。

步骤 5:逐步迁移

分批移动文件。从你最常用的领域开始。不要试图一次性重新整理所有内容。详细迁移步骤请参阅 references/migration-guide.md。


参考资料

  • references/naming-patterns.md — 各层级的详细命名示例和规范
  • references/migration-guide.md — 重新整理现有混乱硬盘的分步指南
  • references/transit-folders.md — 中转文件夹规范、生命周期和过时信号
  • references/lifecycle.md — 文件生命周期规则、归档策略和维护频率

资源文件

  • assets/home-drive-template.md — 个人主目录硬盘的起始结构
  • assets/work-drive-template.md — 专业工作硬盘的起始结构

脚本

  • scripts/audit_structure.py — 扫描文件夹树并报告 L1/L2/L3 问题(杂项文件夹、深度、命名)

评论

支持 Markdown