geo-ai-search-optimization 1.2.12 → 1.2.13

package/README.md

@@ -165,6 +165,27 @@ geo-ai-search-optimization agent-progress-tracker ./reports/agent-batch-executor
 - 建议下一步命令
 - 可直接复制给 agent 的 progress prompt
 
+## Agent Status Board 命令
+
+如果你希望把当前执行状态直接整理成更像团队协作看板的分栏视图，而不是只看一份文字进度摘要，可以直接用 `agent-status-board`：
+
+```bash
+geo-ai-search-optimization agent-status-board ./your-site
+geo-ai-search-optimization agent-status-board ./reports/apply-plan.json --completed fix-01 --current fix-02
+geo-ai-search-optimization agent-status-board ./reports/agent-progress-tracker.json --blocked "缺少仓库权限,缺少模板文件" --format json --out ./reports/agent-status-board.json
+```
+
+`agent-status-board` 会输出：
+
+- 已完成栏
+- 进行中栏
+- 阻塞栏
+- 下一步栏
+- 排队中栏
+- 收尾栏
+- 建议下一步命令
+- 可直接复制给 agent 的 status board prompt
+
 ## Quick Start
 
 如果你要从 0 到 1 启动一个 GEO 项目，建议照这个顺序做。
@@ -564,6 +585,7 @@ geo-ai-search-optimization agent-runbook ./your-site
 geo-ai-search-optimization agent-executor ./your-site
 geo-ai-search-optimization agent-batch-executor ./your-site
 geo-ai-search-optimization agent-progress-tracker ./your-site
+geo-ai-search-optimization agent-status-board ./your-site
 geo-ai-search-optimization skills
 geo-ai-search-optimization where
 geo-ai-search-optimization doctor
@@ -634,6 +656,13 @@ geo-ai-search-optimization help
 - 输出 do-now checklist、stop checklist、success checklist、验证命令和回报模板
 - 新增 `geo-ai-search-optimization-agent-executor` skill
 
+## New in 1.2.13
+
+- 新增 `agent-status-board` 命令
+- 把当前执行状态整理成更像看板的分栏视图
+- 支持从 `apply-plan`、`agent-progress-tracker`、`agent-batch-executor` 等工件继续生成状态看板
+- 新增 `geo-ai-search-optimization-agent-status-board` skill
+
 ## New in 1.2.12
 
 - 新增 `agent-progress-tracker` 命令
@@ -840,6 +869,7 @@ The installed package now includes a bundled GEO skill pack, including:
 - `geo-ai-search-optimization-agent-executor`
 - `geo-ai-search-optimization-agent-batch-executor`
 - `geo-ai-search-optimization-agent-progress-tracker`
