@auto-ai/agent 2.1.98 → 2.1.102

package/dist/ws-test.html

@@ -5000,6 +5000,43 @@
         return u.toString()
       }
 
+      function buildSessionReplayUrl(sessionId) {
+        const u = new URL('/api/sessions/replay', httpOriginForApi() + '/')
+        u.searchParams.set('agent', currentAgentParam())
+        u.searchParams.set('sessionId', sessionId)
+        return u.toString()
+      }
+
+      /**
+       * 业务语义：历史 UI 回显走 HTTP 读 legacy jsonl 并转 v3，与 WS 实时事件解耦。
+       */
+      async function loadSessionReplayViaHttp(sessionId) {
+        const sid = typeof sessionId === 'string' ? sessionId.trim() : ''
+        if (!sid) return
+        try {
+          const r = await fetch(buildSessionReplayUrl(sid))
+          const data = await r.json()
+          if (!r.ok) {
+            throw new Error(
+              (data && data.message) || data.error || r.statusText || String(r.status),
+            )
+          }
+          const envelopes = Array.isArray(data.envelopes) ? data.envelopes : []
+          for (let i = 0; i < envelopes.length; i++) {
+            applyWsEnvelopeV3(envelopes[i])
+          }
+          requestRenderChat()
+          logLine('session-replay-http', {
+            sessionId: sid,
+            messageCount: data.messageCount,
+            envelopeCount: envelopes.length,
+          })
+        } catch (e) {
+          logLine('session-replay-http', String(e))
+          setStatus('历史回放失败: ' + e, 'err')
+        }
+      }
+
       function buildPendingPromptsUrl(sessionId) {
         const u = new URL('/api/sessions/pending-prompts', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
@@ -5363,27 +5400,27 @@
       }
 
       function buildRuntimeToolImportUrl() {
-        const u = new URL('/api/tools/runtime-import', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/tools/import', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         return u.toString()
       }
 
       function buildRuntimeToolExportUrl(fileName) {
-        const u = new URL('/api/tools/runtime-export', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/tools/export', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         u.searchParams.set('file', fileName)
         return u.toString()
       }
 
       function buildRuntimeToolDeleteUrl(fileName) {
-        const u = new URL('/api/tools/runtime-file', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/tools/file', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         u.searchParams.set('file', fileName)
         return u.toString()
       }
 
       function buildRuntimeMcpFilesUrl() {
-        const u = new URL('/api/mcp/runtime-files', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/mcps/files', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         return u.toString()
       }
@@ -5401,20 +5438,20 @@
       }
 
       function buildRuntimeMcpExportUrl(fileName) {
-        const u = new URL('/api/mcp/runtime-export', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/mcps/export', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         u.searchParams.set('file', fileName)
         return u.toString()
       }
 
       function buildRuntimeMcpImportUrl() {
-        const u = new URL('/api/mcp/runtime-import', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/mcps/import', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         return u.toString()
       }
 
       function buildRuntimeMcpDeleteUrl(fileName) {
-        const u = new URL('/api/mcp/runtime-file', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/mcps/file', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         u.searchParams.set('file', fileName)
         return u.toString()
@@ -5427,7 +5464,7 @@
       }
 
       function buildRuntimeSkillFilesUrl() {
-        const u = new URL('/api/skills/runtime-files', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/skills/files', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         return u.toString()
       }
@@ -5452,20 +5489,20 @@
       }
 
       function buildRuntimeSkillExportUrl(fileName) {
-        const u = new URL('/api/skills/runtime-export', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/skills/export', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         u.searchParams.set('file', fileName)
         return u.toString()
       }
 
       function buildRuntimeSkillImportUrl() {
-        const u = new URL('/api/skills/runtime-import', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/skills/import', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         return u.toString()
       }
 
       function buildRuntimeSkillDeleteUrl(fileName) {
-        const u = new URL('/api/skills/runtime-file', httpOriginForApi() + '/')
+        const u = new URL('/api/runtime/skills/file', httpOriginForApi() + '/')
         u.searchParams.set('agent', currentAgentParam())
         u.searchParams.set('file', fileName)
         return u.toString()
@@ -5664,10 +5701,11 @@
         const frag = document.createDocumentFragment()
         for (let i = 0; i < items.length; i++) {
           const row = items[i]
-          if (!row || typeof row.id !== 'string') continue
-          const file = String(row.id).trim()
+          if (!row || typeof row.packageId !== 'string') continue
+          const file = String(row.packageId).trim()
           if (!file) continue
-          const hasJson = row.hasMcpJson === true
+          const meta = row.meta && typeof row.meta === 'object' ? row.meta : {}
+          const hasJson = meta.hasMcpJson === true
           const item = document.createElement('div')
           item.className = 'tool-files-item'
           const main = document.createElement('div')
@@ -5677,10 +5715,12 @@
           name.textContent = file
           const sub = document.createElement('div')
           sub.className = 'tool-files-sub'
-          const fc = Number(row.fileCount || 0)
+          const fc = Number(meta.fileCount || 0)
+          const serverNames = Array.isArray(meta.serverNames) ? meta.serverNames : []
           sub.textContent =
             'MCP 包目录' +
-            (hasJson ? ' · 含 mcp.json' : ' · 缺少 mcp.json') +
+            (serverNames.length ? ' · servers: ' + serverNames.join(', ') : '') +
+            (hasJson ? ' · 含 .mcp.json' : ' · 缺少 .mcp.json') +
             ' · 可导出文件 ' +
             (Number.isFinite(fc) && fc > 0 ? fc : 0) +
             ' · zip 仅含编译产物（mcp.json / index.js）'
@@ -5751,8 +5791,8 @@
               throw new Error(x.body.message || x.body.error || x.r.statusText)
             }
             const dir =
-              x.body && typeof x.body.mcpRuntimeDir === 'string'
-                ? x.body.mcpRuntimeDir
+              x.body && typeof x.body.runtimeDir === 'string'
+                ? x.body.runtimeDir
                 : '.ws-agents/mcps-runtime'
             const items = Array.isArray(x.body.items) ? x.body.items : []
             mcpPackageMeta.textContent = dir + ' · 共 ' + items.length + ' 个包'
@@ -5801,11 +5841,12 @@
         const frag = document.createDocumentFragment()
         for (let i = 0; i < items.length; i++) {
           const row = items[i]
-          if (!row || typeof row.id !== 'string') continue
-          const file = String(row.id).trim()
+          if (!row || typeof row.packageId !== 'string') continue
+          const file = String(row.packageId).trim()
           if (!file) continue
-          const fileCount = Number(row.fileCount || 0)
-          const skillCount = Number(row.skillCount || 0)
+          const meta = row.meta && typeof row.meta === 'object' ? row.meta : {}
+          const fileCount = Number(meta.fileCount || 0)
+          const skillCount = Number(meta.skillCount || 0)
           const item = document.createElement('div')
           item.className = 'tool-files-item'
           const main = document.createElement('div')
@@ -5885,8 +5926,8 @@
               throw new Error(x.body.message || x.body.error || x.r.statusText)
             }
             const dir =
-              x.body && typeof x.body.skillsRuntimeDir === 'string'
-                ? x.body.skillsRuntimeDir
+              x.body && typeof x.body.runtimeDir === 'string'
+                ? x.body.runtimeDir
                 : '.ws-agents/skills-runtime'
             const items = Array.isArray(x.body.items) ? x.body.items : []
             skillPackageMeta.textContent = dir + ' · 共 ' + items.length + ' 个包'
@@ -6231,6 +6272,9 @@
         if (socket && socket.readyState === WebSocket.OPEN) {
           serverReady = false
           resetChatUi()
+          if (nextSid) {
+            void loadSessionReplayViaHttp(nextSid)
+          }
           pendingSessionOverrides = null
           if (nextSid) {
             /* 已在上方拉取 overrides；切换中勿清空 composer 模型 */
@@ -6297,6 +6341,13 @@
         }
         serverReady = false
         resetChatUi()
+        const replaySid =
+          sessionIdInput && typeof sessionIdInput.value === 'string'
+            ? sessionIdInput.value.trim()
+            : ''
+        if (replaySid) {
+          void loadSessionReplayViaHttp(replaySid)
+        }
         const url = buildWsUrlWithQuery()
         logLine('connect', url)
         setStatus('正在连接…', '')
@@ -6349,9 +6400,9 @@
             })
             if (
               data.type === 'session.meta' &&
-              data.payload &&
-              typeof data.payload === 'object' &&
-              data.payload.sessionId
+              data.data &&
+              typeof data.data === 'object' &&
+              data.data.sessionId
             ) {
               void loadSessions()
               if (pendingSessionOverrides) {

package/lib/launcher-env.js

@@ -1,16 +1,23 @@
 /**
- * agent 启动环境：默认路径 + .env 文件，用户无需 export。
- * 发布时由 prepack 复制到 packages/agent/lib/launcher-env.js。
+ * agent 启动环境：默认路径 + .env + 内置 runtime 同步到 .ws-agents。
+ * 发布时由 sync-launcher-env 复制为 packages/agent/lib/launcher-env.js（单文件，无子模块依赖）。
  */
 
-import { existsSync, readFileSync } from 'node:fs'
+import { cpSync, existsSync, mkdirSync, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 import { createRequire } from 'node:module'
-import { ensureWsAgentsBuiltinRuntime } from './ensure-ws-agents-runtime.js'
 
 const require = createRequire(import.meta.url)
 
+/** 与 prepack、wsSkillRuntime 等保持一致的内置 runtime 目录名 */
+const BUILTIN_RUNTIME_DIR_NAMES = [
+  'skills-runtime',
+  'tools-runtime',
+  'mcps-runtime',
+]
+
 export function resolveMainPackageRoot() {
   try {
     return dirname(require.resolve('@auto-ai/agent/package.json'))
@@ -19,6 +26,58 @@ export function resolveMainPackageRoot() {
   }
 }
 
+/**
+ * 内置 runtime 来源根：已安装的 @auto-ai/agent 包根，或源码仓库根。
+ */
+export function resolveBundledRuntimeSourceRoot() {
+  try {
+    const pkgJson = require.resolve('@auto-ai/agent/package.json')
+    return dirname(pkgJson)
+  } catch {
+    return join(dirname(fileURLToPath(import.meta.url)), '..')
+  }
+}
+
+/**
+ * 解析 WS_AGENTS_ROOT：显式环境变量优先，否则 <WS_PROJECT_ROOT|cwd>/.ws-agents。
+ */
+export function resolveWsAgentsRoot(env) {
+  const fromEnv = env.WS_AGENTS_ROOT?.trim()
+  if (fromEnv) {
+    return fromEnv
+  }
+  const projectRoot = env.WS_PROJECT_ROOT?.trim() || process.cwd()
+  return join(projectRoot, '.ws-agents')
+}
+
+/**
+ * 若 .ws-agents 下尚无对应 runtime 目录，则从包内/仓库根复制一份。
+ * 已存在则跳过，避免覆盖用户通过 API 安装或手工改动的内容。
+ */
+export function ensureWsAgentsBuiltinRuntime(env) {
+  const agentsRoot = resolveWsAgentsRoot(env)
+  if (!env.WS_AGENTS_ROOT?.trim()) {
+    env.WS_AGENTS_ROOT = agentsRoot
+  }
+
+  const sourceRoot = resolveBundledRuntimeSourceRoot()
+  mkdirSync(agentsRoot, { recursive: true })
+
+  for (const dirName of BUILTIN_RUNTIME_DIR_NAMES) {
+    const src = join(sourceRoot, dirName)
+    const dest = join(agentsRoot, dirName)
+    if (!existsSync(src) || existsSync(dest)) {
+      continue
+    }
+    cpSync(src, dest, {
+      recursive: true,
+      filter: path => !path.split(/[/\\]+/).includes('.ws-agent'),
+    })
+  }
+
+  return env
+}
+
 function applyDotenvLines(env, text) {
   for (const line of text.split('\n')) {
     const trimmed = line.trim()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auto-ai/agent",
-  "version": "2.1.98",
+  "version": "2.1.102",
   "description": "Auto AI Agent 网关 CLI（WebSocket，独立二进制，无需 Bun）",
   "type": "module",
   "maintainers": [
@@ -16,6 +16,8 @@
     "bin/agent.js",
     "lib/launcher-env.js",
     "dist",
+    "skills-runtime",
+    "tools-runtime",
     "mcps-runtime",
     "README.md",
     "LICENSE",
@@ -25,11 +27,11 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@auto-ai/agent-linux-x64": "2.1.98",
-    "@auto-ai/agent-linux-arm64": "2.1.98",
-    "@auto-ai/agent-darwin-x64": "2.1.98",
-    "@auto-ai/agent-darwin-arm64": "2.1.98",
-    "@auto-ai/agent-win-x64": "2.1.98"
+    "@auto-ai/agent-linux-x64": "2.1.102",
+    "@auto-ai/agent-linux-arm64": "2.1.102",
+    "@auto-ai/agent-darwin-x64": "2.1.102",
+    "@auto-ai/agent-darwin-arm64": "2.1.102",
+    "@auto-ai/agent-win-x64": "2.1.102"
   },
   "scripts": {
     "prepare": "node ../../scripts/sync-launcher-env.js",

package/skills-runtime/geelib/SKILL.md

@@ -0,0 +1,229 @@
+---
+name: geelib
+description: GeeLib 工作项 CLI；项目、工作项、状态、评论的查询与更新
+argument-hint: "[list-matters | get-matter | update-matter | poll | ...]"
+user-invocable: true
+allowed-tools: Bash(node:*)
+---
+
+# geelib — GeeLib 工作项 CLI
+
+通过内嵌 CLI 操作 GeeLib。**数据必须来自 CLI 的 JSON 输出**；禁止 MCP、禁止浏览器、禁止编造。
+
+## 使用方式
+
+Skill 工具注入本说明并放开 `Bash(node:*)`。**Skill 不执行 CLI、不返回 GeeLib 数据**。
+
+收到本说明后：
+
+1. 根据用户意图选择子命令（见下方命令参考）
+2. 用 `Bash` 执行 `node ${CLAUDE_SKILL_DIR}/geelib.mjs <command> [options]`
+3. 解析 stdout JSON（成功时通常 `errno === 2000`）
+4. 仅基于 CLI 返回组织回复；失败或无数据时如实说明
+
+**禁止** Glob/Read 去找 SKILL.md（本说明已在上下文中）。
+
+`$ARGUMENTS` 是自然语言描述，需映射为 CLI 子命令与 `--flag`，不要原样当作 shell 命令。
+
+## 进行中项目（Skill 加载时自动刷新）
+
+以下列表在加载本 Skill 时从 GeeLib 拉取（`is_archive=0`）。选择 `--sub-id` 时优先使用下表，无需再 Glob/Read SKILL 或重复 `list-projects` 全量 JSON。
+
+!`node ${CLAUDE_SKILL_DIR}/geelib.mjs list-active-projects`
+
+## CLI 基础
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs <command> [options]
+node ${CLAUDE_SKILL_DIR}/geelib.mjs help
+```
+
+- `${CLAUDE_SKILL_DIR}`：skill 根目录，仅用打包产物 `geelib.mjs`
+- 参数：`--key=value` 或 `--key value`；缺必填参数时 CLI 报错退出
+- 输出：stdout 一般为 JSON（`list-active-projects` 为 Markdown 表格文本）；stderr 以 `[geelib-cli]` 开头表示 CLI 级错误
+
+### 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|------|------|
+| `GEELIB_USER` | 是 | SSO 用户名 |
+| `GEELIB_PASSWD` | 是 | SSO 密码 |
+| `GEELIB_BASE_URL` | 否 | 默认 `https://geelib.qihoo.net` |
+
+### 常见依赖关系
+
+多数工作项操作需要先拿到 `sub_id`（项目）和 `type_id`（工作项类型）。**用户说的「8520」等版本号是项目名称，不是 `--sub-id`**；从上文「进行中项目」表或 `list-projects --query=8520` 解析真实 sub_id。
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-projects [--query=关键词]
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matter-types --sub-id=<sub_id>
+# 后续命令使用 --sub-id 与 --type-id
+```
+
+CLI 无通用日期/版本筛选参数；若用户按时间、版本等条件过滤，在 `list-matters` 返回的 `data.matterList[]` 中按 `create_time` 自行筛选。总数见 `data.total`；需要更多结果时递增 `--page`。
+
+## CLI 命令参考
+
+### get-user-info
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs get-user-info
+```
+
+关键字段：`data.id` 或 `data.user_id`。
+
+### list-projects
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-projects
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-projects --query=关键词
+```
+
+列表在 `data.list` 或 `data`；项目 ID 取 `id` 或 `sub_id` → `--sub-id`。
+
+### list-active-projects
+
+输出进行中项目摘要表（纯文本，供 Skill 加载注入；见上文「进行中项目」）。
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-active-projects
+```
+
+### get-project-detail
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs get-project-detail --sub-id=123
+```
+
+### list-project-members
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-project-members --sub-id=123
+```
+
+### list-matter-types
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matter-types --sub-id=123
+```
+
+关键字段：`data[]` 为数组；类型 ID 取 `id`（即 `--type-id`）；名称在 `type_name` 或 `name`。
+
+### list-matter-statuses
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matter-statuses --sub-id=123 --type-id=456
+```
+
+状态 ID 取 `status_id` 或 `matterStatus.id` 或 `id`；名称在 `matterStatus.status_name` 或 `name`。
+
+### list-matters
+
+分页查询工作项列表。
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matters --sub-id=123 --type-id=456
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matters --sub-id=123 --type-id=456 --page=1 --page-size=20
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matters --sub-id=123 --type-id=456 --keyword=标题关键词
+node ${CLAUDE_SKILL_DIR}/geelib.mjs list-matters --sub-id=123 --type-id=456 --status-id=5 --assignee-id=789
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--sub-id` | 是 | 项目 ID |
+| `--type-id` | 是 | 工作项类型 ID |
+| `--page` | 否 | 页码，默认 1 |
+| `--page-size` | 否 | 每页条数，默认 20 |
+| `--keyword` | 否 | 标题模糊搜索 |
+| `--status-id` | 否 | 按状态过滤 |
+| `--assignee-id` | 否 | 按执行人过滤 |
+
+列表在 `data.matterList`（数组）；总条数 `data.total`。单条 ID 取 `id` 或 `matter_id`；创建时间 `create_time`；标题 `title`；状态名 `status_name`。
+
+**不要用 `data.list` 或 `data.data`**（API 不返回这两个字段）。
+
+### get-matter
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs get-matter --sub-id=123 --matter-id=999
+```
+
+常用字段（均在 `data` 下）：
+
+| 字段 | 含义 |
+|------|------|
+| `title` | 标题 |
+| `content` | 描述/正文 |
+| `matter_status` | 当前状态 ID |
+| `status_name` | 当前状态名称 |
+| `matterCustomAttributes` | 自定义字段 |
+
+### update-matter
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs update-matter --sub-id=123 --matter-id=999 --status-id=5
+node ${CLAUDE_SKILL_DIR}/geelib.mjs update-matter --sub-id=123 --matter-id=999 --title="新标题" --description="新描述"
+node ${CLAUDE_SKILL_DIR}/geelib.mjs update-matter --sub-id=123 --matter-id=999 --assignee-id=789 --priority=high --progress=100
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--sub-id` | 是 | 项目 ID |
+| `--matter-id` | 是 | 工作项 ID |
+| `--title` | 否 | 标题 |
+| `--description` | 否 | 描述（映射为 API `content`） |
+| `--status-id` | 否 | 目标状态 ID |
+| `--assignee-id` | 否 | 执行人用户 ID |
+| `--priority` | 否 | `low` / `medium` / `high` / `urgent` |
+| `--progress` | 否 | 0–100 |
+| `--sprint-id` | 否 | 迭代 ID |
+
+含 `--status-id` 时 CLI 会回查验证；API 成功但状态未变更时，`errmsg` 含未填必填字段等信息。
+
+### get-comments / add-comment
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs get-comments --sub-id=123 --matter-id=999
+node ${CLAUDE_SKILL_DIR}/geelib.mjs add-comment --sub-id=123 --matter-id=999 --content="说明"
+```
+
+### poll
+
+拉取当前用户、本地尚未 `mark-processed` 的最新一条待办工作项（定时巡检入口）。**不是通用列表查询**；查多条工作项用 `list-matters`。
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs poll
+node ${CLAUDE_SKILL_DIR}/geelib.mjs poll --sub-id=123 --type-id=456
+node ${CLAUDE_SKILL_DIR}/geelib.mjs poll --cwd=/path/to/workspace
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--sub-id` | 否 | 固定项目；省略则自动发现 |
+| `--type-id` | 否 | 固定类型；省略则优先选名称含「任务」的类型 |
+| `--cwd` | 否 | 状态文件目录，默认 `process.cwd()` |
+
+返回：`hasNew`、`matter`、`mattersTotal`、`discovered`（含 `sub_id`、`type_id`、`done_status_id`）。`poll` 只更新 `lastPollAt`，不自动 mark。
+
+### mark-processed
+
+将已闭环的工作项记入本地已处理列表（配合 `poll` 去重）。
+
+```bash
+node ${CLAUDE_SKILL_DIR}/geelib.mjs mark-processed --matter-id=999
+node ${CLAUDE_SKILL_DIR}/geelib.mjs mark-processed --matter-id=999 --cwd=/path/to/workspace
+```
+
+仅在 `update-matter` 状态变更确认成功后调用。
+
+## poll 巡检闭环
+
+仅当用户明确要求「巡检 / /geelib poll」，或 Skill args 仅为 `poll` 时：
+
+1. `poll` 拉取一条待办；`hasNew === false` 则回复无新任务
+2. `get-matter` 读描述与验收标准，执行工程工作
+3. `update-matter` 回写状态（`done_status_id` 见 `poll` 返回的 `discovered`）
+4. `add-comment` 写交付说明，再次 `get-matter` 验证
+5. 状态回写成功则 `mark-processed`；失败则 `add-comment` 记录阻塞原因，不 mark
+
+状态文件：`<agentCwd>/geelib-poller-state.json`（`poll` / `mark-processed` 自动读写）。

package/skills-runtime/geelib/build.mjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * 打包 geelib CLI 为单文件 geelib.mjs，供 SKILL 内 node 调用。
+ */
+import * as esbuild from 'esbuild'
+
+await esbuild.build({
+  entryPoints: ['cli/index.ts'],
+  outfile: 'geelib.mjs',
+  bundle: true,
+  platform: 'node',
+  format: 'esm',
+  target: 'node20',
+  banner: { js: '#!/usr/bin/env node\n' },
+})

package/skills-runtime/geelib/cli/args.ts

@@ -0,0 +1,67 @@
+/** 解析 CLI 参数：--key=value 与 --key value */
+export function parseArgs(argv: string[]): {
+  positional: string[]
+  flags: Record<string, string>
+} {
+  const positional: string[] = []
+  const flags: Record<string, string> = {}
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i]
+    if (!arg.startsWith('--')) {
+      positional.push(arg)
+      continue
+    }
+    const eq = arg.indexOf('=')
+    if (eq > 0) {
+      flags[arg.slice(2, eq)] = arg.slice(eq + 1)
+      continue
+    }
+    const key = arg.slice(2)
+    const next = argv[i + 1]
+    if (next !== undefined && !next.startsWith('--')) {
+      flags[key] = next
+      i++
+    } else {
+      flags[key] = 'true'
+    }
+  }
+  return { positional, flags }
+}
+
+export function requireFlag(
+  flags: Record<string, string>,
+  name: string,
+): string {
+  const v = flags[name]
+  if (v === undefined || v === '') {
+    throw new Error(`缺少必填参数 --${name}`)
+  }
+  return v
+}
+
+export function flagNumber(
+  flags: Record<string, string>,
+  name: string,
+): number {
+  const raw = requireFlag(flags, name)
+  const n = Number(raw)
+  if (!Number.isFinite(n)) {
+    throw new Error(`--${name} 必须是数字`)
+  }
+  return n
+}
+
+export function flagOptionalNumber(
+  flags: Record<string, string>,
+  name: string,
+): number | undefined {
+  const raw = flags[name]
+  if (raw === undefined || raw === '') {
+    return undefined
+  }
+  const n = Number(raw)
+  if (!Number.isFinite(n)) {
+    throw new Error(`--${name} 必须是数字`)
+  }
+  return n
+}