geo-ai-search-optimization 1.2.11 → 1.2.13

package/README.md

@@ -145,6 +145,47 @@ geo-ai-search-optimization agent-batch-executor ./reports/apply-plan.json --task
 - 批次收尾命令
 - 可直接复制给 agent 的 batch prompt
 
+## Agent Progress Tracker 命令
+
+如果你希望 agent 不是只拿到执行队列，而是能够明确回答“现在做到第几包、当前卡在哪、下一包是什么”，可以直接用 `agent-progress-tracker`：
+
+```bash
+geo-ai-search-optimization agent-progress-tracker ./your-site
+geo-ai-search-optimization agent-progress-tracker ./reports/apply-plan.json --completed fix-01,fix-02 --current fix-03
+geo-ai-search-optimization agent-progress-tracker ./reports/agent-batch-executor.json --blocked "缺少仓库权限,缺少模板文件" --format json --out ./reports/agent-progress-tracker.json
+```
+
+`agent-progress-tracker` 会输出：
+
+- 当前状态是未开始、进行中、阻塞还是已完成
+- 已完成到哪几包
+- 当前正在推进哪一包
+- 下一包是什么
+- 当前阻塞项
+- 建议下一步命令
+- 可直接复制给 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 项目，建议照这个顺序做。
@@ -543,6 +584,8 @@ geo-ai-search-optimization agent-session ./your-site
 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
@@ -613,6 +656,20 @@ 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` 命令
+- 可以从 `apply-plan`、`agent-executor`、`agent-batch-executor` 等工件推导当前执行进度
+- 输出已完成任务、当前包、下一包、阻塞项和建议下一步命令
+- 新增 `geo-ai-search-optimization-agent-progress-tracker` skill
+
 ## New in 1.2.11
 
 - 新增 `agent-batch-executor` 命令
@@ -811,6 +868,8 @@ The installed package now includes a bundled GEO skill pack, including:
 - `geo-ai-search-optimization-agent-runbook`
 - `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.11",
+  "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

@@ -72,6 +72,26 @@ Best for:
 - making the next agent finish packet 1 before packet 2 starts
 - giving the next agent a batch-level prompt, per-packet checklists, and final closeout commands
 
+### `geo-ai-search-optimization-agent-progress-tracker`
+
+Use this when the next agent should explain current execution status, not just produce the next queue.
+
+Best for:
+
+- showing which packet is already done
+- 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-progress-tracker/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: geo-ai-search-optimization-agent-progress-tracker
+description: Track GEO execution progress from apply-plan, agent-executor, agent-batch-executor, completion-report, or related artifacts. Use when an agent should explain which GEO packet is already done, which one is active, what is blocked, and what command should run next.
+---
+
+# GEO Agent Progress Tracker
+
+Use this skill when the next agent should stop guessing current status and make the execution state explicit.
+
+`GEO = Generative Engine Optimization`
+
+## What it does
+
+- reads GEO execution artifacts and infers the current packet state
+- shows completed packets, the active packet, the next packet, and blockers
+- recommends the next command for continuing or closing out the work
+- gives the next agent a progress-tracking prompt instead of another open-ended plan
+
+## Best use
+
+- when a PM asks “现在做到哪了？”
+- when the next agent should explain status before touching the next packet
+- when batch execution is underway and the team needs a stable progress checkpoint

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GEO Agent Progress Tracker"
+  short_description: "Track which GEO packet is done, active, or blocked"
+  default_prompt: "Use $geo-ai-search-optimization-agent-progress-tracker to explain GEO execution progress, blockers, the current packet, and the next command."

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,26 +13,28 @@ Treat this tool as a PM-friendly GEO workflow for websites.
 
 `GEO = Generative Engine Optimization`
 
-The package is best explained as eighteen 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
 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. `skills`: inspect the bundled skill package
-7. `onboard-url` / `onboard`: first look
-8. `scan`: raw signal check
-9. `audit` / `report`: diagnosis
-10. `fix-plan` / `owner-board`: execution planning
-11. `agent-handoff`: agent takeover package
-12. `apply-plan`: execution loop
-13. `completion-report`: closeout
-14. `handoff-bundle`: all-in-one package
-15. `share-pack`: audience-ready delivery
-16. `export-pack`: folder export
-17. `html-pack` / `publish-pack`: browsable and final delivery output
-18. `pm-brief` / `roadmap`: stakeholder alignment
+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. `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
 
@@ -44,6 +46,8 @@ npx geo-ai-search-optimization agent-session https://example.com
 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
@@ -57,6 +61,8 @@ npx geo-ai-search-optimization agent-session ./your-site
 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
@@ -79,6 +85,8 @@ npx geo-ai-search-optimization roadmap ./your-site
 - `agent-runbook`: build a checklist-driven runbook with preflight, validation, and reporting rules
 - `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
@@ -108,6 +116,8 @@ When explaining the tool to a user:
 - if the user wants the next agent to follow a checklist and execution manual, move them to `agent-runbook`
 - 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`