geo-ai-search-optimization 1.4.0 → 1.4.1

package/README.md

@@ -81,6 +81,25 @@ geo-ai-search-optimization page-audit ./content/posts/geo-guide.mdx --json --out
 - rewrite brief
 - 可直接交给 agent 的 page-level prompt
 
+## Rewrite Pack 命令
+
+如果你已经知道某个页面有问题，想直接拿到更接近“改写方案”的产物，可以用 `rewrite-pack`：
+
+```bash
+geo-ai-search-optimization rewrite-pack https://example.com/blog/geo-guide
+geo-ai-search-optimization rewrite-pack ./content/posts/geo-guide.mdx
+geo-ai-search-optimization rewrite-pack ./content/posts/geo-guide.mdx --json --out ./reports/rewrite-pack.json
+```
+
+它会输出：
+
+- metadata drafts
+- 建议章节结构
+- FAQ questions
+- schema recommendations
+- execution checklist
+- 可直接交给 agent 的 rewrite prompt
+
 ## Agent Resume 命令
 
 如果 GEO 工作已经做过一轮或多轮，你不想让下一个 agent 从头重新判断，而是想让它从最近一个可靠恢复点继续，可以直接用 `agent-resume`：
@@ -963,6 +982,12 @@ geo-ai-search-optimization help
 - 输出页面分数、问题区域、推荐新增模块、rewrite brief 与 agent prompt
 - 产品能力从“站点级诊断”扩展到“页面级修复入口”
 
