geo-ai-search-optimization 1.2.16 → 1.2.18

package/README.md

@@ -42,6 +42,27 @@ geo-ai-search-optimization skills --json
 - agent 执行闭环相关 skills
 - 分享 / 导出 / 最终交付相关 skills
 
+## Agent Orchestrator 命令
+
+如果你希望 agent 不要看长链路，而是直接拿到“现在唯一该跑哪条命令”，可以直接用 `agent-orchestrator`：
+
+```bash
+geo-ai-search-optimization agent-orchestrator "继续这个 GEO 任务"
+geo-ai-search-optimization agent-orchestrator https://example.com
+geo-ai-search-optimization agent-orchestrator ./your-site
+geo-ai-search-optimization agent-orchestrator ./reports/agent-playbook-pack.json --format json --out ./reports/agent-orchestrator.json
+```
+
+它会输出：
+
+- 当前阶段
+- 为什么现在该做这一步
+- 现在只该跑哪条命令
+- 预期产物
+- 什么时候先停下
+- 做完之后下一条是什么
+- 可直接复制给 agent 的 orchestrator prompt
+
 ## Auto Flow 命令
 
 如果你希望 agent 不用自己判断现在该用哪个 skill、该跑哪个命令，可以直接用 `auto-flow`：
@@ -246,6 +267,27 @@ geo-ai-search-optimization agent-retrospective ./reports/agent-decision-log.json
 - 多轮时间线
 - 可直接复制给 agent 的 retrospective prompt
 
+## Agent Playbook Pack 命令
+
+如果你希望把多轮复盘、决策历史和交接信息压成一个“下一位 agent 一拿到就能继续做”的单入口工件，可以直接用 `agent-playbook-pack`：
+
+```bash
+geo-ai-search-optimization agent-playbook-pack ./your-site
+geo-ai-search-optimization agent-playbook-pack ./reports/agent-decision-log.json
+geo-ai-search-optimization agent-playbook-pack ./reports/agent-retrospective.json --format json --out ./reports/agent-playbook-pack.json
+```
+
+`agent-playbook-pack` 会输出：
+
+- 当前状态
+- 恢复摘要
+- 启动命令
+- 当前包与下一包
+- 先读什么
+- 现在先做什么 / 现在不要做什么
+- 后续命令
+- 可直接复制给 agent 的 playbook prompt
+
 ## Quick Start
 
 如果你要从 0 到 1 启动一个 GEO 项目，建议照这个顺序做。
@@ -639,6 +681,7 @@ geo-ai-search-optimization onboard --url https://example.com --json --out ./repo
 geo-ai-search-optimization
 geo-ai-search-optimization install
 geo-ai-search-optimization install --target ./tmp/custom-skills --json
+geo-ai-search-optimization agent-orchestrator ./your-site
 geo-ai-search-optimization auto-flow "audit this site and tell me the next skill"
 geo-ai-search-optimization agent-session ./your-site
 geo-ai-search-optimization agent-runbook ./your-site
@@ -649,6 +692,7 @@ geo-ai-search-optimization agent-status-board ./your-site
 geo-ai-search-optimization agent-checkpoint ./your-site
 geo-ai-search-optimization agent-decision-log ./your-site
 geo-ai-search-optimization agent-retrospective ./your-site
+geo-ai-search-optimization agent-playbook-pack ./your-site
 geo-ai-search-optimization skills
 geo-ai-search-optimization where
 geo-ai-search-optimization doctor
@@ -719,6 +763,22 @@ geo-ai-search-optimization help
 - 输出 do-now checklist、stop checklist、success checklist、验证命令和回报模板
 - 新增 `geo-ai-search-optimization-agent-executor` skill
 
+## New in 1.2.18
+
+- 新增 `agent-orchestrator`
+- 把 `auto-flow + agent-session` 收敛成一个“现在只该做哪条命令”的总入口
+- 输出固定 contract：`current_stage`、`why_now`、`next_command`、`expected_artifact`、`stop_if`、`after_that`
+- 更适合 PM 把任务直接交给 agent，或 agent 接着前一个工件继续做
+- 新增 `geo-ai-search-optimization-agent-orchestrator` skill
+
+## New in 1.2.17
+
+- 新增 `agent-playbook-pack`
+- 把 `agent-retrospective + agent-decision-log + handoff-bundle` 压成一个单入口执行包
+- 让下一位 agent 可以直接从 current packet、start command 和 do-now checklist 继续
+- `completion-report` 现在也能直接吃 retrospective / handoff bundle / playbook pack 这类工件
+- 新增 `geo-ai-search-optimization-agent-playbook-pack` skill
+
 ## New in 1.2.16
 
 - 新增 `agent-retrospective` 命令
@@ -948,6 +1008,7 @@ The installed package now includes a bundled GEO skill pack, including:
 
 - `geo-ai-search-optimization`
 - `geo-ai-search-optimization-auto-flow`
+- `geo-ai-search-optimization-agent-orchestrator`
 - `geo-ai-search-optimization-agent-session`
 - `geo-ai-search-optimization-agent-runbook`
 - `geo-ai-search-optimization-agent-executor`
@@ -957,6 +1018,7 @@ The installed package now includes a bundled GEO skill pack, including:
 - `geo-ai-search-optimization-agent-checkpoint`
 - `geo-ai-search-optimization-agent-decision-log`
 - `geo-ai-search-optimization-agent-retrospective`
+- `geo-ai-search-optimization-agent-playbook-pack`
 - `geo-ai-search-optimization-usage`
 - `geo-ai-search-optimization-agent-handoff`
 - `geo-ai-search-optimization-repair-loop`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.2.16",
+  "version": "1.2.18",
   "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/skill-bundle-map.md

@@ -32,6 +32,16 @@ Best for:
 - turning one-line task briefs into a concrete command sequence
 - deciding whether the work should move into diagnosis, execution, closeout, or delivery
 
+### `geo-ai-search-optimization-agent-orchestrator`
+
+Use this when the next agent should get one immediate next command instead of reading a full command chain.
+
+Best for:
+
+- deciding the one command to run now
+- returning a short contract with expected artifact, stop conditions, and follow-up command
+- reducing ambiguity for PM-to-agent or agent-to-agent handoffs
+
 ### `geo-ai-search-optimization-agent-session`
 
 Use this when the next agent needs a runnable session plan, not just a routing answer.
@@ -122,6 +132,16 @@ Best for:
 - turning decision history into lessons learned and next-round advice
 - producing a cross-round retrospective before meetings, closeout, or final delivery
 
