核心功能: 本技能提供、格式互转、内容提取时使用、化工作流场景等能力。
File 文件管理整理
文件与文件夹管理的完整工具,从命名规范到文件夹结构到关键文档归档,帮助建立可持续的文件管理体系.
输入定义
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 文件管理整理处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
专业版增值服务
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 文件管理整理文件与文件夹管理 | 不支持 | 支持 |
| 文件管理整理文件检索 | 不支持 | 支持 |
| 复杂工作流可视化编排 | 不支持 | 支持 |
| 条件分支与异常重试 | 不支持 | 支持 |
| 定时触发与事件驱动 | 不支持 | 支持 |
能力概览
文件命名系统构建(Naming Conventions)
大多数文件混乱始于命名问题。本能力根据用户的实际文件类型构建个性化命名规范:
- 命名原则:名称足够具体,不打开文件就能知道内容;日期使用可排序格式(
2026-04-17);版本标记让当前版本一目了然 - 搜索友好:使用你实际会输入的搜索词命名,而非保存时觉得合理的词
- 版本管理:用
v1、v2、FINAL区分版本,避免final、final2、final_USE_THIS_ONE的混乱 - 截图命名:将
Screen Shot 2023-04-17 at 11.43.22 AM重命名为内容描述格式 - 批量重命名:根据实际文件生成命名规则,通过实际文件教学而非抽象示例
文件夹结构设计(Folder Structure)
围绕文件检索方式而非创建方式组织文件夹结构:
- 浅层结构:不超过 3-4 层深度,任何文件 3-4 次点击内可找到
- 一致性:结构足够一致,总是大致知道某个文件应该在哪里
- 从零设计或重组:支持从零设计新结构或重组现有结构,重组前先展示完整计划,经用户审批后才移动任何文件
- 项目文件夹模板:每个项目统一分类 — 工作文档、参考材料、assets、deliverables、communications
- 归档机制:项目完成后干净归档 — 压缩需保留的、删除不需要的,确保一年后客户提问时能快速找到
文件检索与找回(Finding Lost Files)
通过自然语言描述检索找不到的文件:
- 描述式搜索:描述你记得的文件信息 — 大致内容、创建或接收时间、关联项目、文件格式、名称片段
- 构建精准搜索:从描述细节构建最精准的搜索条件
- 根因分析:危机过后分析文件为什么难找 — 检索问题几乎总是命名或组织问题的伪装
- 预防措施:确保类似文件下次可在秒级而非分钟级找到
Downloads 与 Desktop 清理(Inbox Zero for Files)
像邮件 Inbox Zero 一样处理文件堆积点:
- Downloads 处理:Downloads 是文件被遗忘的地方。每个文件要么归档、要么删除、要么有意延期并标注原因
- Desktop 清理:Desktop 是没时间放好时文件的去处。清理到每个剩余文件都是有意放置的
- 定期处理:每周 5 分钟检查 Downloads 文件夹,项目结束时 15 分钟收尾清理
- 系统 vs 积累:区分运行的系统和积累债务的系统 — 定期处理的文件环境保持可控
关键文档 inventory 管理(Critical Documents)
识别和管理有实际后果的重要文档:
- 文档类型:合同、税务文件、医疗记录、财务报表、法律信函 — 丢失或无法访问会有实际后果
- 存储与命名:确保关键文档以可访问的方式存储、命名和备份,因为需要时通常很紧急
- 文档清单:建立关键文档的简单 inventory — 是什么、存在哪里、何时到期或需更新
- 到期追踪:追踪文档的有效期和更新时间,避免需要时不知道是否有这份文件
- 备份策略:关键文档多重备份,确保可访问性
文件维护习惯养成(Maintenance Without Effort)
建立足够轻量可持续的文件管理习惯:
- 低摩擦原则:正确归档只需 10 秒而非 10 分钟,结构清晰到不存在"该放哪"的问题
- 周度检查:每周 5 分钟检查 Downloads 文件夹
- 项目收尾:项目结束 15 分钟收尾流程,不遗留任何未处理文件
- 季度回顾:季度检查容易积累杂物的文件夹
- 目标:不是完善系统,而是维护成本足够低以至于你实际会维护的系统
初始配置
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
操作步骤
- 环境确认: 确认Agent平台已加载本skill,检查依赖说明中的环境要求
- 指令输入: 向Agent描述需要执行的任务,引用
file的相关能力 - 执行处理: Agent按照核心能力章节的指令执行任务
- 结果验证: 检查输出结果是否符合预期,参考错误处理章节处理异常
实际示例
基本用法
向Agent发送指令:
使用 文件管理整理 处理以下任务:
[具体任务描述]
输出说明
Agent将根据指令调用对应能力,返回响应数据。响应格式取决于具体能力点的输出定义.
依赖与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
需要配置对应API Key,详见上文环境配置章节
可用性分类
- 分类: MD+EXEC()
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
错误应对
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 文件移动后无法找到 | 新位置不符合用户记忆习惯 | 移动前展示完整计划,经用户审批后再执行,保留移动日志 |
| 批量重命名冲突 | 目标名称已存在或格式冲突 | 重命名前检查冲突,自动添加序号后缀或提示用户手动决定 |
| 文件夹结构过深 | 层级超过 3-4 层导致检索困难 | 限制最大深度,将深层内容提升到浅层或拆分子项目 |
| 关键文档误删 | 清理时未识别为重要文件 | 关键文档 inventory 预先标记,删除前与 inventory 比对 |
| 搜索无结果 | 文件名不含搜索关键词或已被移动 | 使用内容描述搜索,检查 archive 文件夹和 trash |
| 权限不足无法操作 | 系统文件或受保护目录 | 确认操作权限,跳过系统文件,仅处理用户目录 |
| 备份失败 | 存储空间不足或路径不可达 | 检查目标存储空间和路径可访问性,多重备份策略容错 |
| 项目归档不完整 | 未清理临时文件或遗漏交付物 | 使用项目收尾检查清单,逐项确认后再归档压缩 |
问题集锦
Q1: 如何开始整理一个混乱的桌面?
A: 先扫描所有文件,按类型分类(截图、文档、文件夹、临时文件)。生成命名规范和目标文件夹结构,展示完整移动计划,用户审批后批量执行。每周 5 分钟检查保持整洁.
Q2: 文件命名规范应该怎么定?
A: 根据你实际搜索时输入的关键词命名。日期用 2026-04-17 格式可排序。版本用 v1/v2/FINAL 标记。名称要足够具体,不打开文件就知道内容.
Q3: 关键文档如何确保不丢失?
A: 建立文档 inventory — 记录是什么、存在哪里、何时到期。多重备份(本地 + 云端)。合同、税务、医疗等文件单独标记,清理时自动跳过.
注意事项
- 无法处理加密文件或受密码保护的文档
- 文件操作需要 Agent 具备文件系统 exec 权限
- 重组大量文件可能耗时较长,建议分批处理
- 无法恢复已被永久删除的文件(需数据恢复工具)
创新优势
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 文件批量重命名 | 30分钟 | 5分钟 | 25分钟 | 100% |
| 文件夹结构设计 | 1小时 | 30分钟 | 30分钟 | 100% |
| 文件检索 | 20分钟 | 2分钟 | 18分钟 | 100% |
| 关键文档归档 | 1小时 | 30分钟 | 30分钟 | 100% |
| 文件清理 | 1小时 | 30分钟 | 30分钟 | 100% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 易用性 | 高 | 低 | 中 | 高 |
| 功能丰富性 | 高 | 低 | 中 | 高 |
| 自动化程度 | 高 | 低 | 中 | 高 |
| 成本 | 低 | 高 | 中 | 高 |
| 学习曲线 | 低 | 高 | 中 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 文件命名混乱 | 导致文件难以检索和管理 | 影响工作效率和文件安全 | 构建命名规范 | 时间节约20% |
| 文件夹结构复杂 | 导致文件难以查找 | 影响工作效率 | 设计清晰文件夹结构 | 时间节约30% |
| 文件检索困难 | 导致文件难以找到 | 影响工作效率 | 文件检索功能 | 时间节约50% |
问题处理指引
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 文件无法重命名 | 文件权限问题 | 检查文件权限 | 修改文件权限 |
| 文件夹结构无法设计 | 文件夹路径错误 | 检查文件夹路径 | 修正文件夹路径 |
| 文件检索失败 | 检索条件错误 | 检查检索条件 | 修正检索条件 |
| 关键文档无法归档 | 文件格式不支持 | 检查文件格式 | 转换文件格式 |
| 文件清理失败 | 清理规则错误 | 检查清理规则 | 修正清理规则 |
安全准则
- 确保文件管理工具具有访问控制功能,防止未授权访问。
- 定期备份文件,防止数据丢失。
- 避免将敏感文件存储在公共位置,如桌面或下载文件夹。
- 使用强密码保护文件管理工具的账户。
- 定期更新文件管理工具,以修复已知的安全漏洞。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
功能特性
- 自动化执行: 文件与文件夹管理工具,覆盖命名规范、文件夹结构、文件检索与关键文档归档。File 是文件与文件夹管理的完整工具,覆盖桌面
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
FAQ
Q1: 文件管理整理支持哪些输入格式?
A1: 文件与文件夹管理工具,覆盖命名规范、文件夹结构、文件检索与关键文档归档。File 是文件与文件夹管理的完整工具,覆盖桌面整理、命名规范构建、文件夹结构设计、。支持文本指令和结构化参数输入,具体格式参考使用流程章节。
Q2: 需要配置API Key吗?
A2: 是的,部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求,并通过环境变量安全配置。
Q3: 命令行执行失败怎么办?
A3: 检查命令参数是否正确,确认运行环境支持exec能力。如遇权限问题,请参照错误处理章节排查。
故障恢复
针对文件管理整理使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
文件管理整理通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
快速上手
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
文件管理整理通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
依赖说明
运行环境
- Agent 平台: 支持SKILL.md的任意AI Agent
- 操作系统: Windows / macOS / Linux
可用性分类
- 分类: MD(纯Markdown指令,通过自然语言驱动Agent完成操作)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。
Related skills
- Downloads
- 490All time
- Security audit
- Review
- Last updated
- 2mo ago
- Current version
- v1.0.1
- License
- MIT-0
