geo-ai-search-optimization 1.2.3 → 1.2.4

package/README.md

@@ -243,6 +243,24 @@ geo-ai-search-optimization export-pack https://example.com --out-dir ./exports/e
 - `agent-handoff-bundle`
 - `share-pack`
 
+## HTML Pack 命令
+
+如果你希望直接生成可浏览的静态 HTML 页面，而不是 Markdown 文件，现在可以用 `html-pack`：
+
+```bash
+geo-ai-search-optimization html-pack ./your-site --out-dir ./exports/your-site-html
+geo-ai-search-optimization html-pack https://example.com --out-dir ./exports/example-html
+```
+
+`html-pack` 会生成：
+
+- `index.html`
+- `pm.html`
+- `engineering.html`
+- `exec.html`
+- `agent.html`
+- `share.html`
+
 ## Fix Plan 命令
 
 如果你已经跑过 `audit`、`report` 或 `onboard-url`，下一步就可以直接把结果转成 PM 待办清单：
@@ -399,6 +417,7 @@ geo-ai-search-optimization completion-report ./my-site
 geo-ai-search-optimization handoff-bundle ./my-site
 geo-ai-search-optimization share-pack ./my-site
 geo-ai-search-optimization export-pack ./my-site --out-dir ./exports/my-site-pack
+geo-ai-search-optimization html-pack ./my-site --out-dir ./exports/my-site-html
 geo-ai-search-optimization exec-summary ./my-site
 geo-ai-search-optimization fix-plan ./my-site
 geo-ai-search-optimization owner-board ./my-site
@@ -414,6 +433,13 @@ geo-ai-search-optimization version
 geo-ai-search-optimization help
 ```
 
+## New in 1.2.4
+
+- 新增 `html-pack`
+- 直接生成可浏览的静态 HTML 页面目录
+- 更适合直接分享链接或打包给不同角色查看
+- 新增 `geo-ai-search-optimization-html-pack` skill，帮助消费 HTML 包
+
 ## New in 1.2.3
 
 - 新增 `export-pack`

package/package.json

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

package/resources/geo-ai-search-optimization/references/quick-start.md

@@ -48,6 +48,7 @@ geo-ai-search-optimization completion-report ./your-site --out ./reports/complet
 geo-ai-search-optimization handoff-bundle ./your-site --out ./reports/handoff-bundle.md
 geo-ai-search-optimization share-pack ./your-site --out ./reports/share-pack.md
 geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack
+geo-ai-search-optimization html-pack ./your-site --out-dir ./exports/your-site-html
 geo-ai-search-optimization owner-board ./your-site --out ./reports/owner-board.md
 geo-ai-search-optimization meeting-pack ./your-site --out ./reports/meeting-pack.md
 geo-ai-search-optimization pm-brief ./your-site --out ./reports/pm-brief.md
@@ -67,7 +68,8 @@ geo-ai-search-optimization roadmap ./your-site --out ./reports/roadmap.md
 7. 需要完整交接包时生成 handoff-bundle
 8. 需要发给不同角色时生成 share-pack
 9. 需要一整包文件时生成 export-pack
-10. 重跑 scan / audit / report 验证是否改善
+10. 需要直接分享页面时生成 html-pack
+11. 重跑 scan / audit / report 验证是否改善
 
 ## 推荐节奏
 

package/resources/geo-ai-search-optimization-html-pack/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: geo-ai-search-optimization-html-pack
+description: Generate a static HTML share package for GEO results. Use when the user wants browsable files like index.html, pm.html, engineering.html, exec.html, and agent.html instead of plain markdown or JSON exports.
+---
+
+# GEO HTML Pack
+
+Use this skill when the user wants a visually shareable GEO output package.
+
+`GEO = Generative Engine Optimization`
+
+## What it generates
+
+- `index.html`
+- `pm.html`
+- `engineering.html`
+- `exec.html`
+- `agent.html`
+- `share.html`
+
+## Best use
+
+- send `index.html` as the landing page
+- share role-specific pages directly when needed

package/resources/geo-ai-search-optimization-usage/SKILL.md

@@ -13,7 +13,7 @@ Treat this tool as a PM-friendly GEO workflow for websites.
 
 `GEO = Generative Engine Optimization`
 
-The package is best explained as eleven layers:
+The package is best explained as twelve layers:
 
 1. `onboard-url` / `onboard`: first look
 2. `scan`: raw signal check
@@ -25,7 +25,8 @@ The package is best explained as eleven layers:
 8. `handoff-bundle`: all-in-one package
 9. `share-pack`: audience-ready delivery
 10. `export-pack`: folder export
-11. `pm-brief` / `roadmap`: stakeholder alignment
+11. `html-pack`: browsable output
+12. `pm-brief` / `roadmap`: stakeholder alignment
 
 ## Recommended command order
 
@@ -49,6 +50,7 @@ npx geo-ai-search-optimization completion-report ./your-site
 npx geo-ai-search-optimization handoff-bundle ./your-site
 npx geo-ai-search-optimization share-pack ./your-site
 npx geo-ai-search-optimization export-pack ./your-site
+npx geo-ai-search-optimization html-pack ./your-site
 npx geo-ai-search-optimization owner-board ./your-site
 npx geo-ai-search-optimization roadmap ./your-site
 ```
