SuperAPI AI 工具集

markdown-csv-reporter

通用与其它

查看项目

更新于 10-16 05:03

技能介绍

用途:markdown-csv-reporter 是一个内部辅助技能,负责将 markdown-a11y-assistant 汇总的 Markdown 无障碍审计结果转换为结构化 CSV 文件,面向报告、跟踪与修复工作流。它只读审计报告,从不修改源文档或审计报告,输出文件写入当前工作目录(VS Code 中为工作区根目录,CLI 中为当前目录),用户可指定替代路径,但不得写入临时目录、会话存储或代理内部状态。

主要能力:解析 MARKDOWN-ACCESSIBILITY-AUDIT.md(或用户指定报告)提取全部发现、评分与元数据;独立按公式重算评分(文件得分=100-加权发现总和,严重-15、重要-7、中等-3、次要-1,下限0,并按90-100 A、75-89 B、50-74 C、25-49 D、0-24 F 分级);为修复项计算 ROI(roi_score=实例总数×严重度权重,严重10、重要7、中等3、次要1),按 roi_score 降序排列;在3个及以上文件中出现的问题标记为 Systemic;为每条发现映射 rule_id 与 WCAG 理解文档 URL,认知类问题使用 COGA 指南 URL;支持增量跟踪,保留 fixed、new、persistent、regressed 等修复状态。

使用方式:由 markdown-a11y-assistant 调用,开始时播报“Generating CSV export...”,完成后播报导出摘要与路径,失败时说明原因且不写文件;返回 files_written、findings_exported、scorecard_files、remediation_items 及 status(success/partial/failed)。CSV 采用 UTF-8 带 BOM、全文本字段双引号、内部引号双写、ISO 8601 日期、CRLF 行尾、首行表头、字段数一致等格式。仅在任务到达对应步骤时按需读取 references/csv-output-files.md,不要一次全部读取。

限制:本技能为内部辅助,依赖上游审计报告与 markdown-a11y-assistant 调度;不修改源报告,不执行修复;关于安装命令、收费与价格等资料暂未提供。