📦 File — 文件

v1.0.0

使用结构化目录、清晰命名、定期审计、死文件检测和安全清理实践来组织并维护 AI agent 工作区。

13· 0·0 当前·0 累计
briandavisbikes-code 头像by @briandavisbikes-code (bgdavisX)
0
安全扫描
VirusTotal
Pending
查看报告
OpenClaw
安全
high confidence
该技能的文件和运行时指令与其声明目的(工作区整理与审计)一致;无需凭据、无需网络访问,所含脚本仅执行本地文件系统检查。
评估建议
该技能看起来逻辑清晰、风险较低,但在敏感或生产工作区运行前请复查: 1) 自行检查 audit-workspace.sh(仅列出并报告文件),先用测试/工作区副本运行。 2) 删除任何内容前确保已有备份或 git 保存点——文档已提醒。 3) 注意 SKILL.md 引用了 OpenClaw 专属路径及 'openclaw cron list' 命令;若该工具不存在,相关检查会无害失败。 4) 如计划自动清理,须加入显式人工复核步骤,而非自动删除。如需额外保障,用非特权账户运行审计脚本,确认无意外命令或网络连接。...
详细分析 ▾
用途与能力
名称和描述与提供的材料一致:指导文档加上一个本地审计脚本,用于检查工作区目录、文件类型、修改时间和大小。仓库中没有任何内容请求无关权限(无需云凭证,无外部服务)。
指令范围
SKILL.md 指导本地检查命令(grep、find、du、crontab 检查)和保守的清理操作(使用 trash、删除前 commit)。它引用 OpenClaw 专属路径(~/.openclaw/workspace)和命令(openclaw cron list),与代理工作区管理技能一致。指令未要求将数据发送至外部端点,也未要求读取无关的机密文件。
安装机制
未提供安装规范(仅含说明文档和一个小型 shell 脚本),因此安装器不会下载或写入任何内容。附带的审计脚本体积小巧、可读性强,仅执行本地文件系统查询。
凭证需求
该技能未声明任何必需的环境变量、凭据或配置文件路径。其执行的操作(检查工作区文件与 crontab)与文件管理/审计工具相称。
持久化与权限
该技能并非始终启用,也不会请求修改其他技能或系统级配置。它在本地运行,且不含任何自主安装钩子。
安全有层次,运行前请审查代码。

运行时依赖

无特殊依赖

安装命令

点击复制
官方npx clawhub@latest install file-management-by-brian
镜像加速npx clawhub@latest install file-management-by-brian --registry https://cn.longxiaskill.com

技能文档

文件管理技能 一种经实战检验的 AI 代理工作区组织与可维护方案。

概述 本技能记录通过 OpenClaw 实际使用沉淀出的文件管理体系,涵盖工作区结构、命名规范、死文件检测与清理流程。

何时使用

  • 新代理入职或新建工作区
  • 定期工作区审计
  • 大幅调整结构前
  • 感到杂乱无序时

核心原则

  • 每份文件都有使命
- 活跃文件:cron 或代理正在使用的脚本、配置、数据 - 参考文件:文档、策略、笔记 - 归档文件:旧版本、已完成项目产物 - 死文件:被遗弃的脚本、旧实验、未用工具

  • 结构反映功能
workspace/ ├── memory/ # 每日会话日志与运行上下文 ├── skills/ # 已安装技能目录 ├── project-1/ # 项目专属目录 ├── project-2/ ├── ACTIVE.md # 当前运行项目与优先级 ├── DREAMS.md # 后台处理笔记 └── ARCHIVED/ # 已完成或放弃的项目

  • 命名约定
  • 脚本:bash 用 .sh,Python 用 .py,JavaScript 用 .js
  • 日志:以 .log 结尾
  • 配置:以 .json、.yaml 或 .md 结尾
  • 每日笔记:memory/YYYY-MM-DD.md
  • 定期审计
每月或重大变更后运行审计脚本,识别:
  • 死文件(无 cron 或脚本引用)
  • 占用空间的大文件
  • 过时文档

快速审计命令 # 查找未被任何 cron 或脚本引用的文件 grep -r "filename" ~/path/to/workspace/ --include=".sh" --include=".py" --include=".js" # 查找最近 7 天修改的文件 find ~/path/to/workspace -type f -mtime -7 # 按目录查看磁盘占用 du -sh ~/path/to/workspace//

清理最佳实践

  • 不直接删除,用 trash 替代 rm
  • 删除前先在 memory 记录文件用途
  • 清理前确认无活跃引用
  • 大规模清理前先提交,留可回退点

完整文档 详见 FILE-MANAGEMENT.md,内含:

  • 目录结构详解
  • 活跃与归档文件定义
  • 死文件判定标准
  • 清理检查清单示例
数据来源ClawHub ↗ · 中文优化:龙虾技能库