SOC 직업 분류 기준
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/databufflabs/databuff --skill skill-summary-html명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
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/ 读取。