geo-ai-search-optimization 1.2.0 → 1.2.2

package/README.md

@@ -189,6 +189,42 @@ geo-ai-search-optimization completion-report https://example.com
 - 建议复测命令
 - 可直接复用的完成回报模板
 
+## Handoff Bundle 命令
+
+如果你希望把 `agent-handoff`、`apply-plan`、`completion-report` 一次打成一个完整交接包，现在可以用 `handoff-bundle`：
+
+```bash
+geo-ai-search-optimization handoff-bundle ./your-site
+geo-ai-search-optimization handoff-bundle ./your-site --task fix-01 --format json --out ./reports/handoff-bundle.json
+geo-ai-search-optimization handoff-bundle https://example.com
+```
+
+`handoff-bundle` 会输出：
+
+- 单一 bundle summary
+- handoff 摘要
+- apply plan 摘要
+- completion report 摘要
+- 下一步该先做哪一个任务
+
+## Share Pack 命令
+
+如果你希望把同一份 GEO 结果直接分享给 PM、工程、管理层和下一位 agent，现在可以用 `share-pack`：
+
+```bash
+geo-ai-search-optimization share-pack ./your-site
+geo-ai-search-optimization share-pack ./your-site --task fix-01 --format json --out ./reports/share-pack.json
+geo-ai-search-optimization share-pack https://example.com
+```
+
+`share-pack` 会输出：
+
+- 给 PM 的摘要
+- 给工程 / 执行团队的任务视图
+- 给管理层的高层摘要
+- 给下一位 agent 的交接入口
+- 建议分享顺序
+
 ## Fix Plan 命令
 
 如果你已经跑过 `audit`、`report` 或 `onboard-url`，下一步就可以直接把结果转成 PM 待办清单：
@@ -342,6 +378,8 @@ geo-ai-search-optimization audit ./my-site
 geo-ai-search-optimization agent-handoff ./my-site
 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 exec-summary ./my-site
 geo-ai-search-optimization fix-plan ./my-site
 geo-ai-search-optimization owner-board ./my-site
