SuperAPI AI 工具集

audit-output-styles

编程与开发

查看项目

更新于 10-16 00:23

技能介绍

用途:审计 Claude Code 的输出样式,检查质量、合规性和可用性,适合在创建自定义输出样式或验证已有样式时使用。

初始化:审计前需获取当前 UTC 日期用于时间戳、捕获项目根路径供子代理通信、确保临时目录 .claude/temp/ 存在,并在用户确认后清理陈旧审计文件。output-customization 技能会在此命令运行时自动加载,提供权威校验指引。

审计内容:Markdown 文件格式(必须是 .md 而非 .json)、YAML frontmatter(name、description、keep-coding-instructions)、内容结构与清晰度、文件命名约定、样式切换兼容性。

参数:无参数时审计所有可发现的输出样式;plugin 仅审计插件样式;project 仅审计 .claude/output-styles/.md;user 仅审计 ~/.claude/output-styles/.md;all 显式审计全部范围;--force 忽略修改状态强制审计;--skip-validation 跳过发现项校验(更快但可能含误报)。

执行流程:发现样式(插件目录 plugins//output-styles/.md、项目目录、用户目录;Windows 为 %USERPROFILE%.claude\output-styles\;对 .json 文件发出格式警告)→ 解析参数与范围 → 展示审计计划(SMART 或 FORCE 模式)→ 为每个样式启动 output-style-auditor 子代理,并行批量 3-5 个,结果写入 .claude/temp/ 的 JSON 和 Markdown 文件 → 除非使用 --skip-validation,否则启动 audit-finding-validator 校验并过滤 FALSE_POSITIVE,被过滤项记录到 .claude/temp/audit-filtered-findings.json → 汇总报告各范围结果与详情表,并给出 .json 文件转为 .md 的修复建议。

结果位置:所有审计结果写入 .claude/audit/output-styles.md,可用 /audit-log output-styles 查看当前状态。

限制:frontmatter 需包含 name、description,keep-coding-instructions 为可选;文件名用 kebab-case 加 .md 扩展名;使用 --skip-validation 时不过滤误报且摘要标注 Validation: Skipped。