+- `geo-ai-search-optimization-agent-status-board`
 - `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.12",
+  "version": "1.2.13",
   "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

@@ -82,6 +82,16 @@ Best for:
 - clarifying the current active packet and the next packet
 - surfacing blockers before the team moves into closeout or the next batch
 
+### `geo-ai-search-optimization-agent-status-board`
+
+Use this when the next agent should present execution state as a board instead of a plain progress summary.
+
+Best for:
+
+- giving PM and agent the same execution view
+- showing done, in-progress, blocked, next, and queued packets in one artifact
+- turning progress tracking into a more shareable coordination output
+
 ## Usage guide
 
 ### `geo-ai-search-optimization-usage`

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

@@ -0,0 +1,23 @@
+---
+name: geo-ai-search-optimization-agent-status-board
+description: Turn GEO execution state into a board-style artifact for PM and agent coordination. Use when an agent should present done, in-progress, blocked, next, queued, and closeout states from apply-plan, agent-progress-tracker, agent-batch-executor, or related execution artifacts.
+---
+
+# GEO Agent Status Board
+
+Use this skill when the next agent should explain execution state as a board, not just as a paragraph summary.
+
+`GEO = Generative Engine Optimization`
+
+## What it does
+
+- turns current GEO execution state into board columns
+- keeps PM and agent aligned on the same packet status
+- shows done, in-progress, blocked, next, queued, and closeout views
+- points to the next command and preserves the underlying progress tracker
+
+## Best use
+
+- when a PM asks for a coordination-friendly view
+- when progress tracking exists but still feels too text-heavy
+- when the next agent should continue from a board artifact instead of rebuilding context

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GEO Agent Status Board"
+  short_description: "Present GEO execution state as a board"
+  default_prompt: "Use $geo-ai-search-optimization-agent-status-board to turn this GEO execution state into a board with done, in-progress, blocked, next, queued, and closeout columns."

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 nineteen layers:
+The package is best explained as twenty layers:
 
 1. `auto-flow`: auto-select the next skill and command chain
 2. `agent-session`: build a runnable session for the next agent
@@ -21,19 +21,20 @@ The package is best explained as nineteen layers:
 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. `skills`: inspect the bundled skill package
-8. `onboard-url` / `onboard`: first look
-9. `scan`: raw signal check
-10. `audit` / `report`: diagnosis
-11. `fix-plan` / `owner-board`: execution planning
-12. `agent-handoff`: agent takeover package
-13. `apply-plan`: execution loop
-14. `completion-report`: closeout
-15. `handoff-bundle`: all-in-one package
-16. `share-pack`: audience-ready delivery
-17. `export-pack`: folder export
-18. `html-pack` / `publish-pack`: browsable and final delivery output
-19. `pm-brief` / `roadmap`: stakeholder alignment
+7. `agent-status-board`: turn the execution state into a board view for PM and agents
+8. `skills`: inspect the bundled skill package
+9. `onboard-url` / `onboard`: first look
+10. `scan`: raw signal check
+11. `audit` / `report`: diagnosis
+12. `fix-plan` / `owner-board`: execution planning
+13. `agent-handoff`: agent takeover package
+14. `apply-plan`: execution loop
+15. `completion-report`: closeout
+16. `handoff-bundle`: all-in-one package
+17. `share-pack`: audience-ready delivery
+18. `export-pack`: folder export
+19. `html-pack` / `publish-pack`: browsable and final delivery output
+20. `pm-brief` / `roadmap`: stakeholder alignment
 
 ## Recommended command order
 
@@ -46,6 +47,7 @@ npx geo-ai-search-optimization agent-runbook https://example.com
 npx geo-ai-search-optimization agent-executor https://example.com
 npx geo-ai-search-optimization agent-batch-executor https://example.com
 npx geo-ai-search-optimization agent-progress-tracker https://example.com
+npx geo-ai-search-optimization agent-status-board 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
@@ -60,6 +62,7 @@ npx geo-ai-search-optimization agent-runbook ./your-site
 npx geo-ai-search-optimization agent-executor ./your-site
 npx geo-ai-search-optimization agent-batch-executor ./your-site
 npx geo-ai-search-optimization agent-progress-tracker ./your-site
+npx geo-ai-search-optimization agent-status-board ./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
@@ -83,6 +86,7 @@ npx geo-ai-search-optimization roadmap ./your-site
 - `agent-executor`: select one packet to execute now and package it into a single-task entrypoint
 - `agent-batch-executor`: line up the first few packets in execution order while preserving one-packet-at-a-time discipline
 - `agent-progress-tracker`: show execution progress, current packet, blockers, and the next packet to advance
+- `agent-status-board`: present the current execution state as a board with done, in-progress, blocked, next, and queued columns
 - `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
@@ -113,6 +117,7 @@ When explaining the tool to a user:
 - if the user wants the next agent to start one concrete task now, move them to `agent-executor`
 - if the user wants the next agent to continuously advance the first 2 to 3 packets in order, move them to `agent-batch-executor`
 - if the user wants the next agent to explain current progress, blockers, and the next packet, move them to `agent-progress-tracker`