@@ -357,6 +395,20 @@ geo-ai-search-optimization version
 geo-ai-search-optimization help
 ```
 
+## New in 1.2.2
+
+- 新增 `share-pack`
+- 让同一份 GEO 结果按 PM、工程、管理层、Agent 四种视图分享
+- 更适合直接转发，而不是人工重新整理内容
+- 新增 `geo-ai-search-optimization-share-pack` skill，帮助消费分享包
+
+## New in 1.2.1
+
+- 新增 `handoff-bundle`
+- 把 `agent-handoff + apply-plan + completion-report` 打成一个完整交接包
+- 更适合 agent 或团队直接接力，而不用自己拼多个工件
+- 新增 `geo-ai-search-optimization-handoff-bundle` skill，帮助消费 bundle
+
 ## New in 1.2.0
 
 - 新增 `completion-report`

package/package.json

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

@@ -45,6 +45,8 @@ geo-ai-search-optimization fix-plan ./your-site --format json --out ./reports/fi
 geo-ai-search-optimization agent-handoff ./your-site --out ./reports/agent-handoff.md
 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 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
@@ -61,7 +63,9 @@ geo-ai-search-optimization roadmap ./your-site --out ./reports/roadmap.md
 4. 需要交接给 agent 时，生成 agent-handoff 工件
 5. 需要 agent 直接开始做时，生成 apply-plan
 6. 完成一轮后生成 completion-report
-7. 重跑 scan / audit / report 验证是否改善
+7. 需要完整交接包时生成 handoff-bundle
+8. 需要发给不同角色时生成 share-pack
+9. 重跑 scan / audit / report 验证是否改善
 
 ## 推荐节奏
 

package/resources/geo-ai-search-optimization-handoff-bundle/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: geo-ai-search-optimization-handoff-bundle
+description: Consume a bundled GEO handoff package that contains agent-handoff, apply-plan, and completion-report together. Use when an agent or PM needs one consolidated artifact to continue GEO execution without jumping across multiple files.
+---
+
+# GEO Handoff Bundle
+
+Use this skill when the user gives you a combined GEO execution package and expects you to continue from it directly.
+
+`GEO = Generative Engine Optimization`
+
+## What a handoff bundle means
+
+A handoff bundle is the single-file version of the GEO execution loop:
+
+1. `agent-handoff`: what the next agent should take over
+2. `apply-plan`: how to execute
+3. `completion-report`: how to close out the round
+
+## How to use it
+
+- read the bundle summary first
+- inspect `applyPlan.packets[0]` or the explicitly requested task first
+- use `completionReport` to understand residual risks and next-round work
+- if you need the exact prompts, use the nested `handoff` and `applyPlan` fields
+
+## Response order
+
+Always tell the user:
+
+1. what task you will start with
+2. what mode you are in
+3. what you will do next
+4. how you will report completion

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

@@ -0,0 +1,27 @@
+---
+name: geo-ai-search-optimization-share-pack
+description: Use when a GEO result needs to be shared to different audiences. It combines PM, execution, executive, and agent-facing views into one package so teams can distribute the right output without manually repackaging artifacts.
+---
+
+# GEO Share Pack
+
+Use this skill when the user wants a shareable GEO package for multiple audiences.
+
+`GEO = Generative Engine Optimization`
+
+## What it contains
+
+A share pack combines:
+
+- PM-facing summary
+- execution-team task view
+- executive summary
+- agent handoff bundle
+
+## How to use it
+
+- read the audience order first
+- send the PM section to prioritization owners
+- send the owner board section to execution teams
+- send the executive section to management
+- send the handoff bundle section 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 eight layers:
+The package is best explained as ten layers:
 
 1. `onboard-url` / `onboard`: first look
 2. `scan`: raw signal check
@@ -22,7 +22,9 @@ The package is best explained as eight layers:
 5. `agent-handoff`: agent takeover package
 6. `apply-plan`: execution loop
 7. `completion-report`: closeout
-8. `pm-brief` / `roadmap`: stakeholder alignment
+8. `handoff-bundle`: all-in-one package
+9. `share-pack`: audience-ready delivery
+10. `pm-brief` / `roadmap`: stakeholder alignment
 
 ## Recommended command order
 
@@ -43,6 +45,8 @@ npx geo-ai-search-optimization fix-plan ./your-site
 npx geo-ai-search-optimization agent-handoff ./your-site
 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 owner-board ./your-site
 npx geo-ai-search-optimization roadmap ./your-site
 ```
@@ -58,6 +62,8 @@ npx geo-ai-search-optimization roadmap ./your-site
 - `agent-handoff`: turn GEO findings into an artifact an agent can directly continue from
 - `apply-plan`: turn handoff into execution packets with validation commands and completion template
 - `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
 - `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
@@ -72,6 +78,8 @@ When explaining the tool to a user:
 - if the user wants another agent to take over, move them to `agent-handoff`
 - if the user wants the next agent to start executing, move them to `apply-plan`
 - 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 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

