SuperAPI AI 工具集

create-report

办公与效率

查看项目

更新于 10-16 09:32

技能介绍

用途:面向决策、评估、研究或状态结论,产出独立 HTML 报告。开始前先确认目的、受众、问题或决策、来源、输出路径、语气或品牌、必需章节、深度与约束;缺失选择会实质影响成品时才询问。已由其他工作流负责的任务不接手,本技能不是完成关卡。

主要能力:区分决策相关报告与一般报告,决策类默认写入 adrs/work/<change>-report.html,其他默认 reports/<descriptive-slug>.html,尊重用户路径且未经授权不覆盖。执行层控制在约五分钟阅读量,包含答案或结果、范围、关键证据、影响与下一步。对不确定内容标注 Observed、Source-reported、Inference 或 Unknown,引用可定位来源,不编造指标、信心、负责人、日期、状态、理由或引用。每个关键数字和结论需通过页面锚点或标注对话框可追溯,对话框可选,核心证据保留在页面并支持打印,核心内容与章节导航不依赖 JavaScript。转义插入内容,拒绝不安全 URL 方案,允许安全引用链接,仅嵌入已批准资源,隐去密钥、凭据、令牌与个人信息。不得借用其他工作流的权限,报告不等于代码评审、计划、复杂度审计、变更交接或实时应用。

使用方式:选定结构前必读 references/report-design.md,再选定一种原型及必要模块。将 assets/report-template.html 复制到输出路径并替换示例内容,不从零重设样式,可接受真实、安全、可访问且兼容的用户覆盖。完成后审计证据、动作、脱敏与下钻,确认关键数字和结论均有页面目标;未提供的负责人、日期、状态保持 Unassigned、TBD 或 Unknown。再以 file:// 在浅色、深色、约 320px、打印、减少动效和去除脚本模式下验证片段导航、对话框键盘与焦点行为、打印可见证据、无溢出、无外部请求、无控制台或页面错误。清理临时副本、截图、PDF 与浏览器状态,不在报告旁留附属文件。返回产物路径及局限、跳过项与未解决问题,未运行的检查不得声称通过。

验证命令:node scripts/validate-skill-metadata.mjs skills/create-report;node scripts/validate-skill-links.mjs skills/create-report;npx -y skills-ref validate skills/create-report。

限制:不处理非独立 HTML 报告场景,不替代其他工作流,不编造缺失事实;具体收费、价格、平台支持与效果资料暂未提供。