OpenClaw 工作区审计器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install xiaoyaoclaw-workspace-auditor
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 xiaoyaoclaw-workspace-auditor。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

OpenClaw 工作区审计器是一款用于代理工作区的本地健康检查工具。它会扫描目录规范、任务进度文件、记忆日志、知识库索引、孤立文件、临时数据和超大文件，但不会更改、删除或移动任何内容。
作为提升工作区可靠性的实用 Openclaw Skills 之一，它会提供红色、黄色和绿色的检查结果及修复建议。扫描器仅使用 Python 标准库，无需访问外部 API，并将工作区数据保留在本地计算机上。

应用场景

在将 OpenClaw 工作区交给其他代理或团队成员之前进行审计。
检查是否存在标准的 projects、tasks、outputs、knowledge、scripts、memory 和 tmp 目录。
检测缺失或无效的任务 PROGRESS.md 文件，以及逾期未完成的工作。
找出记忆日志缺漏、空的 MEMORY.md 文件和过时的每日记忆条目。
查找知识库索引中的孤立项、不受支持的文件类型、根目录中的散落文件和超大文档。
检查过时的临时文件和超过已配置大小限制的工作区文件。
当不适合使用外部 API、网络访问或自动清理时，执行注重隐私的本地检查。
生成机器可读的 JSON 输出，以供自动化、仪表板或其他 Openclaw Skills 使用。

工作原理

从当前目录向上搜索 WORKSPACE.md，以定位工作区根目录；也可以通过 --root 指定路径。
使用确定性的只读检查，对选定的工作区运行 scripts/scan_workspace.py。
验证预期目录布局、根目录整洁度、目录命名规范和受支持的工作区结构。
检查任务容器及其 PROGRESS.md 文件，包括状态 frontmatter 和超过已配置期限的未完成任务。
检查记忆健康状况，包括超过七天的记忆日志缺漏，以及 MEMORY.md 是否存在且非空。
通过 data_structure.md 检查知识库元数据，对比已索引文件与发现的文件，并找出孤立的知识文件或不受支持的格式。
扫描 tmp/ 中的过时文件，并根据超大文件阈值评估所有工作区文件。
当前置技能套件或索引不可用时，应用依赖感知的降级处理，避免误报。
将检查结果显示为红色、黄色、绿色或已跳过项目，并为每个问题提供建议的修复方法。
所有修复均由用户或明确获批的配套工作流执行；审计器绝不会写入、删除或移动工作区文件。

配置指南

Python 3，并可访问标准库。
本地 OpenClaw 工作区。
无需第三方软件包、网络连接或外部 API 凭据。
安装或获取技能
请使用项目仓库获取最新脚本和文档：
https://github.com/dtsola/xiaoyaoclaw-workspace-auditor
将技能文件放入预期的 OpenClaw 技能目录，或直接从已检出的项目目录运行脚本。无需安装软件包。
运行人类可读的审计
python scripts/scan_workspace.py --root --report
如果当前目录位于工作区内，且脚本支持向上查找工作区，则可以省略 --root。
生成机器可读的输出
python scripts/scan_workspace.py --root --report --json
调整阈值
python scripts/scan_workspace.py --root --report --days 30 --max-file 50 --days 控制过时或逾期检查的时间阈值，默认值为 30 天。--max-file 控制以 MB 为单位的超大文件阈值，默认值为 50 MB。在适用情况下，知识库检查也会识别其文档规定的 20 MB 阈值。 安全模型
该命令严格只读。它不会修改、删除、移动或清理文件；除非用户明确指定输出位置，否则也不会将报告写入工作区。
OpenClaw 工作区审计器 数据架构与分类体系
检查的工作区区域
区域 预期数据 健康信号
根目录结构 WORKSPACE.md 和标准目录 目录缺失、多余或名称错误；根目录中存在非 Markdown 杂项
项目和任务 包含 PROGRESS.md 的任务目录 缺少进度卡片、状态 frontmatter 无效、未完成工作逾期
记忆 memory/ 日志和 MEMORY.md 超过七天没有日志、缺少记忆摘要，或 MEMORY.md 为空
知识 knowledge/、data_structure.md 和受支持的源文件 缺少索引、索引孤立项、不受支持的格式、根目录散落文件、超大文件
临时数据 tmp/ 超过已配置过时阈值的文件
整个工作区 递归发现的所有文件 超过已配置最大大小的文件
标准目录分类
工作区顶层预期区域为 projects、tasks、outputs、knowledge、scripts、memory 和 tmp。审计器还会检查常见的系统目录或隐藏目录，并报告意外的一级目录或命名模式，例如不符合 kebab-case 的名称。
报告元数据
严重程度级别：红色表示违规，黄色表示警告，绿色表示检查正常，已跳过表示因缺少依赖而降级的检查。
默认时间阈值：逾期任务和过时临时文件为 30 天；记忆缺漏使用七天规则。
默认通用超大文件阈值：50 MB。
知识库支持的格式：Markdown、PDF 和 XLSX，具体取决于可用的索引配置。
可选输出模式：JSON，可用于自动化及与其他 Openclaw Skills 集成。
报告包含检查结果和修复建议，而不会实际执行修复。

高级特性