@@ -87,6 +87,22 @@ If they only have a URL:
 npx geo-ai-search-optimization completion-report https://example.com
 ```
 
+## If the user says "我想要一个完整交接包"
+
+Recommend:
+
+```bash
+npx geo-ai-search-optimization handoff-bundle ./your-site
+```
+
+## If the user says "我想直接分享给不同角色"
+
+Recommend:
+
+```bash
+npx geo-ai-search-optimization share-pack ./your-site
+```
+
 ## If the user says "我要开会同步"
 
 Recommend:

package/src/cli.js

@@ -8,6 +8,7 @@ import {
   renderCompletionReportMarkdown,
   writeCompletionReportOutput
 } from "./completion-report.js";
+import { createHandoffBundle, renderHandoffBundleMarkdown, writeHandoffBundleOutput } from "./handoff-bundle.js";
 import { installSkill } from "./install-skill.js";
 import { getBundledSkillPath, getInstalledSkillPath, getSkillName, getSkillsDir } from "./paths.js";
 import { renderScanMarkdown, scanProject, writeScanOutput } from "./scan.js";
@@ -28,6 +29,7 @@ import {
 } from "./interactive-onboarding.js";
 import { createQuickStartPlan, renderQuickStartMarkdown, writeQuickStartOutput } from "./quick-start.js";
 import { createSchemaTemplate } from "./schema.js";
+import { createSharePack, renderSharePackMarkdown, writeSharePackOutput } from "./share-pack.js";
 import { analyzeWebsiteUrl, renderWebsiteOnboardingMarkdown, writeWebsiteOnboardingOutput } from "./url-onboarding.js";
 
 let cachedVersion;
@@ -62,6 +64,8 @@ function printHelp() {
       "  geo-ai-search-optimization agent-handoff <input> [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization apply-plan <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
       "  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 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>]",
@@ -417,6 +421,58 @@ async function handleCompletionReport(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleHandoffBundle(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("handoff-bundle 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
+  }
+
+  const format = getFlagValue(args, "--format");
+  const bundle = await createHandoffBundle(input, {
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  const outputJson = format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(bundle, null, 2)}\n`
+    : renderHandoffBundleMarkdown(bundle);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeHandoffBundleOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 handoff bundle：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+async function handleSharePack(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("share-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
+  }
+
+  const format = getFlagValue(args, "--format");
+  const pack = await createSharePack(input, {
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  const outputJson = format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(pack, null, 2)}\n`
+    : renderSharePackMarkdown(pack);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeSharePackOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 share pack：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
 async function handleExecSummary(args) {
   const input = args.find((value) => !value.startsWith("-"));
   if (!input) {
@@ -605,6 +661,16 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "handoff-bundle") {
+    await handleHandoffBundle(rest);
+    return;
+  }
+
+  if (command === "share-pack") {
+    await handleSharePack(rest);
+    return;
+  }
+
   if (command === "exec-summary") {
     await handleExecSummary(rest);
     return;

package/src/handoff-bundle.js

@@ -0,0 +1,118 @@
+import { createAgentHandoff, writeAgentHandoffOutput } from "./agent-handoff.js";
+import { createApplyPlan } from "./apply-plan.js";
+import { createCompletionReport } from "./completion-report.js";
+
+const VALID_FORMATS = new Set(["markdown", "json"]);
+
+function normalizeFormat(format) {
+  const resolved = (format || "markdown").toLowerCase();
+  if (!VALID_FORMATS.has(resolved)) {
+    throw new Error(`不支持的 handoff-bundle 格式：${format}。可选值：${Array.from(VALID_FORMATS).join(", ")}`);
+  }
+  return resolved;
+}
+
+function buildBundleSummary(handoff, applyPlan, completionReport) {
+  return {
+    executionMode: handoff.executionMode,
+    executionType: applyPlan.executionType,
+    progressStatus: completionReport.progressStatus,
+    managementSummary: completionReport.managementSummary
+  };
+}
+
+function buildUsageAdvice(source, executionMode) {
+  if (executionMode === "implementation-ready") {
+    return [
+      `先看 geo-ai-search-optimization handoff-bundle ${source} 的总览，再从 apply-plan 的第一包开始执行。`,
+      "每完成一个任务后，更新 completion-report 作为本轮 closeout。"
+    ];
+  }
+  if (executionMode === "advice-only") {
+    return [
+      "先把 bundle 给 agent 或 PM，看清楚哪些建议已经足够、哪些还缺仓库上下文。",
+      "拿到仓库或 CMS 权限后，重新运行 handoff-bundle 进入 implementation-ready 模式。"
+    ];
+  }
+  return [
+    "先用 bundle 对齐顺序、风险和下一步。",
+    "补齐仓库或页面上下文后，再重跑 bundle，切到可执行模式。"
+  ];
+}
+
+export async function createHandoffBundle(input, options = {}) {
+  const format = normalizeFormat(options.format);
+  const [handoff, applyPlan, completionReport] = await Promise.all([
+    createAgentHandoff(input, { format: "json" }),
+    createApplyPlan(input, { format: "json", taskId: options.taskId }),
+    createCompletionReport(input, { format: "json" })
+  ]);
+
+  return {
+    kind: "geo-handoff-bundle",
+    source: handoff.source,
+    sourceType: handoff.sourceType,
+    format,
+    summary: buildBundleSummary(handoff, applyPlan, completionReport),
+    usageAdvice: buildUsageAdvice(handoff.source, handoff.executionMode),
+    handoff,
+    applyPlan,
+    completionReport
+  };
+}
+
+export function renderHandoffBundleMarkdown(bundle) {
+  const lines = [
+    "# GEO Handoff Bundle",
+    "",
+    `- 输入来源：\`${bundle.source}\``,
+    `- 来源类型：\`${bundle.sourceType}\``,
+    `- 执行模式：\`${bundle.summary.executionMode}\``,
+    `- 执行类型：\`${bundle.summary.executionType}\``,
+    `- 当前进度：${bundle.summary.progressStatus}`,
+    `- 管理层摘要：${bundle.summary.managementSummary}`,
+    "",
+    "## 使用建议",
+    ""
+  ];
+
+  for (const item of bundle.usageAdvice) {
+    lines.push(`- ${item}`);
+  }
+
+  lines.push(
+    "",
+    "## Agent Handoff 摘要",
+    "",
+    `- 当前总结：${bundle.handoff.summary}`,
+    `- 本轮目标：${bundle.handoff.primaryObjective}`,
+    `- 推荐命令数：${bundle.handoff.recommendedCommands.length}`,
+    "",
+    "## Apply Plan 摘要",
+    "",
+    `- 任务包数量：${bundle.applyPlan.selectedTaskCount}`,
+    `- 执行类型：${bundle.applyPlan.executionType}`,
+    `- 第一包：${bundle.applyPlan.packets[0]?.title ?? "无"}`,
+    "",
+    "## Completion Report 摘要",
+    "",
+    `- 本轮已完成项：${bundle.completionReport.completedThisRound.length}`,
+    `- 剩余风险：${bundle.completionReport.residualRisks.length}`,
+    `- 下一轮任务：${bundle.completionReport.nextRoundTasks.length}`,
+    "",
+    "## 建议下一步",
+    ""
+  );
+
+  if (bundle.applyPlan.packets.length > 0) {
+    lines.push(`- 先从 \`${bundle.applyPlan.packets[0].id}\` 开始。`);
+  }
+  lines.push("- 执行后更新 completion-report。");
+  lines.push("- 需要完整细节时，直接读取 bundle 里的 handoff / applyPlan / completionReport 字段。");
+
+  return `${lines.join("\n")}\n`;
+}
+
+export async function writeHandoffBundleOutput(outputPath, content) {
+  return writeAgentHandoffOutput(outputPath, content);
+}

