← ClaudeAtlas

folder-caretakerlisted

用户说"整理/管理这个文件夹"时用:扫描并生成根目录 00_使用规则.md 声明(持续治理),或按标准一次性梳理文件夹(整理方法论+验收标准)。
TEXXXXTURE/folder-caretaker · ★ 0 · AI & Automation · score 73
Install: claude install-skill TEXXXXTURE/folder-caretaker
# Folder Caretaker — 文件夹自治管理 ## When to Use(🔴 按需语义触发) **只有用户说出「整理 / 管理文件」语义时才使用本 skill。** 不是所有文件夹都自动加规则。 | 用户说的话 | 功能 | |-----------|------| | 「管理这个文件夹 / 给这个文件夹定规则 / 以后按规矩放」 | A. 持续治理(生成声明) | | 「整理一下这个文件夹 / 这个文件夹好乱 / 梳理一下 / 归类一下」 | B. 一次性梳理 | | 「整理完以后要一直保持」 | A+B 组合 | ## 核心理念(为什么存在) **AI 与 Agent 擅长产出内容,却对自己的产出没有结构感**:生成的文件默认散落,无命名约定、无归类逻辑、无归档规则;用户不会主动整理 AI 生成的产物。不治理的 AI 产出物只会越积越乱,最终变成无法检索的垃圾堆。 本 skill 给 Agent 的产出建立结构——让 AI 生成的东西像人整理过的一样有逻辑、可检索、可复用。 ## 协议在文件里,不在 Agent 里 **约束机制**:整理完成后,文件夹根目录生成 `00_使用规则.md`(协议本身)。协议随文件夹存在——Agent 存取该文件夹时列目录即见(`00_` 前缀排最前),内容自述约束。**不需要**在任何 Agent 的全局指令里写"进场协议铁律",也不要给所有文件夹自动加规则。 ## 三功能 | 功能 | 动作 | 产物 | |------|------|------| | A. 持续治理 | 扫描 → 生成 `00_使用规则.md` 声明 | 文件夹根目录声明(协议在场) | | B. 一次性梳理 | 扫描 → 分类 → 方案确认 → 执行 → 善后 | 实际目录结构变动 | | C. 上云同步 | 建云仓 + 声明记录云端位置 → commit + push | 云端单一事实源(多 Agent 共享同一份规则与进度) | --- ## 功能 A:持续治理(生成声明) 1. **扫描**:列目标文件夹树(深度 ≤3,跳过 `.git`/`node_modules`/`__pycache__` 等),统计文件类型分布 2. **识别类型**:按内容特征匹配类型模板(见「类型适配模板」) 3. **起草声明**:生成 `00_使用规则.md`(按模板填充) - 必须包含:这是什么(目录地图)/ 放置规则(硬性)/ 禁区(不可违反)/ 维护日志 - 项目 / 协作类文件夹(多会话、多 Agent 共用)另含「交接与依赖方向」章节(见下) 4. **用户确认**:展示声明草案,确认后写入文件夹根目录 5. **登记**:维护日志追加一行「生成本规则 + 日期」 ## 功能 B:一次性梳理(整理方法论) ### B1. 扫描与分类 1. 完整列目录(含子目录,深度 ≤3) 2. 统计文件类型分布(扩展名 + 数量 + 大小) 3. **语义归类**:按内容主题对文件分组,标注归属(示例:RAG调参报告 → `RAG调参/`,产品拆解 → `产品拆解/`) 4. 识别"孤儿文件"(散落根目录的)、"重复文件"(`xxx(2).md` 类)、"空目录" ### B2. 提出方案(🔴 枚举确认,不直接动手) 方案必须包含: | 项 | 内容 | |----|------| | 新建目录 | 每个目录一句话说明放什么 | | 移动映射表 | 文件 → 目标目录 的完整清单(逐一