+### `geo-ai-search-optimization-agent-playbook-pack`
+
+Use this when the next agent should get one single-entry resume pack instead of piecing together retrospective, decision history, and handoff artifacts manually.
+
+Best for:
+
+- handing one GEO artifact to the next agent and saying "continue from here"
+- compressing multi-round history into one current packet, one start command, and one follow-up chain
+- reducing restart risk after several GEO rounds or multiple handoffs
+
 ## Usage guide
 
 ### `geo-ai-search-optimization-usage`

package/resources/geo-ai-search-optimization-agent-orchestrator/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: geo-ai-search-optimization-agent-orchestrator
+description: Choose the one next GEO command an agent should run right now. Use when an agent, PM, or another workflow has a GEO URL, codebase, task brief, or artifact and wants a single next command, expected artifact, stop conditions, and follow-up command instead of a full chain.
+---
+
+# GEO Agent Orchestrator
+
+Use this skill when the next agent should not browse a long command chain.
+
+`GEO = Generative Engine Optimization`
+
+## What it does
+
+- turns a GEO input into one immediate next command
+- explains why this command should run now
+- shows what artifact should come out of that command
+- tells the next agent when to stop and what to run after that
+
+## Best use
+
+- when PM wants the next agent to start without reading the whole GEO stack
+- when another agent says "just tell me the next command"
+- when GEO work should continue from a URL, codebase, playbook pack, decision log, or other GEO artifact with minimal ambiguity

package/resources/geo-ai-search-optimization-agent-orchestrator/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GEO Agent Orchestrator"
+  short_description: "Choose the one next GEO command to run now"
+  default_prompt: "Use $geo-ai-search-optimization-agent-orchestrator to pick the one next GEO command to run now, explain why, define the expected artifact, and list stop conditions plus the follow-up command."

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

@@ -0,0 +1,23 @@
+---
+name: geo-ai-search-optimization-agent-playbook-pack
+description: Bundle GEO retrospective, decision history, and handoff artifacts into one single-entry playbook for the next agent. Use when a PM or agent wants the next agent to continue from prior GEO rounds without rebuilding the whole chain, and needs a current packet, start command, do-now checklist, avoid-now checklist, and follow-up commands in one artifact.
+---
+
+# GEO Agent Playbook Pack
+
+Use this skill when the next agent should not rebuild the GEO chain from scratch.
+
+`GEO = Generative Engine Optimization`
+
+## What it does
+
+- reads GEO retrospective, decision log, and handoff bundle style inputs
+- compresses them into one agent-ready entrypoint
+- tells the next agent where to resume, what to do now, and what not to do now
+- keeps cross-round context without forcing the next agent to read every artifact first
+
+## Best use
+
+- when PM wants to hand one artifact to the next agent and say "continue from here"
+- when GEO work has already gone through multiple rounds and needs a stable resume point
+- when the team wants one start command, one current packet, and one follow-up chain instead of many separate artifacts

package/resources/geo-ai-search-optimization-agent-playbook-pack/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GEO Agent Playbook Pack"
+  short_description: "Compress GEO history into one resume entrypoint"
+  default_prompt: "Use $geo-ai-search-optimization-agent-playbook-pack to turn this GEO history into one playbook artifact with a resume summary, start command, do-now checklist, and follow-up commands for the next agent."

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

@@ -13,37 +13,40 @@ Treat this tool as a PM-friendly GEO workflow for websites.
 
 `GEO = Generative Engine Optimization`
 
-The package is best explained as twenty-three layers:
-
-1. `auto-flow`: auto-select the next skill and command chain
-2. `agent-session`: build a runnable session for the next agent
-3. `agent-runbook`: execution manual and checklist for the next agent
-4. `agent-executor`: choose one packet to execute right now
-5. `agent-batch-executor`: queue the first few packets, but still advance one packet at a time
-6. `agent-progress-tracker`: track which packet is done, which one is active, and what comes next
-7. `agent-status-board`: turn the execution state into a board view for PM and agents
-8. `agent-checkpoint`: freeze the current round into a continue / unblock / closeout decision
-9. `agent-decision-log`: preserve why each round continued, paused, or closed out
-10. `agent-retrospective`: explain multi-round patterns, lessons, and next-round advice
-11. `skills`: inspect the bundled skill package
-12. `onboard-url` / `onboard`: first look
-13. `scan`: raw signal check
-14. `audit` / `report`: diagnosis
-15. `fix-plan` / `owner-board`: execution planning
-16. `agent-handoff`: agent takeover package
-17. `apply-plan`: execution loop
-18. `completion-report`: closeout
-19. `handoff-bundle`: all-in-one package
-20. `share-pack`: audience-ready delivery
-21. `export-pack`: folder export
-22. `html-pack` / `publish-pack`: browsable and final delivery output
-23. `pm-brief` / `roadmap`: stakeholder alignment
+The package is best explained as twenty-five layers:
+
+1. `agent-orchestrator`: choose the one next GEO command to run right now
+2. `auto-flow`: auto-select the next skill and command chain
+3. `agent-session`: build a runnable session for the next agent
+4. `agent-runbook`: execution manual and checklist for the next agent
+5. `agent-executor`: choose one packet to execute right now
+6. `agent-batch-executor`: queue the first few packets, but still advance one packet at a time
+7. `agent-progress-tracker`: track which packet is done, which one is active, and what comes next
+8. `agent-status-board`: turn the execution state into a board view for PM and agents
+9. `agent-checkpoint`: freeze the current round into a continue / unblock / closeout decision
+10. `agent-decision-log`: preserve why each round continued, paused, or closed out
+11. `agent-retrospective`: explain multi-round patterns, lessons, and next-round advice
+12. `agent-playbook-pack`: compress retrospective, decision history, and handoff into one resume entrypoint
+13. `skills`: inspect the bundled skill package
+14. `onboard-url` / `onboard`: first look
+15. `scan`: raw signal check
+16. `audit` / `report`: diagnosis
+17. `fix-plan` / `owner-board`: execution planning
+18. `agent-handoff`: agent takeover package
+19. `apply-plan`: execution loop
+20. `completion-report`: closeout
+21. `handoff-bundle`: all-in-one package
+22. `share-pack`: audience-ready delivery
+23. `export-pack`: folder export
+24. `html-pack` / `publish-pack`: browsable and final delivery output
+25. `pm-brief` / `roadmap`: stakeholder alignment
 
 ## Recommended command order
 
 If the user only has a website URL:
 
 ```bash
+npx geo-ai-search-optimization agent-orchestrator https://example.com
 npx geo-ai-search-optimization auto-flow https://example.com
 npx geo-ai-search-optimization agent-session https://example.com
 npx geo-ai-search-optimization agent-runbook https://example.com
@@ -54,6 +57,7 @@ npx geo-ai-search-optimization agent-status-board https://example.com
 npx geo-ai-search-optimization agent-checkpoint https://example.com
 npx geo-ai-search-optimization agent-decision-log https://example.com
 npx geo-ai-search-optimization agent-retrospective https://example.com
+npx geo-ai-search-optimization agent-playbook-pack https://example.com
 npx geo-ai-search-optimization onboard-url https://example.com
 npx geo-ai-search-optimization pm-brief https://example.com
 npx geo-ai-search-optimization roadmap https://example.com
@@ -62,6 +66,7 @@ npx geo-ai-search-optimization roadmap https://example.com
 If the user has the website codebase:
 
 ```bash
