geo-ai-search-optimization 1.2.2 → 1.2.3

package/README.md

@@ -225,6 +225,24 @@ geo-ai-search-optimization share-pack https://example.com
 - 给下一位 agent 的交接入口
 - 建议分享顺序
 
+## Export Pack 命令
+
+如果你希望直接导出一整包可外发文件，而不是自己一个个生成，现在可以用 `export-pack`：
+
+```bash
+geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack
+geo-ai-search-optimization export-pack ./your-site --task fix-01 --format json --out-dir ./exports/your-site-json
+geo-ai-search-optimization export-pack https://example.com --out-dir ./exports/example-pack
+```
+
+`export-pack` 会生成：
+
+- `pm-brief`
+- `owner-board`
+- `exec-summary`
+- `agent-handoff-bundle`
+- `share-pack`
+
 ## Fix Plan 命令
 
 如果你已经跑过 `audit`、`report` 或 `onboard-url`，下一步就可以直接把结果转成 PM 待办清单：
@@ -380,6 +398,7 @@ geo-ai-search-optimization apply-plan ./my-site
 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 exec-summary ./my-site
 geo-ai-search-optimization fix-plan ./my-site
 geo-ai-search-optimization owner-board ./my-site
@@ -395,6 +414,13 @@ geo-ai-search-optimization version
 geo-ai-search-optimization help
 ```
 
+## New in 1.2.3
+
+- 新增 `export-pack`
+- 直接生成一组可外发文件，而不是只在终端显示
+- 一次导出 PM、工程、管理层、Agent 四类视图
+- 新增 `geo-ai-search-optimization-export-pack` skill，帮助消费导出结果
+
 ## New in 1.2.2
 
 - 新增 `share-pack`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "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

@@ -47,6 +47,7 @@ geo-ai-search-optimization apply-plan ./your-site --out ./reports/apply-plan.md
 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 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
@@ -65,7 +66,8 @@ geo-ai-search-optimization roadmap ./your-site --out ./reports/roadmap.md
 6. 完成一轮后生成 completion-report
 7. 需要完整交接包时生成 handoff-bundle
 8. 需要发给不同角色时生成 share-pack
-9. 重跑 scan / audit / report 验证是否改善
+9. 需要一整包文件时生成 export-pack
+10. 重跑 scan / audit / report 验证是否改善
 
 ## 推荐节奏
 

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

@@ -0,0 +1,26 @@
+---
+name: geo-ai-search-optimization-export-pack
+description: Export GEO results into a shareable folder structure for different audiences. Use when a PM or agent wants ready-to-send files such as pm-brief, owner-board, exec-summary, and agent handoff bundle generated together.
+---
+
+# GEO Export Pack
+
+Use this skill when the user wants one command to generate a folder of GEO deliverables.
+
+`GEO = Generative Engine Optimization`
+
+## What it exports
+
+- `pm-brief`
+- `owner-board`
+- `exec-summary`
+- `agent-handoff-bundle`
+- `share-pack`
+
+## How to use it
+
+- export once
+- send `pm-brief` to PM
+- send `owner-board` to execution teams
+- send `exec-summary` to management
+- send `agent-handoff-bundle` to the next agent

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 ten layers:
+The package is best explained as eleven layers:
 
 1. `onboard-url` / `onboard`: first look
 2. `scan`: raw signal check
@@ -24,7 +24,8 @@ The package is best explained as ten layers:
 7. `completion-report`: closeout
 8. `handoff-bundle`: all-in-one package
 9. `share-pack`: audience-ready delivery
-10. `pm-brief` / `roadmap`: stakeholder alignment
+10. `export-pack`: folder export
+11. `pm-brief` / `roadmap`: stakeholder alignment
 
 ## Recommended command order
 
@@ -47,6 +48,7 @@ npx geo-ai-search-optimization apply-plan ./your-site
 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 owner-board ./your-site
 npx geo-ai-search-optimization roadmap ./your-site
 ```
