用 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/ 读取。