+npx geo-ai-search-optimization agent-orchestrator ./your-site
 npx geo-ai-search-optimization auto-flow ./your-site
 npx geo-ai-search-optimization agent-session ./your-site
 npx geo-ai-search-optimization agent-runbook ./your-site
@@ -72,6 +77,7 @@ npx geo-ai-search-optimization agent-status-board ./your-site
 npx geo-ai-search-optimization agent-checkpoint ./your-site
 npx geo-ai-search-optimization agent-decision-log ./your-site
 npx geo-ai-search-optimization agent-retrospective ./your-site
+npx geo-ai-search-optimization agent-playbook-pack ./your-site
 npx geo-ai-search-optimization scan ./your-site
 npx geo-ai-search-optimization audit ./your-site
 npx geo-ai-search-optimization fix-plan ./your-site
@@ -89,6 +95,7 @@ npx geo-ai-search-optimization roadmap ./your-site
 
 ## When to recommend each command
 
+- `agent-orchestrator`: choose the one next GEO command to run now, plus expected artifact, stop conditions, and follow-up command
 - `auto-flow`: auto-select the next skill and command order from a task brief, URL, project path, or GEO artifact
 - `agent-session`: build a step-by-step session packet for the next agent from the same kinds of inputs
 - `agent-runbook`: build a checklist-driven runbook with preflight, validation, and reporting rules
@@ -99,6 +106,7 @@ npx geo-ai-search-optimization roadmap ./your-site
 - `agent-checkpoint`: convert the current round into a checkpoint decision for continue, unblock, or closeout
 - `agent-decision-log`: preserve multiple rounds of checkpoint history so the next agent can inherit the reasoning
 - `agent-retrospective`: explain why the last few rounds advanced or stalled, and turn that into lessons and next-round guidance
+- `agent-playbook-pack`: compress retrospective, decision history, and handoff into one single-entry resume pack for the next agent
 - `onboard-url`: first-time website check from a live URL
 - `onboard`: interactive first-time onboarding
 - `skills`: list the bundled skills and decide which skill or command chain fits the task
@@ -123,6 +131,7 @@ npx geo-ai-search-optimization roadmap ./your-site
 When explaining the tool to a user:
 
 - prefer telling them which command to run next, not listing every command
+- if the user or next agent wants just one next command, move them to `agent-orchestrator`
 - if the user or the next agent is unsure where to start, move them to `auto-flow` first
 - if the user wants something the next agent can follow step by step, move them to `agent-session`
 - if the user wants the next agent to follow a checklist and execution manual, move them to `agent-runbook`
@@ -133,6 +142,7 @@ When explaining the tool to a user:
 - if the user wants a per-round decision artifact that says continue, unblock, or close out, move them to `agent-checkpoint`
 - if the user wants cross-round decision memory and not just one checkpoint, move them to `agent-decision-log`
 - if the user wants to understand why multiple rounds kept advancing or getting stuck, move them to `agent-retrospective`
+- if the user wants one artifact that the next agent can take over from immediately, move them to `agent-playbook-pack`
 - explain the result in PM language, not implementation jargon
 - if the user sounds new, start with `onboard-url` or `quick-start`
 - if the user wants another agent to take over, move them to `agent-handoff`

package/src/agent-orchestrator.js