+## New in 1.4.1
+
+- 新增 `rewrite-pack`
+- 基于 `page-audit` 继续产出 metadata drafts、章节结构、FAQ questions、schema recommendations 与 execution checklist
+- 让产品从“页面级诊断”继续推进到“页面级改写方案”
+
 ## New in 1.2.20
 
 - 新增 `agent-continue`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Install and run a Generative Engine Optimization (GEO)-first, SEO-supported Codex skill for website optimization.",
   "type": "module",
   "bin": {

package/src/cli-site-ops-commands.js

@@ -15,6 +15,7 @@ import {
 import { createLlmsTxt } from "./llms-txt.js";
 import { auditPage, renderPageAuditMarkdown, writePageAuditOutput } from "./page-audit.js";
 import { createQuickStartPlan, renderQuickStartMarkdown, writeQuickStartOutput } from "./quick-start.js";
+import { createRewritePack, renderRewritePackMarkdown, writeRewritePackOutput } from "./rewrite-pack.js";
 import { renderScanMarkdown, scanProject, writeScanOutput } from "./scan.js";
 import { createSchemaTemplate } from "./schema.js";
 import { analyzeWebsiteUrl, renderWebsiteOnboardingMarkdown, writeWebsiteOnboardingOutput } from "./url-onboarding.js";
@@ -25,6 +26,7 @@ export const SITE_OPS_HELP_LINES = [
   "  geo-ai-search-optimization onboard [--url <website-url>] [--goal <goal>] [--existing-assets <list>] [--json] [--out <file>]",
   "  geo-ai-search-optimization onboard-url <website-url> [--json] [--out <file>]",
   "  geo-ai-search-optimization page-audit <url-or-file> [--json] [--out <file>]",
+  "  geo-ai-search-optimization rewrite-pack <url-or-file> [--json] [--out <file>]",
   "  geo-ai-search-optimization init-llms [target-dir] [--site-name <name>] [--site-url <url>] [--overwrite] [--json]",
   "  geo-ai-search-optimization init-schema <type> [target-dir] [--site-url <url>] [--overwrite] [--json]",
   "  geo-ai-search-optimization audit <project-path> [--json] [--out <file>] [--max-file-size <bytes>] [--max-examples <count>]",
@@ -92,6 +94,21 @@ const handlePageAudit = createStructuredOutputCommandHandler({
   getOutputJson: (args) => hasFlag(args, "--json")
 });
 
+const handleRewritePack = createStructuredOutputCommandHandler({
+  commandLabel: "rewrite pack",
+  execute: async (args) => {
+    const input = args.find((value) => !value.startsWith("-"));
+    if (!input) {
+      throw new Error("rewrite-pack requires a URL or file path");
+    }
+
+    return createRewritePack(input, {});
+  },
+  renderMarkdown: (report) => `${renderRewritePackMarkdown(report)}\n`,
+  writeOutput: writeRewritePackOutput,
+  getOutputJson: (args) => hasFlag(args, "--json")
+});
+
 const handleInitLlms = createActionCommandHandler({
   execute: async (args) =>
     createLlmsTxt({
@@ -171,6 +188,7 @@ export const SITE_OPS_COMMAND_HANDLERS = {
   onboard: handleInteractiveOnboard,
   "onboard-url": handleOnboardUrl,
   "page-audit": handlePageAudit,
+  "rewrite-pack": handleRewritePack,
   "init-llms": handleInitLlms,
   "init-schema": handleInitSchema,
   audit: handleAudit,

package/src/index.js

@@ -43,6 +43,7 @@ export { createPmBrief, renderPmBriefMarkdown, writePmBriefOutput } from "./pm-b
 export { renderPublishPackMarkdown, writePublishPack } from "./publish-pack.js";
 export { createQuickStartPlan, renderQuickStartMarkdown, writeQuickStartOutput } from "./quick-start.js";
 export { generateReport, writeReportOutput } from "./report.js";
+export { createRewritePack, renderRewritePackMarkdown, writeRewritePackOutput } from "./rewrite-pack.js";
 export { createRoadmap, renderRoadmapMarkdown, writeRoadmapOutput } from "./roadmap.js";
 export { createSchemaTemplate } from "./schema.js";
 export { scanProject, renderScanMarkdown, writeScanOutput } from "./scan.js";

package/src/rewrite-pack.js

@@ -0,0 +1,198 @@
+import { auditPage, writePageAuditOutput } from "./page-audit.js";
+
+function buildOpeningDraft(report) {
+  const title = report.metadata.title || "这个页面";
+  return [
+    `${title} 是一页需要先用直接答案说明核心价值的内容。`,
+    "这页最适合先讲清楚它是什么、适合谁、什么时候不适合，以及用户下一步应该看什么。",
+    "如果没有这些信息，生成式搜索系统很难稳定提取出可引用的答案。"
+  ].join(" ");
+}
+
+function buildSuggestedHeadings(report) {
+  const headings = [
+    "这是什么",
+    "适合谁",
+    "什么时候不适合",
+    "和其他方案有什么差别",
+    "关键事实与证据",
+    "下一步该怎么做"
+  ];
+
+  if (report.signals.comparison_intent.count > 0) {
+    headings.splice(3, 1, "和替代方案相比有什么差别");
+  }
+
+  return headings.slice(0, 6);
+}
+
+function buildFaqQuestions(report) {
+  return [
+    `${report.metadata.title || "这页的主题"} 适合哪些人？`,
+    "什么时候不应该选择这个方案？",
+    "有哪些限制条件或前提？",
+    "有哪些证据可以支持这页的主张？"
+  ];
+}
+
+function buildSchemaRecommendations(report) {
+  const recommendations = [];
+
+  if (report.signals.qa_headings.count > 0 || report.headingStats.questionHeadingCount > 0) {
+    recommendations.push("FAQPage");
+  }
+
+  if (report.signals.original_research.count > 0) {
+    recommendations.push("Article");
+  }
+
+  if (report.signals.comparison_intent.count > 0) {
+    recommendations.push("Article");
+  }
+
+  if (recommendations.length === 0) {
+    recommendations.push("Article");
+  }
+
+  return Array.from(new Set(recommendations));
+}
+
+function buildMetadataDrafts(report) {
+  const baseTitle = report.metadata.title || "页面主题";
+  return {
+    title: `${baseTitle}｜适合谁、限制与关键信息`,
+    metaDescription: `${baseTitle} 的直接答案、适用对象、限制条件、关键证据与下一步建议。`,
+    canonical: report.metadata.canonical || "请设置到该页面的唯一正式 URL"
+  };
+}
+
+function buildContentSections(report) {
+  return [
+    {
+      name: "Opening summary",
+      goal: "用 2 到 4 句先给直接答案。",
+      draft: buildOpeningDraft(report)
+    },
+    {
+      name: "Decision block",
+      goal: "明确适合谁、什么时候不适合、主要 trade-off。",
+      bullets: [
+        "适合谁",
+        "主要限制",
+        "决策条件",
+        "如果不适合，应该去看哪一页"
+      ]
+    },
+    {
+      name: "Evidence block",
+      goal: "把结论和主张接到来源、案例、方法论或数据。",
+      bullets: [
+        "来源链接",
+        "方法论说明",
+        "案例或截图",
+        "更新时间"
+      ]
+    }
+  ];
+}
+
+function buildExecutionChecklist(report) {
+  return [
+    "先重写 opening summary，让第一屏可以直接回答用户问题。",
+    "补上问答式 H2 和 decision block。",
+    "补来源链接、作者/更新时间和 evidence block。",
+    "补最贴近页面真实内容的 schema。",
+    "完成后重新跑 page-audit，对比分数和问题区域。"
+  ];
+}
+
+export async function createRewritePack(input, options = {}) {
+  const pageAudit = await auditPage(input, options);
+
+  return {
+    kind: "geo-rewrite-pack",
+    input,
+    sourceType: pageAudit.sourceType,
+    reference: pageAudit.reference,
+    summary: `这份 rewrite pack 基于单页审计生成，优先帮助你把页面改成更适合生成式搜索理解与引用的 answer-first 结构。`,
+    currentScore: {
+      score: pageAudit.score.score,
+      maxScore: pageAudit.score.maxScore,
+      label: pageAudit.scoreLabel
+    },
+    pageAudit,
+    metadataDrafts: buildMetadataDrafts(pageAudit),
+    suggestedHeadings: buildSuggestedHeadings(pageAudit),
+    faqQuestions: buildFaqQuestions(pageAudit),
+    schemaRecommendations: buildSchemaRecommendations(pageAudit),
+    contentSections: buildContentSections(pageAudit),
+    executionChecklist: buildExecutionChecklist(pageAudit),
+    agentPrompt: [
+      "请根据这份 rewrite pack 改写页面。",
+      `页面：${pageAudit.reference}`,
+      `当前分数：${pageAudit.score.score}/${pageAudit.score.maxScore}`,
+      `优先处理：${pageAudit.problemAreas.map((item) => item.area).join("、") || "opening summary 与 evidence block"}`,
+      "先改 metadata drafts 和 opening summary，再补 headings、FAQ、evidence block、schema。",
+      "改完后重新跑 page-audit，确认页面级 GEO 分数有提升。"
+    ].join(" ")
+  };
+}
+
+export function renderRewritePackMarkdown(pack) {
+  const lines = [
+    "# GEO Rewrite Pack",
+    "",
+    `- 输入：\`${pack.input}\``,
+    `- 分析对象：\`${pack.reference}\``,
+    `- 当前分数：\`${pack.currentScore.score}/${pack.currentScore.maxScore}\`（${pack.currentScore.label}）`,
+    `- 总结：${pack.summary}`,
+    "",
+    "## Metadata Drafts",
+    "",
+    `- title：${pack.metadataDrafts.title}`,
+    `- meta description：${pack.metadataDrafts.metaDescription}`,
+    `- canonical：${pack.metadataDrafts.canonical}`,
+    "",
+    "## Suggested Headings",
+    ""
+  ];
+
+  for (const heading of pack.suggestedHeadings) {
+    lines.push(`- ${heading}`);
+  }
+
+  lines.push("", "## FAQ Questions", "");
+  for (const question of pack.faqQuestions) {
+    lines.push(`- ${question}`);
+  }
+
+  lines.push("", "## Schema Recommendations", "");
+  for (const schema of pack.schemaRecommendations) {
+    lines.push(`- ${schema}`);
+  }
+
+  lines.push("", "## Content Sections", "");
+  for (const section of pack.contentSections) {
+    lines.push(`- ${section.name}｜${section.goal}`);
+    if (section.draft) {
+      lines.push(`  Draft：${section.draft}`);
+    }
+    if (section.bullets) {
+      for (const bullet of section.bullets) {
+        lines.push(`  - ${bullet}`);
+      }
+    }
+  }
+
+  lines.push("", "## Execution Checklist", "");
+  for (const item of pack.executionChecklist) {
+    lines.push(`- ${item}`);
+  }
+
+  lines.push("", "## Agent Prompt", "", pack.agentPrompt, "");
+  return lines.join("\n");
+}
+
+export async function writeRewritePackOutput(outputPath, content) {
+  return writePageAuditOutput(outputPath, content);
+}