完全只读运行，不会自动删除、移动或修改文件。
依赖感知的渐进式检查；集成不可用时会跳过或降级，而不是产生误报。
通过向上查找
WORKSPACE.md
自动发现工作区根目录，也可通过显式的 --root 指定目标。
以红色、黄色、绿色和已跳过状态呈现易读的严重程度报告。
生成机器可读的 JSON 输出，供 CI 检查、仪表板、脚本和代理编排使用。 --days --max-file 配置时间和文件大小阈值。
仅使用 Python 标准库功能，支持跨平台本地运行。
离线且注重隐私：不进行网络调用、不访问外部 API，也不导出数据。
提供修复指引，指出下一步操作；任何破坏性或结构性更改都必须先经用户确认。
当修复需要其他工具时，可清楚地交接给配套 Openclaw Skills，例如知识库索引重建工作流。

name: xiaoyaoclaw-workspace-auditor description: > OpenClaw workspace health auditor (read-only inspection): scans an agent
workspace for directory-structure compliance, task/PROGRESS.md health,
memory-log gaps, knowledge-base index orphans and junk files; outputs a
severity-graded report (red/yellow/green) with fix suggestions via a
zero-dependency Python script (scan_workspace.py, stdlib only). Use when
user asks to audit/inspect/health-check the workspace (工作区体检/审计/健康
检查/看看工作区乱不乱/检查目录规范). 中文：OpenClaw 工作区体检工具（只读审计）。
扫描 agent 工作区健康度：目录结构合规（initializer 规范）、任务进度卡健康
（tracker PROGRESS.md）、记忆日志空窗（memory-distill 约定）、知识库索引
同步与孤儿文件（kb-retriever data_structure.md）、垃圾/临时文件；通过零依赖

Python 脚本（scan_workspace.py，纯标准库）输出分级报告（🔴/🟡/🟢）与修复

建议。只读不修：脚本永不修改/删除任何文件。

OpenClaw Workspace Auditor（工作区体检）

📖 完整文档 / 安装 / 使用 / 常见问题： https://github.com/dtsola/xiaoyaoclaw-workspace-auditor 用户如果需要完整说明，引导其前往 GitHub 仓库查看图文教程与最新版本。

🚀 小遥AI：「让每个人的数字生活，都有一座自己说了算的小遥」：https://project.xiaoyaosai.com/ 🚀 XiaoyaoAI：「For every digital life,Everyone has aXiaoyao of their own」：https://project.xiaoyaosai.com/

工作区「质检员」：只读扫描工作区健康度，输出分级报告 + 修复建议，永不修改任何文件。零依赖（Python 标准库）、纯本地、双平台。

使用范围（写什么 / 不写什么，权限透明）

核心能力： 工作区体检 / 审计 / 健康检查——只读扫描并报告，绝不修改、删除、移动任何文件。

辅助写入（仅当用户明确要求时）：

无。本技能设计为「只报不修」——修复动作一律由用户确认后执行，或引导到对应姊妹技能。

边界承诺：

永不修改/删除/移动工作区任何文件（红线：破坏性操作必须用户决策）
不调用任何外部 API，不联网，数据不出本机
输出报告不写入工作区（除非用户指定路径）
工作流程（触发词：「体检一下工作区 / 审计 / 健康检查 / 看看工作区乱不乱 / 检查目录规范」）
定位工作区根：默认从当前目录向上找 WORKSPACE.md；用户指定路径则用 --root
运行扫描脚本（确定性检查，全部收敛于此）：

python scripts/scan_workspace.py --root --report

需要机器可读结果时加 --json；可调阈值 --days（超龄，默认 30）--max-file（大文件 MB，默认 50）
解读报告：向用户呈现分级明细（🔴 违规 / 🟡 警告 / 🟢 正常 / ⏭️ 降级跳过），每条附修复建议
引导修复（不代劳）：逐条给出修复动作建议，等用户决策后再执行；涉及删除/移动的操作，只给命令或引导到对应技能（如知识库索引重建 → kb-retriever 的 build_index.py）
检查项一览（5 类，渐进式依赖）
检查类 依赖件套 检查内容
目录合规 xiaoyaoclaw-workspace-initializer 标准目录齐全（projects/tasks/outputs/knowledge/scripts/memory/tmp）、根目录纯净（只放 *.md）、根目录无多余目录（标准/系统/隐藏目录之外的一级目录，聚合提示）、命名规范（kebab-case 等，中文名豁免）
任务健康 xiaoyaoclaw-task-progress-tracker 每目录有 PROGRESS.md（目录即容器）、status frontmatter 合法、超龄未完结（>30 天）
记忆健康 xiaoyaoclaw-memory-distill memory/ 日志空窗（>7 天）、MEMORY.md 存在且非空
知识库健康 xiaoyaoclaw-kb-retriever data_structure.md 索引存在、索引同步（孤儿文件 = 检索不到的知识黑洞）、类型支持（md/pdf/xlsx）、超大文件（>20MB）、根目录散文件
垃圾/临时 无 tmp/ 超龄文件（>30 天）、全工作区大文件（>50MB）

依赖降级：未安装对应件套时，相关检查自动跳过并提示（不报假阳性）。例如无 data_structure.md → 知识库检查降级为只查命名/散文件，并提示可装 kb-retriever 建索引。

红线
只读不修：脚本永不写文件。修复动作必须用户确认
不自动删除任何文件（tmp/ 清理也只在用户明确指示后进行）
不联网、不调用外部 API

XiaoyaoClaw Web Clipper

OpenClaw Memory Distill