@@ -0,0 +1,191 @@
+import { createAgentSession } from "./agent-session.js";
+import { writeScanOutput } from "./scan.js";
+
+const VALID_FORMATS = new Set(["markdown", "json"]);
+
+function normalizeFormat(format) {
+  const resolved = (format || "markdown").toLowerCase();
+  if (!VALID_FORMATS.has(resolved)) {
+    throw new Error(`不支持的 agent-orchestrator 格式：${format}。可选值：${Array.from(VALID_FORMATS).join(", ")}`);
+  }
+  return resolved;
+}
+
+function inferOrchestrationMode(session) {
+  if (session.status === "needs-context") {
+    return "needs-context";
+  }
+  if (session.intent === "share") {
+    return "delivery";
+  }
+  if (session.intent === "closeout") {
+    return "closeout";
+  }
+  if (session.intent === "execute") {
+    return "execution";
+  }
+  if (session.intent === "guide") {
+    return "guidance";
+  }
+  return "diagnosis";
+}
+
+function buildWhyNow(session, nextStep) {
+  if (!nextStep) {
+    return "当前还没有足够上下文来确定下一步命令，先补输入。";
+  }
+
+  if (session.artifactKind === "geo-agent-playbook-pack") {
+    return "当前已经有单入口 playbook，不应该重新规划整条链，直接沿着既有恢复点继续最稳。";
+  }
+  if (session.artifactKind === "geo-agent-decision-log") {
+    return "当前已经有跨轮决策历史，下一步应沿着最近一次决策继续，而不是重新做全量判断。";
+  }
+  if (session.artifactKind === "geo-agent-retrospective") {
+    return "当前已经有多轮复盘，下一步应该把复盘结论转成正式动作，而不是回到最前面的扫描阶段。";
+  }
+  if (session.sourceType === "url" && session.intent === "execute") {
+    return "当前只有公开网址，最重要的是先把建议型执行入口建立好，再决定是否需要仓库上下文。";
+  }
+
+  return `${session.whyThisSkill} 当前最该先跑的是 ${nextStep.commandName}，因为它会直接产出下一阶段需要的关键工件。`;
+}
+
+function buildStopIf(session, nextStep) {
+  const items = [...session.contextNeeded];
+
+  if (session.sourceType === "url" && session.intent === "execute") {
+    items.push("只有网址时，不要宣称已经完成代码级修复。");
+  }
+  if (session.artifactKind === "geo-agent-playbook-pack") {
+    items.push("不要绕开 playbook 重新拆一条新链，除非当前 playbook 已明显过时。");
+  }
+  if (nextStep?.commandName === "agent-executor") {
+    items.push("不要同时展开多个任务包；这一轮先推进当前单包。");
+  }
+  if (nextStep?.commandName === "completion-report") {
+    items.push("如果这一轮还没有完成或没有明确验证结果，不要过早进入 closeout。");
+  }
+  if (nextStep?.commandName === "publish-pack") {
+    items.push("如果前面的 completion-report 或 share 结果还不完整，不要直接产出最终交付包。");
+  }
+
+  return Array.from(new Set(items));
+}
+
+function buildAfterThat(session) {
+  return session.steps[1]?.command || null;
+}
+
+function buildOrchestratorPrompt(orchestrator) {
+  const lines = [
+    `Use $${orchestrator.selectedSkill.name} to continue this GEO task.`,
+    `当前输入：${orchestrator.source}`,
+    `当前阶段：${orchestrator.current_stage}`,
+    `当前模式：${orchestrator.orchestration_mode}`,
+    `为什么现在做这一步：${orchestrator.why_now}`
+  ];
+
+  if (orchestrator.next_command) {
+    lines.push(`现在只运行这一条命令：${orchestrator.next_command}`);
+  }
+  if (orchestrator.expected_artifact) {
+    lines.push(`预期产物：${orchestrator.expected_artifact}`);
+  }
+  if (orchestrator.after_that) {
+    lines.push(`完成后下一条：${orchestrator.after_that}`);
+  }
+  if (orchestrator.stop_if.length > 0) {
+    lines.push("出现以下情况就先停下：");
+    for (const item of orchestrator.stop_if) {
+      lines.push(`- ${item}`);
+    }
+  }
+
+  lines.push("输出时先说明为什么执行这一步，再说明得到什么，以及之后怎么继续。");
+  return lines.join("\n");
+}
+
+export async function createAgentOrchestrator(input, options = {}) {
+  const format = normalizeFormat(options.format);
+  const session = await createAgentSession(input, {
+    intent: options.intent
+  });
+  const nextStep = session.steps[0] || null;
+
+  const orchestrator = {
+    kind: "geo-agent-orchestrator",
+    input,
+    source: session.source,
+    sourceType: session.sourceType,
+    artifactKind: session.artifactKind,
+    format,
+    orchestration_mode: inferOrchestrationMode(session),
+    current_stage: session.stage,
+    why_now: buildWhyNow(session, nextStep),
+    next_command: nextStep?.command || null,
+    expected_artifact: nextStep?.expectedArtifact || null,
+    stop_if: buildStopIf(session, nextStep),
+    after_that: buildAfterThat(session),
+    selectedSkill: session.selectedSkill,
+    next_skill: nextStep?.suggestedSkill || session.selectedSkill.name,
+    session_status: session.status,
+    next_action: session.nextAction,
+    session,
+    orchestrator_prompt: ""
+  };
+
+  orchestrator.orchestrator_prompt = buildOrchestratorPrompt(orchestrator);
+  return orchestrator;
+}
+
+export function renderAgentOrchestratorMarkdown(orchestrator) {
+  const lines = [
+    "# GEO Agent Orchestrator",
+    "",
+    `- 输入：\`${orchestrator.source}\``,
+    `- 输入类型：\`${orchestrator.sourceType}\``,
+    `- 工件类型：\`${orchestrator.artifactKind}\``,
+    `- 当前阶段：${orchestrator.current_stage}`,
+    `- orchestration mode：\`${orchestrator.orchestration_mode}\``,
+    `- 当前建议 skill：\`${orchestrator.next_skill}\``,
+    "",
+    "## 为什么现在做这一步",
+    "",
+    `- ${orchestrator.why_now}`,
+    "",
+    "## 现在只做这一条",
+    "",
+    `- 命令：\`${orchestrator.next_command || "先补输入"}\``,
+    `- 预期产物：${orchestrator.expected_artifact || "先明确需要什么上下文"}`,
+    ""
+  ];
+
+  if (orchestrator.after_that) {
+    lines.push("## 做完之后", "", `- 下一条：\`${orchestrator.after_that}\``, "");
+  }
+
+  lines.push("## 什么时候先停下", "");
+  if (orchestrator.stop_if.length === 0) {
+    lines.push("- 当前没有额外 stop 条件。");
+  } else {
+    for (const item of orchestrator.stop_if) {
+      lines.push(`- ${item}`);
+    }
+  }
+
+  lines.push(
+    "",
+    "## 可直接复制给 Agent 的 Orchestrator Prompt",
+    "",
+    "```text",
+    orchestrator.orchestrator_prompt,
+    "```"
+  );
+
+  return `${lines.join("\n")}\n`;
+}
+
+export async function writeAgentOrchestratorOutput(outputPath, content) {
+  return writeScanOutput(outputPath, content);
+}

package/src/agent-playbook-pack.js

