geo-dual-report
当任意 GEO 技能已产出分析报告 MD(审计/调研/竞品/可引用性/技术/绩效等)后,须用本 skill 生成同 basename 的专业 HTML 可视化报告(Chart.js、KPI 卡、CSS 动效)。监测专用仍用 geo-monitor-report。
SKILL.mdskills/geo-dual-report/SKILL.md
GitHubGEO 分析报告 HTML 同步(双交付)
规则:凡 GEO Tab 下产出的报告/分析类 .md(非成稿正文、非 llms.txt/schema),必须 先完成 MD 落盘,再同步生成 同名 .html。
顺序(硬约束):write_file {basename}.md → read_file 确认 → read_skill geo-dual-report → write_file {basename}.html。禁止跳过 MD 直接写 HTML。
| MD 示例 | HTML |
|---|---|
aeo-audit.md |
aeo-audit.html |
keywords.md |
keywords.html |
competitor-visibility.md |
competitor-visibility.html |
monitor-report.md |
走 geo-monitor-report → geo-monitor-report.html |
权威绑定表:config/geo-dual-report.manifest.json
工作流(每份分析 MD 执行一次)
- 前置:确认
{basename}.md已由上游 skill write_file 落盘;若不存在须先补写 MD,禁止本步替代写作 - 读 MD:
read_file提取标题、摘要、分数、表格、P0/P1 行动项 - 写数据侧car(可选但推荐):
{basename}-data.json{ "title": "报告标题", "subtitle": "品牌/站点 · 日期", "score": 78, "kpis": [{"label":"综合分","value":"78"}], "charts": [ {"id":"main","kind":"dimensionRadar","title":"维度得分","labels":["技术","可引用"],"values":[80,65]} ], "sections": [{"heading":"发现","html":"<p>…</p>"}], "actions": [{"priority":"P0","text":"修复 llms.txt"}] } - 复制模板 templates/geo-report-base.html →
{basename}.html- 同目录复制
geo-report-theme.css与geo-chart-theme.js,或内联 CSS/JS 以保证任务目录自包含 - 区块容器保留
data-ngrs-*与data-nova-block-id(供 SuperPreview HTML Studio 结构化编辑)
- 同目录复制
- 注入:替换
{{TITLE}}、{{SUBTITLE}}、{{REPORT_TYPE}};将 JSON 写入<script id="report-data" type="application/json"> - 校验:HTML 含 ≥2 个图表(
charts[].kind来自 ChartCatalog)、KPI 区、行动项区;与 MD 结论一致
报告类型与 ChartCatalog
权威图表注册表:config/geo-chart-catalog.json
视觉规范:NGRS v1 — docs/geo-report-design-system.zh-CN.md
| type | 推荐 kind(≥2 张) |
|---|---|
| audit | scoreGauge, dimensionRadar, severityStackedBar |
| research | keywordHorizontalBar, topicPolarArea, intentDoughnut |
| competitor | competitorGroupedBar, sovDoughnut, gapWaterfallBar |
| citability | sectionRadar, paragraphHorizontalBar, beforeAfterBar |
| technical | checklistProgressBar, severityDonut, dimensionRadar |
| performance | trendLineArea, kpiSparkGrid, channelGroupedBar |
| generic | summaryBar, distributionDoughnut |
- 使用
kind字段(非自造type);旧 kebab id(如keyword-bar)经 alias 仍可识别 - KPI 可附
sparkline: [1,2,3,…]内嵌趋势迷你图 - 禁止自造 Chart.js options 或配色
视觉规范(NGRS v1)
- Nova Graphite 冷色:见
geo-report-theme.css(--ngrs-accent等 token) - 深色模式
prefers-color-scheme: dark自动适配 - 页面动效:fadeUp + stagger;图表:Chart.js animation preset;KPI:countUp + scoreGauge 环
- Chart.js 4.x CDN +
NGRS.createChart(kind, canvas, cfg)
禁止
- 未 write_file / read_file 源 MD 即写 HTML
- 只交付 MD 无 HTML(分析/报告类)
- 用
od-data-report替代 GEO 审计/调研类 HTML(监测除外且应用 geo-monitor-report) - 成稿正文
optimized.md、平台drafts/*.md不强制 HTML(可选摘要页)
与其他 skill 关系
- geo-monitor-hub 聚合后 → geo-monitor-report(监测三件套,本 skill 不替代)
- 其他 GEO 分析 skill 写完 MD 后 → 本 skill
HTML Studio / <html-edit>(用户 UI 复杂改动)
当用户在 SuperPreview 选择「请 AI 协助修改版式」时,Composer 会注入:
@artifacts/.../report.html
<html-edit>具体修改说明</html-edit>
Agent 须:
read_file目标 HTML 与 siblinggeo-report-theme.css/geo-chart-theme.js- 用
write_file/edit_file改文案与布局,禁止改<script id="report-data">内 Chart 数据结构除非用户明确要求 - 保持
data-ngrs-*与#report-dataJSON 字段一致 - 完成后简短告知保存路径,勿贴整页 HTML