folder-caretakerlisted
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. 提出方案(🔴 枚举确认,不直接动手)
方案必须包含:
| 项 | 内容 |
|----|------|
| 新建目录 | 每个目录一句话说明放什么 |
| 移动映射表 | 文件 → 目标目录 的完整清单(逐一