package/src/index.js

@@ -9,6 +9,7 @@ export { createApplyPlan, renderApplyPlanMarkdown, writeApplyPlanOutput } from "
 export { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput } from "./agent-handoff.js";
 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 { installSkill } from "./install-skill.js";
 export { runCli } from "./cli.js";
 export { runDoctor, renderDoctorMarkdown } from "./doctor.js";
@@ -22,4 +23,5 @@ export { generateReport, writeReportOutput } from "./report.js";
 export { createRoadmap, renderRoadmapMarkdown, writeRoadmapOutput } from "./roadmap.js";
 export { createSchemaTemplate } from "./schema.js";
 export { scanProject, renderScanMarkdown, writeScanOutput } from "./scan.js";
+export { createSharePack, renderSharePackMarkdown, writeSharePackOutput } from "./share-pack.js";
 export { analyzeWebsiteUrl, renderWebsiteOnboardingMarkdown, writeWebsiteOnboardingOutput } from "./url-onboarding.js";

package/src/quick-start.js

@@ -60,7 +60,9 @@ function buildSteps() {
         "geo-ai-search-optimization fix-plan ./your-site --out ./reports/fix-plan.md",
         "geo-ai-search-optimization agent-handoff ./your-site --out ./reports/agent-handoff.md",
         "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 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"
       ]
     },
     {

package/src/share-pack.js

@@ -0,0 +1,131 @@
+import { createExecSummary, writeExecSummaryOutput } from "./exec-summary.js";
+import { createHandoffBundle } from "./handoff-bundle.js";
+import { createOwnerBoard } from "./owner-board.js";
+import { createPmBrief } from "./pm-brief.js";
+
+const VALID_FORMATS = new Set(["markdown", "json"]);
+
+function normalizeFormat(format) {
+  const resolved = (format || "markdown").toLowerCase();
+  if (!VALID_FORMATS.has(resolved)) {
+    throw new Error(`不支持的 share-pack 格式：${format}。可选值：${Array.from(VALID_FORMATS).join(", ")}`);
+  }
+  return resolved;
+}
+
+function buildRecommendedAudienceOrder(pack) {
+  const order = ["PM", "工程", "管理层", "Agent"];
+  if (pack.execSummary.thisWeek.length === 0) {
+    return ["PM", "管理层", "工程", "Agent"];
+  }
+  return order;
+}
+
+function buildShareGuidance(pack) {
+  const guidance = [];
+
+  guidance.push("先把 PM brief 发给负责排优先级和推进的人。");
+  guidance.push("把 owner board 发给执行团队，用来分工。");
+  guidance.push("把 exec summary 发给管理层，只保留为什么现在要做与本周重点。");
+  guidance.push("把 handoff bundle 发给下一位 agent，让它直接接手。");
+
+  if (pack.handoffBundle.summary.executionMode === "advice-only") {
+    guidance.push("当前还是建议模式，分享时要明确：还缺仓库或 CMS 上下文。");
+  }
+
+  return guidance;
+}
+
+export async function createSharePack(input, options = {}) {
+  const format = normalizeFormat(options.format);
+  const [pmBrief, ownerBoard, execSummary, handoffBundle] = await Promise.all([
+    createPmBrief(input, { format: "json" }),
+    createOwnerBoard(input, { format: "json" }),
+    createExecSummary(input, { format: "json" }),
+    createHandoffBundle(input, { format: "json", taskId: options.taskId })
+  ]);
+
+  return {
+    kind: "geo-share-pack",
+    source: pmBrief.source,
+    sourceType: pmBrief.sourceType,
+    format,
+    audienceOrder: buildRecommendedAudienceOrder({
+      pmBrief,
+      ownerBoard,
+      execSummary,
+      handoffBundle
+    }),
+    guidance: buildShareGuidance({
+      pmBrief,
+      ownerBoard,
+      execSummary,
+      handoffBundle
+    }),
+    pmBrief,
+    ownerBoard,
+    execSummary,
+    handoffBundle
+  };
+}
+
+export function renderSharePackMarkdown(pack) {
+  const lines = [
+    "# GEO Share Pack",
+    "",
+    `- 输入来源：\`${pack.source}\``,
+    `- 来源类型：\`${pack.sourceType}\``,
+    `- 建议分享顺序：${pack.audienceOrder.join(" -> ")}`,
+    "",
+    "## 分享建议",
+    ""
+  ];
+
+  for (const item of pack.guidance) {
+    lines.push(`- ${item}`);
+  }
+
+  lines.push(
+    "",
+    "## 给 PM",
+    "",
+    `- 一句话总结：${pack.pmBrief.oneLiner}`,
+    `- 当前状态：${pack.pmBrief.status}`,
+    `- 本周先做：${pack.pmBrief.thisWeek[0]?.action ?? "暂无"}`,
+    "",
+    "## 给工程 / 执行团队",
+    ""
+  );
+
+  for (const column of pack.ownerBoard.columns.filter((column) => column.count > 0)) {
+    lines.push(`- ${column.name}：${column.count} 项`);
+  }
+
+  lines.push(
+    "",
+    "## 给管理层",
+    "",
+    `- Headline：${pack.execSummary.headline}`,
+    `- Why Now：${pack.execSummary.whyNow}`,
+    `- Business Impact：${pack.execSummary.businessImpact}`,
+    "",
+    "## 给下一个 Agent",
+    "",
+    `- 执行模式：${pack.handoffBundle.summary.executionMode}`,
+    `- 执行类型：${pack.handoffBundle.summary.executionType}`,
+    `- 第一包：${pack.handoffBundle.applyPlan.packets[0]?.title ?? "无"}`,
+    "",
+    "## 下一步",
+    ""
+  );
+
+  lines.push("- PM 先确认本周优先级。");
+  lines.push("- 工程按 owner board 分工。");
+  lines.push("- Agent 直接从 handoff bundle 的第一包开始。");
+
+  return `${lines.join("\n")}\n`;
+}
+
+export async function writeSharePackOutput(outputPath, content) {
+  return writeExecSummaryOutput(outputPath, content);
+}