@@ -67,6 +69,7 @@ npx geo-ai-search-optimization roadmap ./your-site
 - `handoff-bundle`: combine handoff, execution, and closeout into one artifact
 - `share-pack`: prepare role-specific shareable outputs for PM, engineering, management, and agents
 - `export-pack`: generate a folder with multiple ready-to-send files
+- `html-pack`: generate static HTML pages for sharing and browsing
 - `owner-board`: group tasks by PM / engineering / SEO / content
 - `pm-brief`: prepare a PM summary for meetings and prioritization
 - `roadmap`: turn tasks into a 2-week / 4-week execution sequence
@@ -84,6 +87,7 @@ When explaining the tool to a user:
 - if the user wants one consolidated artifact, move them to `handoff-bundle`
 - if the user wants something ready to forward to multiple audiences, move them to `share-pack`
 - if the user wants actual files on disk for each audience, move them to `export-pack`
+- if the user wants browsable HTML pages, move them to `html-pack`
 - if the user already has a report, move them to `fix-plan`, `owner-board`, or `roadmap`
 
 Read [references/usage-patterns.md](references/usage-patterns.md) when you need response patterns and command selection examples.

package/resources/geo-ai-search-optimization-usage/references/usage-patterns.md

@@ -111,6 +111,14 @@ Recommend:
 npx geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack
 ```
 
+## If the user says "我想直接分享 HTML 页面"
+
+Recommend:
+
+```bash
+npx geo-ai-search-optimization html-pack ./your-site --out-dir ./exports/your-site-html
+```
+
 ## If the user says "我要开会同步"
 
 Recommend:

package/src/cli.js

@@ -18,6 +18,7 @@ import { auditProject, renderAuditMarkdown, writeAuditOutput } from "./audit.js"
 import { createFixPlan, renderFixPlanMarkdown, writeFixPlanOutput } from "./fix-plan.js";
 import { createExecSummary, renderExecSummaryMarkdown, writeExecSummaryOutput } from "./exec-summary.js";
 import { renderExportPackMarkdown, writeExportPack } from "./export-pack.js";
+import { renderHtmlPackMarkdown, writeHtmlPack } from "./html-pack.js";
 import { createOwnerBoard, renderOwnerBoardMarkdown, writeOwnerBoardOutput } from "./owner-board.js";
 import { createMeetingPack, renderMeetingPackMarkdown, writeMeetingPackOutput } from "./meeting-pack.js";
 import { createPmBrief, renderPmBriefMarkdown, writePmBriefOutput } from "./pm-brief.js";
@@ -68,6 +69,7 @@ function printHelp() {
       "  geo-ai-search-optimization handoff-bundle <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization share-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization export-pack <input> [--task <id>] [--format <markdown|json>] [--out-dir <dir>]",
+      "  geo-ai-search-optimization html-pack <input> [--task <id>] [--out-dir <dir>]",
       "  geo-ai-search-optimization exec-summary <input> [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization fix-plan <input> [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization owner-board <input> [--format <markdown|json>] [--out <file>]",
@@ -490,6 +492,20 @@ async function handleExportPack(args) {
   process.stdout.write(renderExportPackMarkdown(pack));
 }
 
+async function handleHtmlPack(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("html-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
+  }
+
+  const pack = await writeHtmlPack(input, {
+    taskId: getFlagValue(args, "--task"),
+    outputDir: getFlagValue(args, "--out-dir")
+  });
+
+  process.stdout.write(renderHtmlPackMarkdown(pack));
+}
+
 async function handleExecSummary(args) {
   const input = args.find((value) => !value.startsWith("-"));
   if (!input) {
@@ -693,6 +709,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "html-pack") {
+    await handleHtmlPack(rest);
+    return;
+  }
+
   if (command === "exec-summary") {
     await handleExecSummary(rest);
     return;

package/src/html-pack.js

@@ -0,0 +1,177 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createExportPack } from "./export-pack.js";
+
+function escapeHtml(value) {
+  return String(value)
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#39;");
+}
+
+function wrapHtml(title, body) {
+  return [
+    "<!doctype html>",
+    '<html lang="zh-Hant">',
+    "<head>",
+    '<meta charset="utf-8">',
+    '<meta name="viewport" content="width=device-width, initial-scale=1">',
+    `<title>${escapeHtml(title)}</title>`,
+    "<style>",
+    "body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;margin:0;background:#f5f7fb;color:#16324f;}",
+    ".shell{max-width:1100px;margin:0 auto;padding:32px 20px 64px;}",
+    ".hero,.card{background:#fff;border:1px solid #d9e2ec;border-radius:16px;box-shadow:0 8px 24px rgba(15,23,42,.06);}",
+    ".hero{padding:28px;margin-bottom:24px;}",
+    ".grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:16px;}",
+    ".card{padding:20px;}",
+    "h1,h2,h3{margin-top:0;color:#102a43;}",
+    "ul{padding-left:20px;line-height:1.7;}",
+    "a{color:#0b7285;text-decoration:none;}",
+    "code,pre{background:#f4f7fb;border-radius:10px;}",
+    "pre{padding:16px;white-space:pre-wrap;overflow:auto;}",
+    ".meta{display:flex;gap:12px;flex-wrap:wrap;color:#486581;}",
+    "</style>",
+    "</head>",
+    "<body>",
+    body,
+    "</body>",
+    "</html>"
+  ].join("");
+}
+
+function buildIndexHtml(pack) {
+  const cards = pack.files
+    .map(
+      (file) => `
+      <article class="card">
+        <h3>${escapeHtml(file.label)}</h3>
+        <p>${escapeHtml(file.description)}</p>
+        <a href="./${escapeHtml(file.filename)}">打开 ${escapeHtml(file.filename)}</a>
+      </article>
+    `
+    )
+    .join("");
+
+  return wrapHtml(
+    "GEO HTML Pack",
+    `
+    <main class="shell">
+      <section class="hero">
+        <h1>GEO HTML Pack</h1>
+        <div class="meta">
+          <span>来源：${escapeHtml(pack.source)}</span>
+          <span>类型：${escapeHtml(pack.sourceType)}</span>
+          <span>目录：${escapeHtml(pack.outputDir)}</span>
+        </div>
+        <p>这是一个适合直接分享的静态 GEO 页面包，分别提供给 PM、工程、管理层和下一位 agent。</p>
+      </section>
+      <section class="grid">
+        ${cards}
+      </section>
+    </main>
+    `
+  );
+}
+
+function buildDocumentHtml(title, content) {
+  return wrapHtml(
+    title,
+    `
+    <main class="shell">
+      <section class="hero">
+        <h1>${escapeHtml(title)}</h1>
+      </section>
+      <section class="card">
+        <pre>${escapeHtml(content)}</pre>
+      </section>
+    </main>
+    `
+  );
+}
+
+export async function writeHtmlPack(input, options = {}) {
+  const baseOutputDir = path.resolve(options.outputDir || "./exports/html-pack");
+  const exportPack = await createExportPack(input, {
+    format: "markdown",
+    taskId: options.taskId,
+    outputDir: baseOutputDir
+  });
+
+  await fs.mkdir(baseOutputDir, { recursive: true });
+
+  const files = [
+    {
+      key: "pm",
+      label: "PM Brief",
+      description: "给 PM 的优先级与推进摘要。",
+      filename: "pm.html",
+      content: exportPack.files.find((file) => file.key === "pm")?.content || ""
+    },
+    {
+      key: "engineering",
+      label: "Owner Board",
+      description: "给工程与执行团队的任务视图。",
+      filename: "engineering.html",
+      content: exportPack.files.find((file) => file.key === "engineering")?.content || ""
+    },
+    {
+      key: "exec",
+      label: "Exec Summary",
+      description: "给管理层的高层摘要。",
+      filename: "exec.html",
+      content: exportPack.files.find((file) => file.key === "exec")?.content || ""
+    },
+    {
+      key: "agent",
+      label: "Agent Bundle",
+      description: "给下一位 agent 的交接入口。",
+      filename: "agent.html",
+      content: exportPack.files.find((file) => file.key === "agent")?.content || ""
+    },
+    {
+      key: "share",
+      label: "Share Pack",
+      description: "给协调者的总览页面。",
+      filename: "share.html",
+      content: exportPack.files.find((file) => file.key === "share_pack")?.content || ""
+    }
+  ];
+
+  await fs.writeFile(path.join(baseOutputDir, "index.html"), buildIndexHtml({ ...exportPack, files }), "utf8");
+
+  for (const file of files) {
+    await fs.writeFile(path.join(baseOutputDir, file.filename), buildDocumentHtml(file.label, file.content), "utf8");
+  }
+
+  return {
+    kind: "geo-html-pack",
+    source: exportPack.source,
+    sourceType: exportPack.sourceType,
+    outputDir: baseOutputDir,
+    files: [
+      { key: "index", path: path.join(baseOutputDir, "index.html") },
+      ...files.map((file) => ({ key: file.key, path: path.join(baseOutputDir, file.filename) }))
+    ]
+  };
+}
+
+export function renderHtmlPackMarkdown(pack) {
+  const lines = [
+    "# GEO HTML Pack",
+    "",
+    `- 输入来源：\`${pack.source}\``,
+    `- 来源类型：\`${pack.sourceType}\``,
+    `- 输出目录：\`${pack.outputDir}\``,
+    "",
+    "## 页面文件",
+    ""
+  ];
+
+  for (const file of pack.files) {
+    lines.push(`- ${file.key}：\`${file.path}\``);
+  }
+
+  return `${lines.join("\n")}\n`;
+}

package/src/index.js

@@ -10,6 +10,7 @@ export { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput
 export { createCompletionReport, renderCompletionReportMarkdown, writeCompletionReportOutput } from "./completion-report.js";
 export { createFixPlan, renderFixPlanMarkdown, writeFixPlanOutput } from "./fix-plan.js";
 export { createHandoffBundle, renderHandoffBundleMarkdown, writeHandoffBundleOutput } from "./handoff-bundle.js";
+export { renderHtmlPackMarkdown, writeHtmlPack } from "./html-pack.js";
 export { installSkill } from "./install-skill.js";
 export { runCli } from "./cli.js";
 export { runDoctor, renderDoctorMarkdown } from "./doctor.js";

package/src/quick-start.js

@@ -63,7 +63,8 @@ function buildSteps() {
         "geo-ai-search-optimization completion-report ./your-site --out ./reports/completion-report.md",
         "geo-ai-search-optimization handoff-bundle ./your-site --out ./reports/handoff-bundle.md",
         "geo-ai-search-optimization share-pack ./your-site --out ./reports/share-pack.md",
-        "geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack"
+        "geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack",
+        "geo-ai-search-optimization html-pack ./your-site --out-dir ./exports/your-site-html"
       ]
     },
     {