@@ -0,0 +1,267 @@
+import { createAgentDecisionLog } from "./agent-decision-log.js";
+import { createAgentRetrospective } from "./agent-retrospective.js";
+import { createHandoffBundle } from "./handoff-bundle.js";
+import { writeScanOutput } from "./scan.js";
+
+const VALID_FORMATS = new Set(["markdown", "json"]);
+
+function normalizeFormat(format) {
+  const resolved = (format || "markdown").toLowerCase();
+  if (!VALID_FORMATS.has(resolved)) {
+    throw new Error(`不支持的 agent-playbook-pack 格式：${format}。可选值：${Array.from(VALID_FORMATS).join(", ")}`);
+  }
+  return resolved;
+}
+
+function inferPlaybookStatus(retrospective, decisionLog, handoffBundle) {
+  if (
+    retrospective.retrospectiveStatus === "ready-for-closeout" ||
+    decisionLog.latestDecision === "move-to-closeout"
+  ) {
+    return "closeout-ready";
+  }
+  if (
+    retrospective.retrospectiveStatus === "repeated-blocker" ||
+    retrospective.retrospectiveStatus === "blocked-this-round" ||
+    decisionLog.latestDecision === "resolve-blockers"
+  ) {
+    return "unblock-first";
+  }
+  if (handoffBundle.summary.executionMode === "implementation-ready") {
+    return "implementation-ready";
+  }
+  if (handoffBundle.summary.executionMode === "advice-only") {
+    return "advice-ready";
+  }
+  return "artifact-guided";
+}
+
+function buildResumeSummary(status, retrospective, decisionLog) {
+  if (status === "closeout-ready") {
+    return "这轮已经接近或进入收尾，不要再扩展新任务，直接整理 closeout 与交付。";
+  }
+  if (status === "unblock-first") {
+    return `当前应先解除阻塞，再继续 ${decisionLog.currentPacket?.id || "当前包"}。`;
+  }
+  if (status === "implementation-ready") {
+    return `当前可以直接接着做 ${decisionLog.currentPacket?.id || "第一包"}，并按既有节奏推进。`;
+  }
+  if (status === "advice-ready") {
+    return "当前更适合先给建议与实施路径，不要假设已经拥有仓库写入权限。";
+  }
+  return `当前建议沿着最近一次决策继续推进 ${decisionLog.currentPacket?.id || "下一包"}。`;
+}
+
+function buildStartCommand(status, retrospective, decisionLog, handoffBundle) {
+  if (status === "closeout-ready") {
+    return `geo-ai-search-optimization completion-report ${decisionLog.source}`;
+  }
+  if (retrospective.suggestedNextCommand) {
+    return retrospective.suggestedNextCommand;
+  }
+  if (decisionLog.suggestedNextCommand) {
+    return decisionLog.suggestedNextCommand;
+  }
+  const firstPacket = handoffBundle.applyPlan.packets[0];
+  return firstPacket
+    ? `geo-ai-search-optimization agent-executor ${decisionLog.source} --task ${firstPacket.id}`
+    : `geo-ai-search-optimization agent-session ${decisionLog.source}`;
+}
+
+function buildReadOrder() {
+  return [
+    "先读 retrospective，总结多轮里为什么推进顺利或反复卡住。",
+    "再读 decision log，确认最近一次决策、当前包和下一步命令。",
+    "最后读 handoff bundle，接着看 apply-plan 和 completion-report 的执行细节。"
+  ];
+}
+
+function buildDoNowChecklist(status, retrospective, decisionLog) {
+  const items = [];
+
+  if (status === "closeout-ready") {
+    items.push("不要再新开执行包。");
+    items.push("直接整理 completion-report、meeting-pack 和 publish-pack。");
+  } else if (status === "unblock-first") {
+    items.push("先解决当前阻塞，不要直接继续改代码。");
+    items.push("阻塞解除后，再回到当前包继续推进。");
+  } else {
+    items.push(`沿着当前包 ${decisionLog.currentPacket?.id || "第一包"} 继续，不要重新生成一条新链。`);
+    items.push("先按已有 runbook / executor 节奏推进，再更新状态。");
+  }
+
+  items.push(...retrospective.nextRoundAdvice.slice(0, 2));
+  return Array.from(new Set(items));
+}
+
+function buildAvoidNowChecklist(status, retrospective) {
+  const items = [];
+
+  if (status !== "closeout-ready") {
+    items.push("不要同时切换目标、任务包和执行模式。");
+  }
+  if (status === "unblock-first") {
+    items.push("不要假装阻塞不存在，也不要跳过 preflight 直接改动。");
+  }
+  if (retrospective.retrospectiveStatus === "restarting-too-often") {
+    items.push("不要再从第一包重新开始，优先延续最近一次 current packet。");
+  }
+  if (retrospective.recurringBlockers[0]?.count >= 2) {
+    items.push(`不要忽视重复阻塞「${retrospective.recurringBlockers[0].title}」，先把它变成固定检查项。`);
+  }
+  if (status === "closeout-ready") {
+    items.push("不要在 closeout 阶段继续扩展新的修复范围。");
+  }
+
+  return items;
+}
+
+function buildFollowupCommands(status, source) {
+  if (status === "closeout-ready") {
+    return [
+      `geo-ai-search-optimization completion-report ${source}`,
+      `geo-ai-search-optimization meeting-pack ${source}`,
+      `geo-ai-search-optimization publish-pack ${source}`
+    ];
+  }
+
+  return [
+    `geo-ai-search-optimization agent-status-board ${source}`,
+    `geo-ai-search-optimization agent-decision-log ${source}`,
+    `geo-ai-search-optimization agent-retrospective ${source}`
+  ];
+}
+
+function buildPlaybookPrompt(pack) {
+  const lines = [
+    "你现在进入 GEO Agent Playbook 模式。",
+    `输入来源：${pack.source}`,
+    `当前状态：${pack.playbookStatus}`,
+    `恢复摘要：${pack.resumeSummary}`,
+    `启动命令：${pack.startCommand}`,
+    `当前包：${pack.currentPacket?.id || "无"}`
+  ];
+
+  if (pack.nextPacket) {
+    lines.push(`下一包：${pack.nextPacket.id}｜${pack.nextPacket.title}`);
+  }
+  if (pack.retrospective.recurringBlockers.length > 0) {
+    lines.push(
+      `重复阻塞：${pack.retrospective.recurringBlockers.map((item) => `${item.title} (${item.count})`).join("；")}`
+    );
+  }
+
+  lines.push("请先解释你为什么沿着这条 playbook 继续，而不是重新规划一整条新链。");
+  lines.push("然后按 read order、do now checklist、avoid now checklist 输出执行建议。");
+  lines.push("最后给出本轮完成后应该更新哪些工件。");
+  return lines.join("\n");
+}
+
+export async function createAgentPlaybookPack(input, options = {}) {
+  const format = normalizeFormat(options.format);
+  const retrospective = await createAgentRetrospective(input, { format: "json" });
+  const decisionLog = retrospective.decisionLog || (await createAgentDecisionLog(input, { format: "json" }));
+  const baseSource = retrospective.source || decisionLog.source || input;
+  const handoffBundle = await createHandoffBundle(baseSource, { format: "json", taskId: options.taskId });
+
+  const playbookStatus = inferPlaybookStatus(retrospective, decisionLog, handoffBundle);
+  const source = baseSource;
+  const startCommand = buildStartCommand(playbookStatus, retrospective, decisionLog, handoffBundle);
+
+  const pack = {
+    kind: "geo-agent-playbook-pack",
+    input,
+    source,
+    sourceType: decisionLog.sourceType,
+    artifactKind: decisionLog.kind,
+    format,
+    playbookStatus,
+    resumeSummary: buildResumeSummary(playbookStatus, retrospective, decisionLog),
+    currentPacket: decisionLog.currentPacket,
+    nextPacket: decisionLog.nextPacket,
+    startCommand,
+    readOrder: buildReadOrder(),
+    doNowChecklist: buildDoNowChecklist(playbookStatus, retrospective, decisionLog),
+    avoidNowChecklist: buildAvoidNowChecklist(playbookStatus, retrospective),
+    followupCommands: buildFollowupCommands(playbookStatus, source),
+    decisionLog,
+    retrospective,
+    handoffBundle,
+    playbookPrompt: ""
+  };
+
+  pack.playbookPrompt = buildPlaybookPrompt(pack);
+  return pack;
+}
+
+export function renderAgentPlaybookPackMarkdown(pack) {
+  const lines = [
+    "# GEO Agent Playbook Pack",
+    "",
+    `- 输入：\`${pack.source}\``,
+    `- 来源类型：\`${pack.sourceType}\``,
+    `- 当前状态：\`${pack.playbookStatus}\``,
+    `- 恢复摘要：${pack.resumeSummary}`,
+    `- 启动命令：\`${pack.startCommand}\``,
+    ""
+  ];
+
+  if (pack.currentPacket) {
+    lines.push("## 当前包", "", `- ${pack.currentPacket.id}｜${pack.currentPacket.title}`);
+    lines.push(`- Owner：${pack.currentPacket.owner}`);
+    lines.push(`- 优先级：${pack.currentPacket.priority}`);
+    lines.push("");
+  }
+
+  if (pack.nextPacket) {
+    lines.push("## 下一包", "", `- ${pack.nextPacket.id}｜${pack.nextPacket.title}`);
+    lines.push(`- Owner：${pack.nextPacket.owner}`);
+    lines.push(`- 优先级：${pack.nextPacket.priority}`);
+    lines.push("");
+  }
+
+  lines.push("## 先读什么", "");
+  for (const item of pack.readOrder) {
+    lines.push(`- ${item}`);
+  }
+
+  lines.push("", "## 现在先做什么", "");
+  for (const item of pack.doNowChecklist) {
+    lines.push(`- ${item}`);
+  }
+
+  lines.push("", "## 现在不要做什么", "");
+  if (pack.avoidNowChecklist.length === 0) {
+    lines.push("- 当前没有额外禁忌项。");
+  } else {
+    for (const item of pack.avoidNowChecklist) {
+      lines.push(`- ${item}`);
+    }
+  }
+
+  lines.push("", "## 后续命令", "");
+  for (const command of pack.followupCommands) {
+    lines.push(`- \`${command}\``);
+  }
+
+  lines.push(
+    "",
+    "## 内含工件摘要",
+    "",
+    `- decision-log：${pack.decisionLog.totalEntries} 轮`,
+    `- retrospective：${pack.retrospective.retrospectiveStatus}`,
+    `- handoff-bundle：${pack.handoffBundle.summary.executionMode} / ${pack.handoffBundle.summary.executionType}`,
+    "",
+    "## 可直接复制给 Agent 的 Playbook Prompt",
+    "",
+    "```text",
+    pack.playbookPrompt,
+    "```"
+  );
+
+  return `${lines.join("\n")}\n`;
+}
+
+export async function writeAgentPlaybookPackOutput(outputPath, content) {
+  return writeScanOutput(outputPath, content);
+}

