القائمة
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/databufflabs/databuff --skill skill-summary-htmlيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | skill.summary.html |
| description | 总结与报告 HTML 产出规范（共享）；何时写文件、如何参考风格模版 |
你可以使用会话工作区工具写出可下载、可预览的交付物。本 Skill 适用于所有数字专家。
| 场景 | 行为 |
|---|---|
| 用户明确说「生成报告」「导出」「写成总结/HTML」等 | 必须用 writeWorkspaceFile 写入 outputs/ |
| 服务巡检且结论较完整 | 必须用 writeWorkspaceFile 写出 HTML 巡检报告到 outputs/，不要先征求同意 |
| 长分析、多指标汇总、根因定位、故障诊断等（非巡检） | 不要主动建议或生成 HTML，直接在对话中回答 |
| 短问答、单点查询、澄清问题 | 不要写文件，直接在对话中回答 |
templates/）多数 HTML 只作色系与观感参考；inspection-report.html 是巡检报告的结构模版（无数据章节可删，勿编造）。
| 文件 | 适用场景 |
|---|---|
inspection-report.html | 服务巡检 / 健康检查报告 |
report-analysis.html | 长分析、根因报告、多指标汇总 |
summary-brief.html | 短总结、一两屏结论 |
trend-chart-snippet.html | 含趋势图的 HTML 必读：ECharts 嵌入结构与 renderTrendChart 示例 |
读取路径：resources/skill.summary.html/templates/{文件名}
listWorkspaceFiles 浏览、不要逐个试读或对比多个模版。readWorkspaceFile 不传 lineRange，默认读取 1-9999 行；若文件仍有内容，再按后续 lineRange 继续读取，直至读完。lineRange 重复读取；允许读取该文件尚未读取的后续范围。inspection-report.html，不必再看其它模版。.html），写入 outputs/{slug}.html。inspection-report.html 章节结构产出；用 inspectService 与补充查询的真实数据填充，禁止编造。.csv / .md / .json，但面向阅读的主结论用 HTML。writeWorkspaceFile（overwrite）写完整文件。仅当发现内容被截断或不完整（如 HTML 缺 </html> / </body>、半截标签）时，再用 mode=append 只补后面缺的部分续写完整；不要一上来就分批写，也不要用 overwrite 把已写入的残片整份清掉重来，更不要用 shell 拼文件。drawTrendCharts 只渲染对话区，不会自动写入 outputs/ 的 HTML。报告里若有趋势章节，必须在 HTML 内嵌可执行图表，禁止留空 <div> 占位。
trend-chart-snippet.html.html 文件时。queryMetricData / queryLogTrend 等拿到真实时序数据（labels + values）。drawTrendCharts 供用户即时看图。resources/skill.summary.html/templates/trend-chart-snippet.html（与其它模版一样一次读完）。<head> 引入 ECharts：<script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script>id 的 .chart-box（固定高度，如 260px）+ 标题/单位</body> 前内嵌 <script>，复制 snippet 中的 renderTrendChart，用真实 title、labels、values、seriesName、unit 调用labels 与 values 长度必须一致；数据来自查询结果，禁止编造。id 不同，可多次调用 renderTrendChart；多系列对比可在同一张图里放多条 series（仍须基于真实数据）。 或外链图片代替趋势图（除非用户明确要求静态截图）。drawTrendCharts 结果——预览 iframe 读不到工具返回值。listWorkspaceFiles：列出 uploads / outputs / resources/...readWorkspaceFile：读附件与风格/结构模版writeWorkspaceFile：写入 outputs/（通用写文件，任意文本后缀）不要用 shell 去找 Skill 包路径；模版统一从 resources/skill.summary.html/ 读取。