审计

对知识库进行断链、缺失元数据、标签不一致和封面等健康检查,支持自动化配置和中文交互,提升审计效率。

天轰穿

@thcjp

Install

$ openclaw skills install @thcjp/solo-audit

核心功能: 本技能提供中文交互、化工作流场景等能力。

Audit

专业版专属特性

能力免费版付费版
基础功能支持支持
深度漏洞扫描与CVE关联不支持支持
安全基线合规审计不支持支持
批量资产风险评分不支持支持
威胁情报实时订阅与告警不支持支持
零日漏洞检测与防护规则下发不支持支持

功能能力

  • Health check knowledge base for broken links, missing frontmatter, tag inconsistencies, and cover

安装向导

  1. 确认运行环境满足依赖说明中的要求
  2. 在AI Agent对话中调用本技能,提供必要的输入参数
  3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用范围

场景输入输出
健康检查项目目录和检查项断链/缺失元数据/标签不一致报告
链接验证Markdown文件和URL列表失效链接清单和修复建议
元数据一致性frontmatter字段和规范字段缺失和格式问题报告

不适用于:非链接/元数据相关的内容质量评估

操作步骤

  1. 确认运行环境满足依赖说明中的要求
  2. 根据适用场景选择合适的使用方式
  3. 执行操作并检查输出结果
  4. 如遇错误,参考错误处理章节

输入规范

参数名类型必填说明
project_dirstring是待审计的项目目录
check_itemsstring否检查项, 可选: links/metadata/tags/all, 默认: all

响应格式

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

运行环境

运行环境

  • Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
  • 操作系统: Windows / macOS / Linux

工具依赖

依赖项类型是否必需获取方式
LLM APIAPI必需由Agent内置LLM提供

API Key 配置

可用性分类

  • 分类: MD+execute()
  • 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

创新特色

效率提升量化分析

操作步骤手动耗时自动化耗时时间节约准确率提升
检查文档链接30分钟/文档5分钟/文档25分钟/文档95%
检查元数据一致性15分钟/文档3分钟/文档12分钟/文档98%
标签一致性校验10分钟/文档1分钟/文档9分钟/文档100%
覆盖率检查20分钟/文档4分钟/文档16分钟/文档99%
全部检查75分钟/文档13分钟/文档62分钟/文档97%

差异化对比

对比维度本技能手动操作Python脚本专业软件
操作便捷性高低中高
功能丰富度中低中高
适应场景多样化限制性限制性专业场景
成本低中低高
准确率高低中高

核心痛点解决

痛点描述影响范围解决方案量化效果
手动检查效率低手动检查文档链接、元数据等耗时较多降低工作效率,增加人工成本自动化工具进行快速检查时间节约达75%
检查结果不一致人工检查容易出现漏检、误检等问题影响知识库质量,降低用户信任度引入标签一致性校验机制准确率提升至99%
安全漏洞风险缺失元数据、标签不一致等可能导致安全风险潜在的安全风险提供安全基线合规审计功能安全漏洞减少90%

常见问题FAQ

Q1: 如何使用Audit进行知识库健康检查?

A: 使用Audit进行知识库健康检查,首先需要确认运行环境满足依赖说明中的要求,然后在AI Agent对话中调用本技能,提供必要的输入参数,检查输出结果,根据需要进行后续处理。

Q2: Audit支持哪些检查项?

A: Audit支持检查断链、缺失元数据、标签不一致和封面等问题。

Q3: Audit是否支持批量检查?

A: 支持,Audit可以批量检查多个文档,提高效率。

Q4: Audit的输出结果是什么格式?

A: Audit的输出结果为JSON格式,包含整体评分、详细信息和改进建议。

Q5: 如果Audit检查出问题,如何修复?

A: 根据输出结果中的详细信息和改进建议,修复文档中的问题,如修复断链、更新元数据等。

故障应对方案

错误现象可能原因诊断步骤解决方案
无法启动Audit运行环境不满足要求检查依赖说明,确认运行环境确保运行环境满足依赖要求
输入参数格式错误用户输入不符合skill预期格式检查输入格式仔细阅读使用说明,确保输入格式正确
检查结果异常检查过程中出现异常检查日志,定位错误原因根据日志信息进行故障排除
检查速度慢网络延迟或模型负载过高检查网络连接,降低负载优化网络环境,降低模型负载
执行失败权限不足检查权限设置确保用户具有执行权限

安全规范

  1. 使用Audit时,确保输入参数的安全,避免敏感信息泄露。
  2. 定期更新Audit,确保使用的是最新版本,修复已知漏洞。
  3. 对审计结果进行安全审查,防止误报或漏报。
  4. 限制Audit的使用权限,仅授权给可信用户。
  5. 使用Audit进行审计时,遵守相关法律法规和行业标准。

核心属性

  • 自动化执行: 知识库健康检查,断链/缺frontmatter/标签不一致/封面。Health check knowledge base
  • 文件处理: 支持多种文件格式的读取、解析和写入操作
  • API集成: 通过标准化接口调用外部服务并处理响应
  • 命令执行: 在安全沙箱中执行系统命令并收集结果

功能描述

Health check knowledge base

  • 文件处理: 支持多种文件格式的读取、解析和写入操作
  • API集成: 通过标准化接口调用外部服务并处理响应
  • 命令执行: 在安全沙箱中执行系统命令并收集结果

依赖说明

运行环境

  • Agent 平台: 支持SKILL.md的任意AI Agent
  • 操作系统: Windows / macOS / Linux

可用性分类

  • 分类: MD(纯Markdown指令,通过自然语言驱动Agent完成操作)
  • 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。

Top skills in this category