+- if the user wants the next agent to present execution state as a board for PM and agent coordination, move them to `agent-status-board`
 - 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-progress-tracker.js

@@ -120,6 +120,20 @@ function buildExecutionContextFromParsedArtifact(parsed, input) {
     };
   }
 
+  if (parsed?.kind === "geo-agent-status-board" && parsed.tracker?.applyPlan?.kind === "geo-apply-plan") {
+    return {
+      source: parsed.source || parsed.tracker.source || parsed.tracker.applyPlan.source || input,
+      sourceType: parsed.sourceType || parsed.tracker.sourceType || parsed.tracker.applyPlan.sourceType || "json",
+      artifactKind: parsed.kind,
+      applyPlan: parsed.tracker.applyPlan,
+      trackerState: {
+        currentTaskId: parsed.tracker.currentTaskId || parsed.tracker.activePacket?.id || null,
+        completedPacketIds: parsed.tracker.completedPacketIds || [],
+        blockedReasons: parsed.tracker.blockedReasons || []
+      }
+    };
+  }
+
   if (parsed?.kind === "geo-completion-report") {
     return {
       source: parsed.source || input,

package/src/agent-session.js

@@ -58,6 +58,9 @@ function inferSkillForCommand(commandName, flow) {
   if (commandName === "agent-progress-tracker") {
     return "geo-ai-search-optimization-agent-progress-tracker";
   }
+  if (commandName === "agent-status-board") {
+    return "geo-ai-search-optimization-agent-status-board";
+  }
   if (commandName === "skills" || commandName === "quick-start") {
     return "geo-ai-search-optimization-usage";
   }
@@ -126,6 +129,8 @@ function inferStepPurpose(commandName, flow) {
       return "把前几包任务排成连续执行顺序，但保持一次只推进一包。";
     case "agent-progress-tracker":
       return "追踪当前做到第几包、卡点在哪里，以及下一包该推进什么。";
+    case "agent-status-board":
+      return "把当前执行状态整理成 PM 和 agent 都能直接消费的分栏看板。";
     case "apply-plan":
       return "把交接结果推进到具体执行包。";
     case "completion-report":
@@ -174,6 +179,8 @@ function inferExpectedArtifact(commandName) {
       return "agent 多任务批次执行包";
     case "agent-progress-tracker":
       return "agent 执行进度追踪工件";
+    case "agent-status-board":
+      return "agent 执行状态看板";
     case "apply-plan":
       return "执行包";
     case "completion-report":
@@ -218,6 +225,9 @@ function buildStepInstructions(parsedCommand, flow) {
   if (parsedCommand.commandName === "agent-progress-tracker") {
     lines.push("这一步用于校准当前做到哪、当前卡点和下一包，不要跳过状态确认直接进入收尾。");
   }
+  if (parsedCommand.commandName === "agent-status-board") {
+    lines.push("这一步用于把当前执行状态转成看板视图，方便 PM 和 agent 对齐当前阶段。");
+  }
   if (parsedCommand.commandName === "agent-handoff" && flow.intent === "execute") {
     lines.push("如果还是 advice-only，说明还缺仓库或本地项目上下文。");
   }

package/src/agent-status-board.js

@@ -0,0 +1,246 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import {
+  createAgentProgressTracker,
+  renderAgentProgressTrackerMarkdown,
+  writeAgentProgressTrackerOutput
+} from "./agent-progress-tracker.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-status-board 格式：${format}。可选值：${Array.from(VALID_FORMATS).join(", ")}`);
+  }
+  return resolved;
+}
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function buildCard(packet, extra = {}) {
+  if (!packet) {
+    return null;
+  }
+
+  return {
+    id: packet.id,
+    title: packet.title,
+    owner: packet.owner,
+    priority: packet.priority || "P1",
+    ...extra
+  };
+}
+
+function buildBlockedCards(tracker) {
+  if (tracker.blockedReasons.length === 0) {
+    return [];
+  }
+
+  return tracker.blockedReasons.map((reason, index) => ({
+    id: `block-${index + 1}`,
+    title: reason,
+    owner: tracker.activePacket?.owner || "待确认",
+    priority: tracker.activePacket?.priority || "P1",
+    currentPacketId: tracker.activePacket?.id || null
+  }));
+}
+
+function buildQueuedCards(tracker) {
+  return tracker.remainingPackets
+    .filter((packet) => packet.id !== tracker.activePacket?.id && packet.id !== tracker.nextPacket?.id)
+    .map((packet) => buildCard(packet));
+}
+
+function buildColumns(tracker) {
+  return {
+    completed: tracker.completedPackets.map((packet) => buildCard(packet)),
+    inProgress: tracker.activePacket ? [buildCard(tracker.activePacket)] : [],
+    blocked: buildBlockedCards(tracker),
+    nextUp: tracker.nextPacket ? [buildCard(tracker.nextPacket)] : [],
+    queued: buildQueuedCards(tracker),
+    closeout:
+      tracker.status === "completed"
+        ? [
+            {
+              id: "closeout-01",
+              title: "进入 completion-report / handoff-bundle / publish-pack",
+              owner: "PM / Agent",
+              priority: "P1"
+            }
+          ]
+        : []
+  };
+}
+
+function buildBoardSummary(tracker) {
+  if (tracker.status === "blocked") {
+    return `当前执行被阻塞，先处理 ${tracker.blockedReasons.length} 个阻塞项，再继续推进 ${tracker.activePacket?.id || "当前包"}。`;
+  }
+  if (tracker.status === "completed") {
+    return "当前批次已完成，接下来适合进入复盘与交付阶段。";
+  }
+  if (tracker.status === "in-progress") {
+    return `当前正在推进 ${tracker.activePacket?.id || "当前包"}，下一包是 ${tracker.nextPacket?.id || "收尾"}。`;
+  }
+  if (tracker.status === "not-started") {
+    return `当前还没开始，建议从 ${tracker.activePacket?.id || "第一包"} 启动。`;
+  }
+  return "当前还缺上下文，先补执行信息再进入状态看板。";
+}
+
+function buildBoardPrompt(board) {
+  const lines = [
+    "你现在进入 GEO 执行状态看板模式。",
+    `当前输入：${board.source}`,
+    `当前状态：${board.boardStatus}`,
+    `进度：${board.progressPercent}%`,
+    `看板总结：${board.boardSummary}`
+  ];
+
+  if (board.columns.inProgress.length > 0) {
+    const current = board.columns.inProgress[0];
+    lines.push(`当前进行中：${current.id}｜${current.title}`);
+  }
+  if (board.columns.nextUp.length > 0) {
+    const next = board.columns.nextUp[0];
+    lines.push(`下一步：${next.id}｜${next.title}`);
+  }
+  if (board.columns.blocked.length > 0) {
+    lines.push(`阻塞项数量：${board.columns.blocked.length}`);
+  }
+
+  lines.push("请按看板方式说明：已完成、进行中、阻塞、下一步、排队中的任务。");
+  return lines.join("\n");
+}
+
+async function resolveTracker(input, options = {}) {
+  const resolvedPath = path.resolve(input);
+  if (await pathExists(resolvedPath)) {
+    try {
+      const raw = await fs.readFile(resolvedPath, "utf8");
+      const parsed = JSON.parse(raw);
+      if (parsed?.kind === "geo-agent-status-board" && parsed.tracker?.kind === "geo-agent-progress-tracker") {
+        return createAgentProgressTracker(parsed.tracker.source || input, {
+          format: "json",
+          currentTaskId: options.currentTaskId || parsed.tracker.currentTaskId,
+          completedPacketIds:
+            options.completedPacketIds != null
+              ? options.completedPacketIds
+              : (parsed.tracker.completedPacketIds || []).join(","),
+          blockedReasons:
+            options.blockedReasons != null ? options.blockedReasons : (parsed.tracker.blockedReasons || []).join(",")
+        });
+      }
+    } catch {
+      // Fall through to tracker generation
+    }
+  }
+
+  return createAgentProgressTracker(input, {
+    format: "json",
+    currentTaskId: options.currentTaskId,
+    completedPacketIds: options.completedPacketIds,
+    blockedReasons: options.blockedReasons
+  });
+}
+
+export async function createAgentStatusBoard(input, options = {}) {
+  const format = normalizeFormat(options.format);
+  const tracker = await resolveTracker(input, options);
+  const columns = buildColumns(tracker);
+
+  const board = {
+    kind: "geo-agent-status-board",
+    input,
+    source: tracker.source,
+    sourceType: tracker.sourceType,
+    artifactKind: tracker.artifactKind,
+    format,
+    boardStatus: tracker.status,
+    boardSummary: buildBoardSummary(tracker),
+    progressPercent: tracker.progressPercent,
+    totalPackets: tracker.totalPackets,
+    completedCount: tracker.completedCount,
+    remainingCount: tracker.remainingCount,
+    columns,
+    suggestedNextCommand: tracker.suggestedNextCommand,
+    followupCommands: tracker.followupCommands,
+    boardPrompt: "",
+    tracker
+  };
+
+  board.boardPrompt = buildBoardPrompt(board);
+  return board;
+}
+
+export function renderAgentStatusBoardMarkdown(board) {
+  const lines = [
+    "# GEO Agent Status Board",
+    "",
+    `- 输入：\`${board.source}\``,
+    `- 来源类型：\`${board.sourceType}\``,
+    `- 工件类型：\`${board.artifactKind}\``,
+    `- 看板状态：\`${board.boardStatus}\``,
+    `- 进度：\`${board.progressPercent}%\``,
+    `- 已完成：\`${board.completedCount}/${board.totalPackets}\``,
+    `- 看板总结：${board.boardSummary}`,
+    ""
+  ];
+
+  const sections = [
+    ["已完成", board.columns.completed],
+    ["进行中", board.columns.inProgress],
+    ["阻塞", board.columns.blocked],
+    ["下一步", board.columns.nextUp],
+    ["排队中", board.columns.queued],
+    ["收尾", board.columns.closeout]
+  ];
+
+  for (const [label, items] of sections) {
+    lines.push(`## ${label}`, "");
+    if (items.length === 0) {
+      lines.push("- 当前没有内容。", "");
+      continue;
+    }
+
+    for (const item of items) {
+      lines.push(`- ${item.id}｜${item.title}`);
+      lines.push(`  - Owner：${item.owner}`);
+      lines.push(`  - 优先级：${item.priority}`);
+      if (item.currentPacketId) {
+        lines.push(`  - 当前关联包：${item.currentPacketId}`);
+      }
+    }
+    lines.push("");
+  }
+
+  lines.push("## 建议下一步命令", "");
+  lines.push(`- \`${board.suggestedNextCommand}\``);
+
+  lines.push("", "## 后续命令", "");
+  for (const command of board.followupCommands) {
+    lines.push(`- \`${command}\``);
+  }
+
+  lines.push("", "## 可直接复制给 Agent 的 Status Board Prompt", "", "```text");
+  lines.push(board.boardPrompt || buildBoardPrompt(board));
+  lines.push("```");
+
+  lines.push("", "## 详细进度追踪", "");
+  lines.push(renderAgentProgressTrackerMarkdown(board.tracker).trim());
+  lines.push("");
+
+  return `${lines.join("\n")}\n`;
+}
+
+export async function writeAgentStatusBoardOutput(outputPath, content) {
+  return writeAgentProgressTrackerOutput(outputPath, content);
+}

package/src/auto-flow.js

@@ -50,6 +50,9 @@ function inferTaskTextMode(text) {
   if (/(progress-tracker|progress tracker|进度追踪|做到第几包|卡在哪|下一包是什么)/i.test(normalized)) {
     return "execute";
   }
+  if (/(status-board|status board|状态看板|执行看板|看板视图|board 视图)/i.test(normalized)) {
+    return "execute";
+  }
   if (/(executor|先做哪一个|先做哪一包|single task|执行第一包|先执行一个任务)/i.test(normalized)) {
     return "execute";
   }
@@ -169,6 +172,7 @@ function resolveEffectiveIntent(intent, detected) {
       "geo-agent-executor",
       "geo-agent-batch-executor",
       "geo-agent-progress-tracker",
+      "geo-agent-status-board",
       "geo-apply-plan",
       "geo-handoff-bundle",
       "geo-fix-plan"
@@ -329,6 +333,24 @@ function buildCommandChain(detected, intent) {
               `geo-ai-search-optimization completion-report ${source}`,
               `geo-ai-search-optimization handoff-bundle ${source}`
             ];
+    case "geo-agent-status-board":
+      return detected.parsed?.boardStatus === "completed"
+        ? [
+            `geo-ai-search-optimization completion-report ${source}`,
+            `geo-ai-search-optimization handoff-bundle ${source}`,
+            `geo-ai-search-optimization publish-pack ${source}`
+          ]
+        : detected.parsed?.tracker?.currentTaskId
+          ? [
+              `geo-ai-search-optimization agent-executor ${source} --task ${detected.parsed.tracker.currentTaskId}`,
+              `geo-ai-search-optimization agent-progress-tracker ${source}`,
+              `geo-ai-search-optimization completion-report ${source}`
+            ]
+          : [
+              `geo-ai-search-optimization agent-progress-tracker ${source}`,
+              `geo-ai-search-optimization completion-report ${source}`,
+              `geo-ai-search-optimization handoff-bundle ${source}`
+            ];
     case "geo-apply-plan":
       return [
         `geo-ai-search-optimization agent-executor ${source}`,
@@ -406,6 +428,8 @@ function pickSkillName(detected, intent) {
       return "geo-ai-search-optimization-agent-batch-executor";
     case "geo-agent-progress-tracker":
       return "geo-ai-search-optimization-agent-progress-tracker";
+    case "geo-agent-status-board":
+      return "geo-ai-search-optimization-agent-status-board";
     case "geo-completion-report":
       return "geo-ai-search-optimization-completion-report";
     case "geo-handoff-bundle":
@@ -444,6 +468,7 @@ function buildSecondarySkillNames(primarySkill, intent, detected) {
       "geo-agent-executor",
       "geo-agent-batch-executor",
       "geo-agent-progress-tracker",
+      "geo-agent-status-board",
       "geo-apply-plan"
     ].includes(
       detected.artifactKind
@@ -451,6 +476,7 @@ function buildSecondarySkillNames(primarySkill, intent, detected) {
   ) {
     names.add("geo-ai-search-optimization-agent-batch-executor");
     names.add("geo-ai-search-optimization-agent-progress-tracker");
+    names.add("geo-ai-search-optimization-agent-status-board");
     names.add("geo-ai-search-optimization-agent-executor");
     names.add("geo-ai-search-optimization-agent-runbook");
     names.add("geo-ai-search-optimization-agent-handoff");
@@ -482,6 +508,7 @@ function buildStage(intent, detected) {
       "geo-agent-executor",
       "geo-agent-batch-executor",
       "geo-agent-progress-tracker",
+      "geo-agent-status-board",
       "geo-apply-plan",
       "geo-handoff-bundle"
     ].includes(detected.artifactKind)
@@ -496,6 +523,7 @@ function buildStage(intent, detected) {
       "geo-agent-executor",
       "geo-agent-batch-executor",
       "geo-agent-progress-tracker",
+      "geo-agent-status-board",
       "geo-apply-plan",
       "geo-handoff-bundle"
     ].includes(detected.artifactKind)

package/src/cli.js

@@ -14,6 +14,7 @@ import {
   renderAgentProgressTrackerMarkdown,
   writeAgentProgressTrackerOutput
 } from "./agent-progress-tracker.js";
+import { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
 import { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
 import { createAgentSession, renderAgentSessionMarkdown, writeAgentSessionOutput } from "./agent-session.js";
 import { createAutoFlow, renderAutoFlowMarkdown, writeAutoFlowOutput } from "./auto-flow.js";
@@ -77,6 +78,7 @@ function printHelp() {
       "  geo-ai-search-optimization agent-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization agent-batch-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--count <count>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization agent-progress-tracker <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+      "  geo-ai-search-optimization agent-status-board <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
       "  geo-ai-search-optimization skills [--json]",
       "  geo-ai-search-optimization where",
       "  geo-ai-search-optimization doctor [--json]",
@@ -303,6 +305,34 @@ async function handleAgentProgressTracker(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleAgentStatusBoard(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("agent-status-board 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
+  }
+
+  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
+  const board = await createAgentStatusBoard(input, {
+    format,
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  const outputJson = board.format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(board, null, 2)}\n`
+    : renderAgentStatusBoardMarkdown(board);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeAgentStatusBoardOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 agent status board：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
 function handleWhere() {
   process.stdout.write(
     [
@@ -873,6 +903,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "agent-status-board") {
+    await handleAgentStatusBoard(rest);
+    return;
+  }
+
   if (command === "skills") {
     await handleSkills(rest);
     return;

package/src/index.js

@@ -15,6 +15,7 @@ export {
   renderAgentProgressTrackerMarkdown,
   writeAgentProgressTrackerOutput
 } from "./agent-progress-tracker.js";
+export { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
 export { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
 export { createAgentSession, renderAgentSessionMarkdown, writeAgentSessionOutput } from "./agent-session.js";
 export { createCompletionReport, renderCompletionReportMarkdown, writeCompletionReportOutput } from "./completion-report.js";

package/src/skills.js

@@ -10,6 +10,7 @@ const SKILL_ORDER = [
   "geo-ai-search-optimization-agent-executor",
   "geo-ai-search-optimization-agent-batch-executor",
   "geo-ai-search-optimization-agent-progress-tracker",
+  "geo-ai-search-optimization-agent-status-board",
   "geo-ai-search-optimization-usage",
   "geo-ai-search-optimization-agent-handoff",
   "geo-ai-search-optimization-repair-loop",
@@ -29,6 +30,7 @@ const SKILL_CATEGORY = {
   "geo-ai-search-optimization-agent-executor": "execution",
   "geo-ai-search-optimization-agent-batch-executor": "execution",
   "geo-ai-search-optimization-agent-progress-tracker": "execution",
+  "geo-ai-search-optimization-agent-status-board": "execution",
   "geo-ai-search-optimization-usage": "guidance",
   "geo-ai-search-optimization-agent-handoff": "execution",
   "geo-ai-search-optimization-repair-loop": "execution",
@@ -167,6 +169,7 @@ export function renderBundledSkillsMarkdown(bundle) {
     "- 如果要直接告诉 agent 这轮先做哪 1 包，再进入 agent-executor。",
     "- 如果要连续推进前 2 到 3 包，但仍然一次只做一包，再进入 agent-batch-executor。",
     "- 如果要追踪目前做到第几包、卡在哪、下一包是什么，再进入 agent-progress-tracker。",
+    "- 如果要把当前执行状态直接整理成看板，再进入 agent-status-board。",
     "- 再看 usage skill，知道什么时候该跑哪个命令。",
     "- 如果要交给 agent 执行，再进入 handoff / apply / completion 这一条执行链。",
     "- 如果要产出给团队分发，再进入 share / export / html / publish 这一条交付链。",