package/src/agent-session.js

@@ -70,6 +70,9 @@ function inferSkillForCommand(commandName, flow) {
   if (commandName === "agent-retrospective") {
     return "geo-ai-search-optimization-agent-retrospective";
   }
+  if (commandName === "agent-playbook-pack") {
+    return "geo-ai-search-optimization-agent-playbook-pack";
+  }
   if (commandName === "skills" || commandName === "quick-start") {
     return "geo-ai-search-optimization-usage";
   }
@@ -146,6 +149,8 @@ function inferStepPurpose(commandName, flow) {
       return "把每一轮 checkpoint 沉淀成可继承的决策历史。";
     case "agent-retrospective":
       return "把多轮决策历史压成复盘结论、重复模式和下一轮建议。";
+    case "agent-playbook-pack":
+      return "把复盘、决策历史和交接信息压成下一位 agent 的单入口执行包。";
     case "apply-plan":
       return "把交接结果推进到具体执行包。";
     case "completion-report":
@@ -202,6 +207,8 @@ function inferExpectedArtifact(commandName) {
       return "agent 决策历史工件";
     case "agent-retrospective":
       return "agent 多轮复盘工件";
+    case "agent-playbook-pack":
+      return "agent 单入口 playbook 包";
     case "apply-plan":
       return "执行包";
     case "completion-report":
@@ -258,6 +265,9 @@ function buildStepInstructions(parsedCommand, flow) {
   if (parsedCommand.commandName === "agent-retrospective") {
     lines.push("这一步用于总结为什么前几轮卡住或推进顺利，并把这些模式转成下一轮建议。");
   }
+  if (parsedCommand.commandName === "agent-playbook-pack") {
+    lines.push("这一步用于把多轮复盘和交接结果压成单入口执行包，方便下一位 agent 直接开始。");
+  }
   if (parsedCommand.commandName === "agent-handoff" && flow.intent === "execute") {
     lines.push("如果还是 advice-only，说明还缺仓库或本地项目上下文。");
   }

package/src/auto-flow.js

@@ -59,6 +59,9 @@ function inferTaskTextMode(text) {
   if (/(decision-log|decision log|决策历史|决策日志|为什么这样决定|历史决策)/i.test(normalized)) {
     return "execute";
   }
+  if (/(playbook-pack|playbook pack|playbook 包|agent playbook|单入口执行包|复盘执行包|接着干的入口)/i.test(normalized)) {
+    return "execute";
+  }
   if (/(retrospective|retro|多轮复盘|执行复盘|为什么总卡住|经验总结|回顾前几轮)/i.test(normalized)) {
     return "closeout";
   }
@@ -165,6 +168,9 @@ function resolveEffectiveIntent(intent, detected) {
   if (detected.artifactKind === "geo-agent-retrospective") {
     return "closeout";
   }
+  if (detected.artifactKind === "geo-agent-playbook-pack") {
+    return detected.parsed?.playbookStatus === "closeout-ready" ? "closeout" : "execute";
+  }
   if (
     [
       "geo-share-pack",
@@ -415,6 +421,20 @@ function buildCommandChain(detected, intent) {
         `geo-ai-search-optimization meeting-pack ${source}`,
         `geo-ai-search-optimization publish-pack ${source}`
       ];
+    case "geo-agent-playbook-pack": {
+      const baseSource = detected.parsed?.source || source;
+      return detected.parsed?.playbookStatus === "closeout-ready"
+        ? [
+            detected.parsed?.startCommand || `geo-ai-search-optimization completion-report ${baseSource}`,
+            `geo-ai-search-optimization meeting-pack ${baseSource}`,
+            `geo-ai-search-optimization publish-pack ${baseSource}`
+          ]
+        : [
+            detected.parsed?.startCommand || `geo-ai-search-optimization agent-executor ${baseSource}`,
+            `geo-ai-search-optimization agent-status-board ${baseSource}`,
+            `geo-ai-search-optimization agent-decision-log ${baseSource}`
+          ];
+    }
     case "geo-apply-plan":
       return [
         `geo-ai-search-optimization agent-executor ${source}`,
@@ -500,6 +520,8 @@ function pickSkillName(detected, intent) {
       return "geo-ai-search-optimization-agent-decision-log";
     case "geo-agent-retrospective":
       return "geo-ai-search-optimization-agent-retrospective";
+    case "geo-agent-playbook-pack":
+      return "geo-ai-search-optimization-agent-playbook-pack";
     case "geo-completion-report":
       return "geo-ai-search-optimization-completion-report";
     case "geo-handoff-bundle":
@@ -541,6 +563,7 @@ function buildSecondarySkillNames(primarySkill, intent, detected) {
       "geo-agent-status-board",
       "geo-agent-checkpoint",
       "geo-agent-decision-log",
+      "geo-agent-playbook-pack",
       "geo-apply-plan"
     ].includes(
       detected.artifactKind
@@ -551,6 +574,7 @@ function buildSecondarySkillNames(primarySkill, intent, detected) {
     names.add("geo-ai-search-optimization-agent-status-board");
     names.add("geo-ai-search-optimization-agent-checkpoint");
     names.add("geo-ai-search-optimization-agent-decision-log");
+    names.add("geo-ai-search-optimization-agent-playbook-pack");
     names.add("geo-ai-search-optimization-agent-executor");
     names.add("geo-ai-search-optimization-agent-runbook");
     names.add("geo-ai-search-optimization-agent-handoff");
@@ -586,6 +610,7 @@ function buildStage(intent, detected) {
       "geo-agent-status-board",
       "geo-agent-checkpoint",
       "geo-agent-decision-log",
+      "geo-agent-playbook-pack",
       "geo-agent-retrospective",
       "geo-apply-plan",
       "geo-handoff-bundle"
@@ -604,6 +629,7 @@ function buildStage(intent, detected) {
       "geo-agent-status-board",
       "geo-agent-checkpoint",
       "geo-agent-decision-log",
+      "geo-agent-playbook-pack",
       "geo-agent-retrospective",
       "geo-apply-plan",
       "geo-handoff-bundle"
@@ -697,6 +723,9 @@ function buildNextAction(detected, intent, commands) {
     if (detected.artifactKind === "geo-agent-decision-log") {
       return `先运行 \`${commands[0]}\`，沿着最近一次阶段决策继续推进，而不是重新判断整条链。`;
     }
+    if (detected.artifactKind === "geo-agent-playbook-pack") {
+      return `先运行 \`${commands[0]}\`，直接沿着 playbook 的起始命令继续，不要重新拆链。`;
+    }
     return `先运行 \`${commands[0]}\`，把当前输入推进到 agent 可执行状态。`;
   }
   if (intent === "closeout") {

package/src/cli.js

@@ -16,6 +16,16 @@ import {
 } from "./agent-progress-tracker.js";
 import { createAgentCheckpoint, renderAgentCheckpointMarkdown, writeAgentCheckpointOutput } from "./agent-checkpoint.js";
 import { createAgentDecisionLog, renderAgentDecisionLogMarkdown, writeAgentDecisionLogOutput } from "./agent-decision-log.js";
+import {
+  createAgentOrchestrator,
+  renderAgentOrchestratorMarkdown,
+  writeAgentOrchestratorOutput
+} from "./agent-orchestrator.js";
+import {
+  createAgentPlaybookPack,
+  renderAgentPlaybookPackMarkdown,
+  writeAgentPlaybookPackOutput
+} from "./agent-playbook-pack.js";
 import { createAgentRetrospective, renderAgentRetrospectiveMarkdown, writeAgentRetrospectiveOutput } from "./agent-retrospective.js";
 import { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
 import { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
@@ -75,6 +85,7 @@ function printHelp() {
       "Usage:",
       "  geo-ai-search-optimization",
       "  geo-ai-search-optimization install [--target <dir>] [--json]",
+      "  geo-ai-search-optimization agent-orchestrator <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization auto-flow <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--json] [--out <file>]",
       "  geo-ai-search-optimization agent-session <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--json] [--out <file>]",
       "  geo-ai-search-optimization agent-runbook <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
@@ -85,6 +96,7 @@ function printHelp() {
       "  geo-ai-search-optimization agent-checkpoint <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization agent-decision-log <input> [--append-from <file>] [--note <text>] [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization agent-retrospective <input> [--format <markdown|json>] [--out <file>]",
+      "  geo-ai-search-optimization agent-playbook-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization skills [--json]",
       "  geo-ai-search-optimization where",
       "  geo-ai-search-optimization doctor [--json]",
@@ -177,6 +189,32 @@ async function handleAutoFlow(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleAgentOrchestrator(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("agent-orchestrator 需要一个输入值，可以是任务描述、项目路径、网站网址或已导出的工件");
+  }
+
+  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
+  const orchestrator = await createAgentOrchestrator(input, {
+    intent: getFlagValue(args, "--intent"),
+    format
+  });
+  const outputJson = orchestrator.format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(orchestrator, null, 2)}\n`
+    : renderAgentOrchestratorMarkdown(orchestrator);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeAgentOrchestratorOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 agent-orchestrator 结果：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
 async function handleAgentSession(args) {
   const input = args.find((value) => !value.startsWith("-"));
   if (!input) {
@@ -422,6 +460,32 @@ async function handleAgentRetrospective(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleAgentPlaybookPack(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("agent-playbook-pack 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
+  }
+
+  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
+  const pack = await createAgentPlaybookPack(input, {
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  const outputJson = pack.format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(pack, null, 2)}\n`
+    : renderAgentPlaybookPackMarkdown(pack);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeAgentPlaybookPackOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 agent playbook pack：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
 function handleWhere() {
   process.stdout.write(
     [
@@ -967,6 +1031,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "agent-orchestrator") {
+    await handleAgentOrchestrator(rest);
+    return;
+  }
+
   if (command === "agent-session") {
     await handleAgentSession(rest);
     return;
@@ -1012,6 +1081,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "agent-playbook-pack") {
+    await handleAgentPlaybookPack(rest);
+    return;
+  }
+
   if (command === "skills") {
     await handleSkills(rest);
     return;

package/src/completion-report.js

@@ -131,6 +131,37 @@ async function resolveApplyPlan(input) {
     return parsed;
   }
 
+  if (parsed.kind === "geo-handoff-bundle" && parsed.applyPlan?.kind === "geo-apply-plan") {
+    return parsed.applyPlan;
+  }
+
+  if (parsed.kind === "geo-agent-progress-tracker" && parsed.applyPlan?.kind === "geo-apply-plan") {
+    return parsed.applyPlan;
+  }
+
+  if (parsed.kind === "geo-agent-status-board" && parsed.tracker?.applyPlan?.kind === "geo-apply-plan") {
+    return parsed.tracker.applyPlan;
+  }
+
+  if (parsed.kind === "geo-agent-checkpoint" && parsed.statusBoard?.tracker?.applyPlan?.kind === "geo-apply-plan") {
+    return parsed.statusBoard.tracker.applyPlan;
+  }
+
+  if (parsed.kind === "geo-agent-decision-log") {
+    return createApplyPlan(parsed.source || parsed.latestCheckpoint?.source || resolvedPath, { format: "json" });
+  }
+
+  if (
+    parsed.kind === "geo-agent-retrospective" &&
+    parsed.decisionLog?.latestCheckpoint?.statusBoard?.tracker?.applyPlan?.kind === "geo-apply-plan"
+  ) {
+    return parsed.decisionLog.latestCheckpoint.statusBoard.tracker.applyPlan;
+  }
+
+  if (parsed.kind === "geo-agent-playbook-pack" && parsed.handoffBundle?.applyPlan?.kind === "geo-apply-plan") {
+    return parsed.handoffBundle.applyPlan;
+  }
+
   return createApplyPlan(resolvedPath, { format: "json" });
 }
 

package/src/index.js

@@ -7,9 +7,11 @@ export {
 } from "./interactive-onboarding.js";
 export { createAutoFlow, renderAutoFlowMarkdown, writeAutoFlowOutput } from "./auto-flow.js";
 export { createApplyPlan, renderApplyPlanMarkdown, writeApplyPlanOutput } from "./apply-plan.js";
+export { createAgentOrchestrator, renderAgentOrchestratorMarkdown, writeAgentOrchestratorOutput } from "./agent-orchestrator.js";
 export { createAgentBatchExecutor, renderAgentBatchExecutorMarkdown, writeAgentBatchExecutorOutput } from "./agent-batch-executor.js";
 export { createAgentCheckpoint, renderAgentCheckpointMarkdown, writeAgentCheckpointOutput } from "./agent-checkpoint.js";
 export { createAgentDecisionLog, renderAgentDecisionLogMarkdown, writeAgentDecisionLogOutput } from "./agent-decision-log.js";
+export { createAgentPlaybookPack, renderAgentPlaybookPackMarkdown, writeAgentPlaybookPackOutput } from "./agent-playbook-pack.js";
 export { createAgentRetrospective, renderAgentRetrospectiveMarkdown, writeAgentRetrospectiveOutput } from "./agent-retrospective.js";
 export { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput } from "./agent-handoff.js";
 export { createAgentExecutor, renderAgentExecutorMarkdown, writeAgentExecutorOutput } from "./agent-executor.js";

package/src/skills.js

@@ -5,6 +5,7 @@ import { getPackageRoot } from "./paths.js";
 const SKILL_ORDER = [
   "geo-ai-search-optimization",
   "geo-ai-search-optimization-auto-flow",
+  "geo-ai-search-optimization-agent-orchestrator",
   "geo-ai-search-optimization-agent-session",
   "geo-ai-search-optimization-agent-runbook",
   "geo-ai-search-optimization-agent-executor",
@@ -14,6 +15,7 @@ const SKILL_ORDER = [
   "geo-ai-search-optimization-agent-checkpoint",
   "geo-ai-search-optimization-agent-decision-log",
   "geo-ai-search-optimization-agent-retrospective",
+  "geo-ai-search-optimization-agent-playbook-pack",
   "geo-ai-search-optimization-usage",
   "geo-ai-search-optimization-agent-handoff",
   "geo-ai-search-optimization-repair-loop",
@@ -28,6 +30,7 @@ const SKILL_ORDER = [
 const SKILL_CATEGORY = {
   "geo-ai-search-optimization": "core",
   "geo-ai-search-optimization-auto-flow": "routing",
+  "geo-ai-search-optimization-agent-orchestrator": "routing",
   "geo-ai-search-optimization-agent-session": "routing",
   "geo-ai-search-optimization-agent-runbook": "execution",
   "geo-ai-search-optimization-agent-executor": "execution",
@@ -37,6 +40,7 @@ const SKILL_CATEGORY = {
   "geo-ai-search-optimization-agent-checkpoint": "execution",
   "geo-ai-search-optimization-agent-decision-log": "execution",
   "geo-ai-search-optimization-agent-retrospective": "execution",
+  "geo-ai-search-optimization-agent-playbook-pack": "execution",
   "geo-ai-search-optimization-usage": "guidance",
   "geo-ai-search-optimization-agent-handoff": "execution",
   "geo-ai-search-optimization-repair-loop": "execution",
@@ -169,6 +173,7 @@ export function renderBundledSkillsMarkdown(bundle) {
     "## 推荐理解顺序",
     "",
     "- 先看核心 GEO skill。",
+    "- 如果你只想让 agent 立刻知道现在唯一该跑哪条命令，先跑 agent-orchestrator。",
     "- 如果 agent 需要自动选 skill，先跑 auto-flow。",
     "- 如果要给 agent 明确步骤，继续进入 agent-session。",
     "- 如果要给 agent 一份执行手册和检查表，再进入 agent-runbook。",
@@ -179,6 +184,7 @@ export function renderBundledSkillsMarkdown(bundle) {
     "- 如果要在每轮结束时做继续 / 阻塞 / 收尾决策，再进入 agent-checkpoint。",
     "- 如果要把多轮决策沉淀成可继承的历史，再进入 agent-decision-log。",
     "- 如果要总结多轮为什么推进顺利或反复卡住，再进入 agent-retrospective。",
+    "- 如果要把复盘、决策和交接压成下一位 agent 的单入口，再进入 agent-playbook-pack。",
     "- 再看 usage skill，知道什么时候该跑哪个命令。",
     "- 如果要交给 agent 执行，再进入 handoff / apply / completion 这一条执行链。",
     "- 如果要产出给团队分发，再进入 share / export / html / publish 这一条交付链。",