用途:artifact-report 用于生成单文件 HTML 报告,适用状态更新、复盘、事件时间线、PR 说明等。其输出契约规定:始终产出一个 .html 文件,绝不是 .md 或纯文本,即使面向“内部”或“工作”报告也保持 HTML 形态。
主要能力:提供三种子类型模板——状态报告(templates/status-report.html,用于周期性“已交付、延期、下一步”更新)、事故报告(templates/incident-report.html,用于停机或生产事故后的逐分钟时间线、缓解与跟进)、PR 说明(templates/pr-writeup.html,作者侧 PR 描述,含动机、前后对比、逐文件导览、审阅重点)。若请求不匹配,可从状态报告模板改造。使用 templates/ 中的模板,将 artifact.css 内联进 <style>(Mode B 单文件便携)或 <link> 引用;使用 artifact-css/SKILL.md 中的类词汇(.panel、.kv-strip、.timeline、.callout、.badge、.note 等),而非 Markdown 语法。
使用方式:先阅读 artifact-css/SKILL.md 获取完整输出契约、设计系统与页面骨架。状态报告按头部、摘要带(四个 .stat 卡片)、亮点(三到五条)、正文分节、下一步的顺序组织,尽量控制在一屏。事故报告以时间线为核心,含事故 ID、一行标题、.kv-strip(时长、检测时间、解决时间、负责人、严重度)、TL;DR .callout、纵向时间线(用 .dot 颜色区分警报、缓解、中性事件)、根因、变更表、检测与响应说明。PR 说明含头部、动机、前后对比 .grid-2、逐文件导览、审阅重点、测试表、发布 .kv-strip。
风格规则:以动词开头,每项主张配一个具体数据,使用真实名称(服务名、文件路径、工单号)并置于 mono,删除填充句,坦诚说明未完成事项。
限制:资料未提供安装命令、收费、价格、平台或效果信息,暂未提供。常见错误包括统计卡只填易计数项、TL;DR 过长、时间线所有点同色、PR 说明仅复述 diff。生成后应主动提出同时产出一段可粘贴到 Slack 或邮件的纯文本摘要,HTML 是规范产物,纯文本是分发渠道。