⚡

审计输出样式Skill audit-output-styles

这个技能是用于审计Claude Code输出样式的工具，通过自动化检查文件格式、内容结构和命名约定，确保样式质量、符合标准并易于使用。适用于创建或验证自定义输出样式，关键词包括：审计、输出样式、Claude Code、代码质量、合规性验证、可用性检查。

测试 0 次安装 0 次浏览 更新于 3/11/2026

name: audit-output-styles description: 审计Claude Code输出样式以检查质量、合规性和可用性。在创建自定义样式或验证现有样式时使用。 argument-hint: [插件 | 项目 | 用户 | 全部] [–强制 | --跳过验证] allowed-tools: 读取, Bash, Glob, Grep, Task model: opus

审计输出样式命令

审计Claude Code输出样式以检查质量、合规性和可用性。

初始化

在审计之前，初始化环境：

  1. 获取当前UTC日期用于审计时间戳。
  2. 捕获项目根路径用于子代理通信。
  3. 确保临时目录（.claude/temp/）存在。
  4. 如果用户确认，清理任何陈旧的审计文件。

output-customization技能提供权威的验证指导（运行此命令时自动加载）。

审计内容

  • Markdown文件格式（必须是.md，而不是.json）
  • YAML frontmatter（名称、描述、keep-coding-instructions）
  • 内容结构和清晰度
  • 文件命名约定
  • 样式切换兼容性

命令参数

参数 描述
(无) 审计所有可发现的输出样式
插件 仅审计插件输出样式
项目 仅审计.claude/output-styles/*.md
用户 仅审计~/.claude/output-styles/*.md
全部 明确审计所有范围
--强制 无论修改状态如何都进行审计
--跳过验证 跳过发现验证（更快，但可能包括误报）

步骤1：发现输出样式

检查插件目录（plugins/*/output-styles/*.md）、项目目录（.claude/output-styles/*.md）和用户目录（在Unix上为~/.claude/output-styles/*.md，在Windows上为%USERPROFILE%\.claude\output-styles\）。

警告发现的任何.json文件（错误格式 - 输出样式必须是markdown）。

步骤2：解析参数

从命令参数解析范围选择器（插件、项目、用户、全部）和--强制标志。过滤发现的样式以匹配请求的范围。

步骤3：呈现审计计划

显示模式（SMART或FORCE）、发现的样式、带有样式的插件以及带有范围的文件列表。

步骤4：执行审计

对于每个样式，生成output-style-auditor子代理，使用以下上下文：

  • 范围（插件、项目或用户）
  • 样式文件的完整路径
  • 样式名称（从文件名派生）
  • 上次审计日期或“从未审计”
  • 当前审计日期
  • 项目根路径

以3-5个批次并行运行子代理。

子代理将发现写入.claude/temp/，包括JSON（用于恢复/聚合）和markdown（用于人工审查）。主对话线程使用其写入/编辑工具收集结果并更新审计日志。

步骤4.5：验证发现

除非存在--跳过验证标志：

  1. 生成audit-finding-validator代理，带有：
    • project_root：捕获的项目根路径
    • audit_type：“output-style”
    • audit_files：.claude/temp/audit-*-output-style-*.json文件路径列表
  2. 等待验证完成
  3. 读取带有验证结果的更新JSON文件
  4. 在聚合前完全过滤掉FALSE_POSITIVE发现
  5. 注意：过滤的发现记录到.claude/temp/audit-filtered-findings.json

如果存在--跳过验证标志：

  • 完全跳过验证阶段（保持当前速度）
  • 呈现所有发现而不过滤
  • 在摘要中注意：“验证：已跳过”

步骤5：最终摘要

报告按范围审计的总数、结果和详细信息表。列出格式警告用于.json文件，并提供修复建议（转换为.md）。

包括验证统计（如果执行了验证）：

  • 验证执行：是/否
  • 已验证的发现：X
  • 过滤的误报：Y
  • 已验证的发现：Z
  • 未验证的发现：W

重要说明

Frontmatter要求

输出样式需要YAML frontmatter，包括name、description，以及可选的keep-coding-instructions。

文件命名

使用kebab-case和.md扩展名（例如，my-style.md）。

跨平台路径

平台 用户样式
Unix ~/.claude/output-styles/
Windows %USERPROFILE%\.claude\output-styles\

审计日志位置

所有审计结果写入.claude/audit/output-styles.md。

使用/audit-log output-styles查看当前审计状态。

使用示例

示例1：审计所有输出样式

用户: /audit-output-styles

Claude: 正在发现输出样式...

## 审计计划
**模式**: SMART
**发现的样式**: 3
**带有样式的插件**: 2

1. [插件:claude-ecosystem] concise-coder.md
2. [插件:soft-skills] code-review-comment.md
3. [项目] custom-style.md

[生成output-style-auditor子代理]

## 审计完成
| 范围 | 样式 | 结果 | 分数 |
| --- | --- | --- | --- |
| 插件 | concise-coder | 通过 | 100/100 |
| 项目 | custom-style | 通过 | 98/100 |

示例2：仅审计插件样式

用户: /audit-output-styles plugin
Claude: 仅审计插件输出样式...