@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/mcp/mcporter/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: mcporter
+description: 使用 mcporter CLI 直接列出、配置、授权和调用 MCP 服务器/工具（HTTP 或 stdio），包括临时服务器、配置编辑和 CLI/类型生成。
+version: 1.0.0
+author: community
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [MCP, Tools, API, Integrations, Interop]
+    homepage: https://mcporter.dev
+prerequisites:
+  commands: [npx]
+---
+
+# mcporter
+
+使用 `mcporter` 直接从终端发现、调用和管理 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 服务器与工具。
+
+## 前置条件
+
+需要 Node.js：
+```bash
+# No install needed (runs via npx)
+npx mcporter list
+
+# Or install globally
+npm install -g mcporter
+```
+
+## 快速开始
+
+```bash
+# List MCP servers already configured on this machine
+mcporter list
+
+# List tools for a specific server with schema details
+mcporter list <server> --schema
+
+# Call a tool
+mcporter call <server.tool> key=value
+```
+
+## 发现 MCP 服务器
+
+mcporter 会自动发现机器上由其他 MCP 客户端（Claude Desktop、Cursor 等）配置的服务器。要寻找可用的新服务器，可以浏览 [mcpfinder.dev](https://mcpfinder.dev) 或 [mcp.so](https://mcp.so) 等注册表，然后进行临时连接：
+
+```bash
+# Connect to any MCP server by URL (no config needed)
+mcporter list --http-url https://some-mcp-server.com --name my_server
+
+# Or run a stdio server on the fly
+mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs
+```
+
+## 调用工具
+
+```bash
+# Key=value syntax
+mcporter call linear.list_issues team=ENG limit:5
+
+# Function syntax
+mcporter call "linear.create_issue(title: \"Bug fix needed\")"
+
+# Ad-hoc HTTP server (no config needed)
+mcporter call https://api.example.com/mcp.fetch url=https://example.com
+
+# Ad-hoc stdio server
+mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
+
+# JSON payload
+mcporter call <server.tool> --args '{"limit": 5}'
+
+# Machine-readable output (recommended for Hermes)
+mcporter call <server.tool> key=value --output json
+```
+
+## 授权与配置
+
+```bash
+# OAuth login for a server
+mcporter auth <server | url> [--reset]
+
+# Manage config
+mcporter config list
+mcporter config get <key>
+mcporter config add <server>
+mcporter config remove <server>
+mcporter config import <path>
+```
+
+配置文件位置：`./config/mcporter.json`（可通过 `--config` 覆盖）。
+
+## 守护进程
+
+用于保持持久的服务器连接：
+```bash
+mcporter daemon start
+mcporter daemon status
+mcporter daemon stop
+mcporter daemon restart
+```
+
+## 代码生成
+
+```bash
+# Generate a CLI wrapper for an MCP server
+mcporter generate-cli --server <name>
+mcporter generate-cli --command <url>
+
+# Inspect a generated CLI
+mcporter inspect-cli <path> [--json]
+
+# Generate TypeScript types/client
+mcporter emit-ts <server> --mode client
+mcporter emit-ts <server> --mode types
+```
+
+## 说明
+
+- 使用 `--output json` 获取更易于解析的结构化输出
+- 临时服务器（HTTP URL 或 `--stdio` 命令）无需任何配置即可运行——非常适合一次性调用
+- OAuth 授权可能需要交互式浏览器流程——如有需要，请使用 `terminal(command="mcporter auth <server>", pty=true)`

package/extensions/skills/optional/migration/DESCRIPTION.md

@@ -0,0 +1 @@
+用于将用户状态和自定义配置从其他 agent 系统导入到 Hermes Agent 的可选迁移工作流。

package/extensions/skills/optional/migration/openclaw-migration/SKILL.md

@@ -0,0 +1,298 @@
+---
+name: openclaw-migration
+description: 将用户的 OpenClaw 自定义配置迁移至 Hermes Agent。从 `~/.openclaw` 导入兼容 Hermes 的记忆、`SOUL.md`、命令允许列表、用户技能以及选定的工作区资产，随后报告确切无法迁移的内容及其原因。
+version: 1.0.0
+author: Hermes Agent (Nous Research)
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [Migration, OpenClaw, Hermes, Memory, Persona, Import]
+    related_skills: [hermes-agent]
+---
+
+# OpenClaw -> Hermes 迁移
+
+当用户希望以最少的手动清理工作将他们的 OpenClaw 设置迁移至 Hermes Agent 时，请使用此技能。
+
+## CLI 命令
+
+若要进行快速、非交互式的迁移，请使用内置的 CLI 命令：
+
+```bash
+hermes claw migrate              # Full interactive migration
+hermes claw migrate --dry-run    # Preview what would be migrated
+hermes claw migrate --preset user-data   # Migrate without secrets
+hermes claw migrate --overwrite  # Overwrite existing conflicts
+hermes claw migrate --source /custom/path/.openclaw  # Custom source
+```
+
+该 CLI 命令会运行下文所述的相同迁移脚本。当您希望通过试运行预览和逐项冲突解决来进行交互式、引导式迁移时，请（通过 agent）使用此技能。
+
+**首次设置：** `hermes setup` 向导会自动检测 `~/.openclaw` 并在配置开始前提供迁移选项。
+
+## 此技能的功能
+
+它使用 `scripts/openclaw_to_hermes.py` 来：
+
+- 将 `SOUL.md` 作为 `SOUL.md` 导入到 Hermes 主目录中
+- 将 OpenClaw 的 `MEMORY.md` 和 `USER.md` 转换为 Hermes 记忆条目
+- 将 OpenClaw 命令批准模式合并到 Hermes `command_allowlist` 中
+- 迁移兼容 Hermes 的消息传递设置（例如 `TELEGRAM_ALLOWED_USERS`），并将 OpenClaw 工作区设置映射到 Hermes 工作目录配置
+- 将 OpenClaw 技能复制到 `~/.hermes/skills/openclaw-imports/`
+- 可选地将 OpenClaw 工作区指令文件复制到选定的 Hermes 工作区
+- 将兼容的工作区资产（例如 `workspace/tts/`）镜像到 `~/.hermes/tts/`
+- 归档没有直接对应 Hermes 目标的非机密文档
+- 生成一份结构化的报告，列出已迁移的项目、冲突、已跳过的项目及其原因
+
+## 路径解析
+
+辅助脚本位于此技能目录下的：
+
+- `scripts/openclaw_to_hermes.py`
+
+当此技能从 Skills Hub 安装时，常规位置是：
+
+- `~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py`
+
+不要猜测较短的路径，例如 `~/.hermes/skills/openclaw-migration/...`。
+
+在运行辅助脚本之前：
+
+1. 优先使用安装在 `~/.hermes/skills/migration/openclaw-migration/` 下的路径。
+2. 如果该路径失败，请检查已安装的技能目录，并相对于已安装的 `SKILL.md` 解析脚本路径。
+3. 仅在安装位置缺失或技能已被手动移动的情况下，才使用 `find` 作为回退方案。
+4. 调用终端工具时，不要传递 `workdir: "~"`。请使用绝对目录（例如用户的主目录），或者完全省略 `workdir`。
+
+如果加上 `--migrate-secrets`，它还会导入一小部分列入允许列表的 Hermes 兼容机密信息，当前包括：
+
+- `TELEGRAM_BOT_TOKEN`
+
+## 默认工作流
+
+1. 首先通过试运行进行检查。
+2. 提供一个简明的摘要，说明哪些内容可以迁移、哪些不能迁移、哪些将被归档。
+3. 如果 `clarify` 工具可用，请使用它来处理用户决策，而不是要求用户进行自由文本回复。
+4. 如果试运行发现导入的技能目录存在冲突，请在执行前询问应如何处理。
+5. 在执行前，要求用户在支持的两个迁移模式之间做出选择。
+6. 仅当用户希望迁移工作区指令文件时，才询问目标工作区路径。
+7. 使用匹配的 preset 和标志执行迁移。
+8. 总结结果，特别是：
+   - 已迁移的内容
+   - 为供手动审查而归档的内容
+   - 已跳过的内容及原因
+
+## 用户交互协议
+
+Hermes CLI 支持 `clarify` 工具进行交互式提示，但它具有以下限制：
+
+- 每次只能选择一个选项
+- 最多 4 个预定义选项
+- 自动带有 `Other` 自由文本选项
+
+它**不**支持在单次提示中实现真正的多选复选框。
+
+对于每一次 `clarify` 调用：
+
+- 始终包含非空的 `question`
+- 仅在实际有可选项进行提示时包含 `choices`
+- 将 `choices` 保持在 2-4 个纯字符串选项
+- 绝不发出占位符或截断的选项，例如 `...`
+- 绝不使用额外的空格来填充或修饰选项
+- 绝不在问题中包含虚假的表单字段，例如 `enter directory here`、需要填写的空行，或是像 `_____` 这样的下划线
+- 对于开放式路径问题，仅询问纯文本句子；用户会在面板下方的常规 CLI 提示符中进行输入
+
+如果 `clarify` 调用返回错误，请检查错误文本，更正有效负载，然后使用有效的 `question` 和干净的 `choices` 重试一次。
+
+当 `clarify` 可用且试运行显示任何需要用户做出决定的情况时，您的**下一步操作必须是调用 `clarify` 工具**。
+不要以常规的 assistant 消息结束回合，例如：
+
+- "让我为您展示这些选项"
+- "您想怎么做？"
+- "以下是这些选项"
+
+如果需要用户做出决定，请通过 `clarify` 收集决定，然后再生成更多说明文字。
+如果还有多个未解决的决定，请不要在它们之间插入解释性的 assistant 消息。在收到一个 `clarify` 回复后，您的下一步操作通常应是下一个必需的 `clarify` 调用。
+
+当试运行报告以下情况时，请将 `workspace-agents` 视为未解决的决定：
+
+- `kind="workspace-agents"`
+- `status="skipped"`
+- 原因包含 `No workspace target was provided`
+
+在这种情况下，您必须在执行前询问工作区指令。不要默认将其视为决定跳过。
+
+由于该限制，请使用以下简化的决策流程：
+
+1. 对于 `SOUL.md` 冲突，使用带有以下选项的 `clarify`：
+   - `keep existing`
+   - `overwrite with backup`
+   - `review first`
+2. 如果试运行显示一个或多个 `kind="skill"` 且 `status="conflict"` 的项目，请使用带有以下选项的 `clarify`：
+   - `keep existing skills`
+   - `overwrite conflicting skills with backup`
+   - `import conflicting skills under renamed folders`
+3. 对于工作区指令，使用带有以下选项的 `clarify`：
+   - `skip workspace instructions`
+   - `copy to a workspace path`
+   - `decide later`
+4. 如果用户选择复制工作区指令，请提出一个后续的开放式 `clarify` 问题，要求提供**绝对路径**。
+5. 如果用户选择 `skip workspace instructions` 或 `decide later`，则在不添加 `--workspace-target` 的情况下继续。
+6. 对于迁移模式，使用带有这 3 个选项的 `clarify`：
+   - `user-data only`
+   - `full compatible migration`
+   - `cancel`
+7. `user-data only` 意味着：迁移用户数据和兼容的配置，但**不**导入允许列表中的机密。
+8. `full compatible migration` 意味着：迁移相同的兼容用户数据，并在存在时加上允许列表中的机密。
+9. 如果 `clarify` 不可用，请在常规文本中提出相同的问题，但仍需将答案限制为 `user-data only`、`full compatible migration` 或 `cancel`。
+
+执行门控：
+
+- 当由 `No workspace target was provided` 引起的 `workspace-agents` 跳过状态仍未解决时，请勿执行。
+- 解决此问题的唯一有效方法是：
+  - 用户明确选择 `skip workspace instructions`
+  - 用户明确选择 `decide later`
+  - 用户在选择 `copy to a workspace path` 后提供工作区路径
+- 试运行中没有工作区目标本身并不意味着允许执行。
+- 只要有任何必需的 `clarify` 决定未解决，请勿执行。
+
+请使用这些确切的 `clarify` 有效负载格式作为默认模式：
+
+- `{"question":"Your existing SOUL.md conflicts with the imported one. What should I do?","choices":["keep existing","overwrite with backup","review first"]}`
+- `{"question":"One or more imported OpenClaw skills already exist in Hermes. How should I handle those skill conflicts?","choices":["keep existing skills","overwrite conflicting skills with backup","import conflicting skills under renamed folders"]}`
+- `{"question":"Choose migration mode: migrate only user data, or run the full compatible migration including allowlisted secrets?","choices":["user-data only","full compatible migration","cancel"]}`
+- `{"question":"Do you want to copy the OpenClaw workspace instructions file into a Hermes workspace?","choices":["skip workspace instructions","copy to a workspace path","decide later"]}`
+- `{"question":"Please provide an absolute path where the workspace instructions should be copied."}`
+
+## 决策到命令的映射
+
+将用户决策精确映射到命令标志：
+
+- 如果用户针对 `SOUL.md` 选择 `keep existing`，则**不要**添加 `--overwrite`。
+- 如果用户选择 `overwrite with backup`，则添加 `--overwrite`。
+- 如果用户选择 `review first`，则在执行前停止并审查相关文件。
+- 如果用户选择 `keep existing skills`，则添加 `--skill-conflict skip`。
+- 如果用户选择 `overwrite conflicting skills with backup`，则添加 `--skill-conflict overwrite`。
+- 如果用户选择 `import conflicting skills under renamed folders`，则添加 `--skill-conflict rename`。
+- 如果用户选择 `user-data only`，则使用 `--preset user-data` 执行，并且**不要**添加 `--migrate-secrets`。
+- 如果用户选择 `full compatible migration`，则使用 `--preset full --migrate-secrets` 执行。
+- 仅当用户明确提供绝对工作区路径时，才添加 `--workspace-target`。
+- 如果用户选择 `skip workspace instructions` 或 `decide later`，则不要添加 `--workspace-target`。
+
+在执行之前，请用纯语言重述确切的命令计划，并确保其符合用户的选择。
+
+## 运行后报告规则
+
+执行后，请将脚本输出的 JSON 视为真相来源。
+
+1. 以 `report.summary` 为基础统计所有数量。
+2. 仅当项目的 `status` 确切为 `migrated` 时，才将其列在“成功迁移”下。
+3. 除非报告显示该项目已 `migrated`，否则不要声称冲突已解决。
+4. 除非 `kind="soul"` 的报告项显示 `status="migrated"`，否则不要声称 `SOUL.md` 已被覆盖。
+5. 如果 `report.summary.conflict > 0`，请包含冲突说明部分，而不是默默暗示成功。
+6. 如果统计数量与列出的项目不一致，请在回复前调整列表以匹配报告。
+7. 如果报告中包含 `output_dir` 路径，请将其一并提供，以便用户可以检查 `report.json`、`summary.md`、备份文件和归档文件。
+8. 对于 memory 或 user-profile 溢出，除非报告明确显示归档路径，否则不要说条目已被归档。如果 `details.overflow_file` 存在，请说明完整的溢出列表已导出到那里。
+9. 如果技能是在重命名的文件夹下导入的，请报告最终目的地并提及 `details.renamed_from`。
+10. 如果存在 `report.skill_conflict_mode`，请将其作为所选导入技能冲突策略的真相来源。
+11. 如果某个项目的 `status="skipped"`，请不要将其描述为已覆盖、已备份、已迁移或已解决。
+12. 如果 `kind="soul"` 的 `status="skipped"` 且原因是 `Target already matches source`，请说明其保持不变，并且不要提及备份。
+13. 如果重命名的导入技能具有空的 `details.backup`，请不要暗示现有的 Hermes 技能已被重命名或备份。只需说明导入的副本已放置在新目的地，并将 `details.renamed_from` 引用为保持原状的预先存在的文件夹。
+
+## 迁移预设
+
+在正常使用中，请优先使用这两个预设：
+
+- `user-data`
+- `full`
+
+`user-data` 包括：
+
+- `soul`
+- `workspace-agents`
+- `memory`
+- `user-profile`
+- `messaging-settings`
+- `command-allowlist`
+- `skills`
+- `tts-assets`
+- `archive`
+
+`full` 包括 `user-data` 中的所有内容，外加：
+
+- `secret-settings`
+
+辅助脚本仍然支持类别级别的 `--include` / `--exclude`，但请将其视为高级后备方案，而不是默认的用户体验。
+
+## 命令
+
+进行完整发现的试运行：
+
+```bash
+python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py
+```
+
+使用终端工具时，请优先使用绝对路径调用模式，例如：
+
+```json
+{"command":"python3 /home/USER/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py","workdir":"/home/USER"}
+```
+
+使用 `user-data` 预设进行试运行：
+
+```bash
+python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --preset user-data
+```
+
+执行 `user-data` 迁移：
+
+```bash
+python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset user-data --skill-conflict skip
+```
+
+执行完全兼容的迁移：
+
+```bash
+python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset full --migrate-secrets --skill-conflict skip
+```
+
+包含工作区指令执行：
+
+```bash
+python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset user-data --skill-conflict rename --workspace-target "/absolute/workspace/path"
+```
+
+默认情况下，不要将 `$PWD` 或主目录用作工作区目标。请先询问明确的工作区路径。
+
+## 重要规则
+
+1. 除非用户明确表示要立即继续，否则在写入前进行试运行。
+2. 默认情况下不要迁移机密。除非用户明确要求迁移机密，否则 Tokens、auth blobs、设备凭据和原始 gateway 配置应保留在 Hermes 之外。
+3. 除非用户明确要求，否则不要默默覆盖非空的 Hermes 目标。辅助脚本在启用覆盖时会保留备份。
+4. 始终向用户提供已跳过项目的报告。该报告是迁移的一部分，不是可选的附加内容。
+5. 优先使用主要的 OpenClaw 工作区（`~/.openclaw/workspace/`）而不是 `workspace.default/`。仅在主文件缺失时才使用默认工作区作为后备。
+6. 即使在机密迁移模式下，也只能迁移具有明确 Hermes 目标的机密。不支持的 auth blobs 仍必须报告为已跳过。
+7. 如果试运行显示有大量资产复制、冲突的 `SOUL.md` 或溢出的 memory 条目，请在执行前单独指出这些问题。
+8. 如果用户不确定，默认设置为 `user-data only`。
+9. 仅当用户明确提供目标工作区路径时，才包含 `workspace-agents`。
+10. 将类别级别的 `--include` / `--exclude` 视为高级的逃生舱机制，而不是常规流程。
+11. 如果 `clarify` 可用，不要在试运行摘要的结尾使用诸如“您想怎么做？”之类的模糊问题。请改用结构化的后续提示。
+12. 当真正的选项提示可行时，不要使用开放式的 `clarify` 提示。优先使用可选选项，然后仅在需要绝对路径或文件审查请求时使用自由文本。
+13. 试运行后，如果仍有未解决的决定，千万不要在总结后就停止。请立即针对最高优先级的阻塞决定使用 `clarify`。
+14. 后续问题的优先级顺序：
+    - `SOUL.md` 冲突
+    - 导入的技能冲突
+    - 迁移模式
+    - 工作区指令目的地
+15. 不要承诺在同一消息中稍后展示选项。请通过实际调用 `clarify` 来展示它们。
+16. 在收到关于迁移模式的回答后，明确检查 `workspace-agents` 是否仍未解决。如果是，您的下一步操作必须是工作区指令的 `clarify` 调用。
+17. 收到任何 `clarify` 回答后，如果还有其他需要做的决定，请不要叙述刚刚做出的决定。立即询问下一个必需的问题。
+
+## 预期结果
+
+成功运行后，用户应拥有：
+
+- 导入的 Hermes persona 状态
+- 填充了转换后的 OpenClaw 知识的 Hermes memory 文件
+- 在 `~/.hermes/skills/openclaw-imports/` 下可用的 OpenClaw 技能
+- 一份显示任何冲突、遗漏或不受支持数据的迁移报告