📦 File — 文件
v1.0.0使用结构化目录、清晰命名、定期审计、死文件检测和安全清理实践来组织并维护 AI agent 工作区。
13· 0·0 当前·0 累计
安全扫描
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 实际使用沉淀出的文件管理体系,涵盖工作区结构、命名规范、死文件检测与清理流程。
何时使用
- 新代理入职或新建工作区
- 定期工作区审计
- 大幅调整结构前
- 感到杂乱无序时
核心原则
- 每份文件都有使命
- 结构反映功能
- 命名约定
- 脚本: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,内含:
- 目录结构详解
- 活跃与归档文件定义
- 死文件判定标准
- 清理检查清单示例