SuperAPI AI 工具集

seo-geo-answerblocks

营销与增长

查看项目

更新于 10-15 22:11

技能介绍

用途:审计页面段落结构是否便于 AI 引擎整段提取引用,并生成可提取的答案块与 TL;DR 草稿。

主要能力:检查问题式 H2/H3 后首段是否为约 40-60 词直接回答而非铺垫;检查顶层段落是否约 134-167 词且可独立理解,标记“如上所述”“this”等需前文才能解析的指代;检查列表、对比表、术语定义等结构化形式;检查标题是否贴合真实用户提问;检查是否有可逐字提取的开头摘要或要点块;评估语义完整性(能否零外部上下文回答标题)。

使用方式:基于 dispatch envelope 指定的 PageSnapshot,读取 <run_dir>/pages/<slug>.json(headings、text_sample、word_count),段落取自 HTML 文件而非摘要;用 Grep 在 pages/<slug>.html 中找逐字证据;站点产物位于 <run_dir>/site/{robots.json,sitemaps.json,discovery.json}。audit.mjs 已产出的确定性发现列在 <run_dir>/findings.deterministic.json,不要重复输出其 id。若直接以 URL/路径调用且无快照,先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs",使用打印出的快照路径。确定性部分可离线复现:node "${CLAUDE_PLUGIN_ROOT}/scripts/check-answerblocks.mjs" --snapshot <pages/<slug>.json> [--lang en|es|auto](或 --url <u> / --file <path>)。

发现类型:M11.heading.no_direct_answer(fail,severity 3)、M11.passage.unresolved_anaphora(warn,severity 2)、M11.passage.overlong(warn,severity 2)、M11.summary.missing_tldr(warn,severity 2)、M11.answers.ok(pass,severity 3)、M11.lang.unsupported(manual_review,severity 0)。修复分 PROPOSED(答案块改写、TL;DR 草稿,逐条供用户接受/编辑,接受后才生成 fix_preview diff)与 ADVISORY(结构性建议)。绝不静默改写已发布文字,也不为凑段落编造事实,缺失主张留 TODO 占位;本模块无自动修复。

适用场景:长文页面、问答型内容的可提取性审计与改写建议。

限制:语义完整性与指代消解仍需人工判断;渲染 DOM 不可用时状态为 needs_api 或 manual_review,不会误判通过。启发式仅支持 EN 与 ES 词典,其他语言相关字段返回 null 而非 0。词数窗口是观察性启发式,非引擎公布阈值,仅作方向性提示。Google 未要求 AI 专用改写或分块,也未公布段落长度或答案块格式;本模块属可读性与可提取性论证,不应宣传为引擎硬性要求。