@@ -64,6 +66,7 @@ npx geo-ai-search-optimization roadmap ./your-site
 - `completion-report`: summarize what the agent finished, residual risks, and next-round work
 - `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
 - `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
@@ -80,6 +83,7 @@ When explaining the tool to a user:
 - if the user wants a closeout summary after one round, move them to `completion-report`
 - 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 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

@@ -103,6 +103,14 @@ Recommend:
 npx geo-ai-search-optimization share-pack ./your-site
 ```
 
+## If the user says "我想直接导出一整包文件"
+
+Recommend:
+
+```bash
+npx geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack
+```
+
 ## If the user says "我要开会同步"
 
 Recommend:

package/src/cli.js

@@ -17,6 +17,7 @@ import { createLlmsTxt } from "./llms-txt.js";
 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 { createOwnerBoard, renderOwnerBoardMarkdown, writeOwnerBoardOutput } from "./owner-board.js";
 import { createMeetingPack, renderMeetingPackMarkdown, writeMeetingPackOutput } from "./meeting-pack.js";
 import { createPmBrief, renderPmBriefMarkdown, writePmBriefOutput } from "./pm-brief.js";
@@ -66,6 +67,7 @@ function printHelp() {
       "  geo-ai-search-optimization completion-report <input> [--format <markdown|json>] [--out <file>]",
       "  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 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>]",
@@ -473,6 +475,21 @@ async function handleSharePack(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleExportPack(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("export-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
+  }
+
+  const pack = await writeExportPack(input, {
+    format: getFlagValue(args, "--format"),
+    taskId: getFlagValue(args, "--task"),
+    outputDir: getFlagValue(args, "--out-dir")
+  });
+
+  process.stdout.write(renderExportPackMarkdown(pack));
+}
+
 async function handleExecSummary(args) {
   const input = args.find((value) => !value.startsWith("-"));
   if (!input) {
@@ -671,6 +688,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "export-pack") {
+    await handleExportPack(rest);
+    return;
+  }
+
   if (command === "exec-summary") {
     await handleExecSummary(rest);
     return;

package/src/export-pack.js

@@ -0,0 +1,111 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createExecSummary, renderExecSummaryMarkdown } from "./exec-summary.js";
+import { createHandoffBundle, renderHandoffBundleMarkdown } from "./handoff-bundle.js";
+import { createOwnerBoard, renderOwnerBoardMarkdown } from "./owner-board.js";
+import { createPmBrief, renderPmBriefMarkdown } from "./pm-brief.js";
+import { createSharePack, renderSharePackMarkdown } from "./share-pack.js";
+
+const VALID_FORMATS = new Set(["markdown", "json"]);
+
+function normalizeFormat(format) {
+  const resolved = (format || "markdown").toLowerCase();
+  if (!VALID_FORMATS.has(resolved)) {
+    throw new Error(`不支持的 export-pack 格式：${format}。可选值：${Array.from(VALID_FORMATS).join(", ")}`);
+  }
+  return resolved;
+}
+
+function sanitizeSegment(value) {
+  return String(value)
+    .replace(/[^a-z0-9-_]+/gi, "-")
+    .replace(/^-+|-+$/g, "")
+    .toLowerCase();
+}
+
+function buildBaseName(sourceType, source) {
+  if (sourceType === "url") {
+    try {
+      const hostname = new URL(source).hostname || "website";
+      return sanitizeSegment(hostname) || "website";
+    } catch {
+      return "website";
+    }
+  }
+
+  return sanitizeSegment(path.basename(source)) || "site";
+}
+
+function getExtension(format) {
+  return format === "json" ? "json" : "md";
+}
+
+function renderByFormat(payload, renderMarkdown, format) {
+  return format === "json" ? `${JSON.stringify(payload, null, 2)}\n` : renderMarkdown(payload);
+}
+
+export async function createExportPack(input, options = {}) {
+  const format = normalizeFormat(options.format);
+  const taskId = options.taskId || null;
+  const [sharePack, pmBrief, ownerBoard, execSummary, handoffBundle] = await Promise.all([
+    createSharePack(input, { format: "json", taskId }),
+    createPmBrief(input, { format: "json" }),
+    createOwnerBoard(input, { format: "json" }),
+    createExecSummary(input, { format: "json" }),
+    createHandoffBundle(input, { format: "json", taskId })
+  ]);
+
+  const baseName = buildBaseName(sharePack.sourceType, sharePack.source);
+  const extension = getExtension(format);
+  const outputDir = path.resolve(options.outputDir || `./exports/${baseName}-geo-pack`);
+
+  const files = [
+    { key: "share_pack", filename: `share-pack.${extension}`, content: renderByFormat(sharePack, renderSharePackMarkdown, format) },
+    { key: "pm", filename: `pm-brief.${extension}`, content: renderByFormat(pmBrief, renderPmBriefMarkdown, format) },
+    { key: "engineering", filename: `owner-board.${extension}`, content: renderByFormat(ownerBoard, renderOwnerBoardMarkdown, format) },
+    { key: "exec", filename: `exec-summary.${extension}`, content: renderByFormat(execSummary, renderExecSummaryMarkdown, format) },
+    { key: "agent", filename: `agent-handoff-bundle.${extension}`, content: renderByFormat(handoffBundle, renderHandoffBundleMarkdown, format) }
+  ];
+
+  return {
+    kind: "geo-export-pack",
+    source: sharePack.source,
+    sourceType: sharePack.sourceType,
+    format,
+    outputDir,
+    files
+  };
+}
+
+export async function writeExportPack(input, options = {}) {
+  const pack = await createExportPack(input, options);
+  await fs.mkdir(pack.outputDir, { recursive: true });
+
+  const writtenFiles = [];
+  for (const file of pack.files) {
+    const targetPath = path.join(pack.outputDir, file.filename);
+    await fs.writeFile(targetPath, file.content, "utf8");
+    writtenFiles.push({ ...file, path: targetPath });
+  }
+
+  return { ...pack, files: writtenFiles };
+}
+
+export function renderExportPackMarkdown(pack) {
+  const lines = [
+    "# GEO Export Pack",
+    "",
+    `- 输入来源：\`${pack.source}\``,
+    `- 来源类型：\`${pack.sourceType}\``,
+    `- 导出目录：\`${pack.outputDir}\``,
+    "",
+    "## 导出文件",
+    ""
+  ];
+
+  for (const file of pack.files) {
+    lines.push(`- ${file.key}：\`${file.path || path.join(pack.outputDir, file.filename)}\``);
+  }
+
+  return `${lines.join("\n")}\n`;
+}

package/src/index.js

@@ -15,6 +15,7 @@ export { runCli } from "./cli.js";
 export { runDoctor, renderDoctorMarkdown } from "./doctor.js";
 export { createLlmsTxt } from "./llms-txt.js";
 export { createExecSummary, renderExecSummaryMarkdown, writeExecSummaryOutput } from "./exec-summary.js";
+export { createExportPack, renderExportPackMarkdown, writeExportPack } from "./export-pack.js";
 export { createMeetingPack, renderMeetingPackMarkdown, writeMeetingPackOutput } from "./meeting-pack.js";
 export { createOwnerBoard, renderOwnerBoardMarkdown, writeOwnerBoardOutput } from "./owner-board.js";
 export { createPmBrief, renderPmBriefMarkdown, writePmBriefOutput } from "./pm-brief.js";

package/src/quick-start.js

@@ -62,7 +62,8 @@ function buildSteps() {
         "geo-ai-search-optimization apply-plan ./your-site --out ./reports/apply-plan.md",
         "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 share-pack ./your-site --out ./reports/share-pack.md",
+        "geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack"
       ]
     },
     {