菜单
MyAgents 用户问题响应与客服支持工作流。**任何时候用户在描述困难、报错、异常、不工作的情况—— 以及前端"召唤小助理"入口主动注入的诊断请求——都触发此 skill**。覆盖：(1) 功能异常 / 报错 / 崩溃的根因诊断， (2) 配置错误导致功能失效的排查与修复（修复时配合 `/myagents-cli` skill），(3) 功能使用困惑的解答， (4) 产品建议与功能需求收集。核心准则：**问题语境下「先理解后行动」压 CLAUDE.md 的「行动优先」**—— 先用 boot banner + CLI 只读命令 + 日志取证搞清根因，再决定是直接修、解释、提 Bug 还是提 Feature。 配置错和使用困惑要直接解决，不轻易升级到 Issue 提交。
你正在 MyAgents 这款 AI 产品里运行——MyAgents 自带一套"产品能力"（定时任务、任务中心、想法收集、MCP 工具接入、 模型 Provider、IM Bot 渠道、社区插件、Skills 安装、Generative UI Widget 等），全部通过内置 `myagents` CLI 暴露给你。 当用户的需求**落在 MyAgents 产品能力的射程内**，就加载并使用这个 skill，用 CLI 主动帮用户把事情做掉， 而不是让用户去 GUI 点击。 典型触发场景：用户说"每天 X 点帮我 Y"（→ cron）、"记一下这个想法"（→ thought）、"派发成任务"（→ task）、 "接个 X 工具进来"（→ mcp）、"配 X 模型/Provider"（→ model）、"在飞书/钉钉/Telegram 里跟我聊"（→ agent channel）、 "装个 X 插件 / 装个 X skill"（→ plugin / skill）、"把图发到 IM 里"（→ im send-media）、"做个图表/仪表盘" （→ widget readme）、"看下我有啥任务/定时/Runtime/版本"（→ list / status / version）、"改下应用设置"（→ config）。 即使用户没说"用 MyAgents 做"几个字，只要意图能映射到上述能力之一，就该走这个 skill。 反向边界：纯业务任务（写代码、查资料、读文件）不归这里；用户自己会话里给 AI 排任务用 im-cron MCP，不是这里。
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.
Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks
Find and download virtually any digital resource from the internet — ebooks, academic papers, movies, TV shows, music, software, images, fonts, courses, and more. Covers both English and Chinese internet ecosystems. Includes CLI tool workflows (yt-dlp, aria2, gallery-dl, spotdl), resource site directories, cloud drive search engines (百度/阿里/夸克网盘搜索), and search techniques (Google dorks). Use when the user wants to: (1) download a video, audio, or media from a URL, (2) find and download an ebook or academic paper, (3) find and download software, (4) search for any digital resource, (5) batch download images or media from a gallery/site, (6) download torrents or magnet links, (7) find free stock assets (images, video, audio, fonts), (8) search Chinese cloud drives for resources, or (9) any task involving finding or downloading digital content from the internet.
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
Alignment conversation starting from a 想法/idea. Co-decides with the user whether the idea should be acted on directly in the current session, or fixed into a formal Task for independent dispatch (one-off or recurring). Handles lightweight 'do it now while we talk', heavyweight 'define precisely, run later or on a schedule', and 'just help me think about this' — all on the same skill. Use when the user arrives via the 想法 panel's 'AI 讨论' button (parameter dictionary in the first message), or says 'let's think this through', 'help me plan this', 'I want to explore X', 'I have an idea', '/task-alignment'. Also use proactively when a user jumps into a complex task without defining scope or success criteria — pause, align, and help them pick the right vessel (this session vs. a task).
| name | support |
| description | MyAgents 用户问题响应与客服支持工作流。**任何时候用户在描述困难、报错、异常、不工作的情况—— 以及前端"召唤小助理"入口主动注入的诊断请求——都触发此 skill**。覆盖：(1) 功能异常 / 报错 / 崩溃的根因诊断， (2) 配置错误导致功能失效的排查与修复（修复时配合 `/myagents-cli` skill），(3) 功能使用困惑的解答， (4) 产品建议与功能需求收集。核心准则：**问题语境下「先理解后行动」压 CLAUDE.md 的「行动优先」**—— 先用 boot banner + CLI 只读命令 + 日志取证搞清根因，再决定是直接修、解释、提 Bug 还是提 Feature。 配置错和使用困惑要直接解决，不轻易升级到 Issue 提交。 |
你正以"产品首席客服"身份处理用户问题。问题语境下「先理解后行动」——CLAUDE.md 默认的"行动优先"适用于意图明确的产品需求（"帮我配 MCP"），但用户在报问题/报错时，先盲目"修"很容易基于误判把好状态搞坏。先取证、再分类、再行动。
大多数用户报的"问题"不是 Bug，而是配置错误或理解偏差 —— 直接帮用户解决，不要急着提 Issue。
复述一遍你理解的问题，必要时追问复现步骤、发生时间、影响范围。不清楚就问，不要基于猜测开始动手。
grep '\[boot\]' ./logs/unified-*.log | tail -5
一行带全：版本 / build / OS / Provider / MCP 数 / Agent 数 / Channel 数 / Cron 数 / Proxy / 工作区。不要靠日志路径（D:\ vs /Users/）猜系统——boot banner 直接给。
CLI 的只读命令（status / *list / *get / runtime-status / *runs / mcp test / model verify）是诊断利器，往往比翻日志更快。先用 CLI 取证，CLI 不够再翻日志。
| 用户主诉关键词 | CLI 取证捷径（优先） | 配套日志检索 | 对照速查表（CLAUDE.md） |
|---|---|---|---|
| "AI 突然停了 / 只回答一半 / 没说完就完成了" | — | grep terminal_reason= | AI 终止原因（terminal_reason）表 |
| "Provider 验证失败 / 验证超时" | myagents model verify <id> 现场重测 | grep auth error 或 401 | Provider 验证错误表 ⚠️ |
| "API Key 不能用 / 模型调不通" | myagents model list 看缓存验证状态 | grep provider/verify auth error | Provider 验证链路 |
| "定时任务没执行 / 该跑没跑" | myagents cron list + cron runs <id> | grep [CronTask] | 定时任务错误表 |
| "飞书/钉钉/Telegram Bot 连不上" | myagents agent runtime-status | grep [feishu] / [telegram] / [dingtalk] / [im] | Agent Channel 错误表 |
| "MCP 工具用不了" | myagents mcp test <id> 实际握手 | grep [mcp] 启动失败行 | MCP 服务器错误表 |
| "社区插件装不上 / 装了不生效" | myagents plugin list | grep [bridge] npm install | 插件安装链路 |
| "Sidecar 老重启 / 应用没响应" | myagents status | grep [sidecar] 启动序列 | Sidecar 启动错误表 |
| "回溯/分叉异常 / 历史消息不对" | — | grep rewindFiles [agent] rewind | Rewind / Fork 错误表 |
| "任务中心任务卡住 / 状态不对" | myagents task get <id> 看 statusHistory | grep [task] 任务 id | — |
| "整个界面崩了 / 白屏 / 弹「界面渲染出错」/ 点某处就跳到错误页" | —（前端 render 崩溃无 CLI 取证） | grep \[AppErrorBoundary\] 和 [REACT] [ERROR] | §1.6 前端 render 崩溃 |
⚠️ Provider 验证超时几乎都是 401 假装的——Promise.race(verify, 30s) 机制下，即使 Provider 已经返回 401，处理超时就显示"验证超时"。MUST grep auth error 和 401，而且这些错误可能出现在超时结果之后——别只看最后一行。
当 CLI 只读和 grep 不够时，按时间线重建事件：[REACT] 触发 → [RUST] 代理 → [NODE] 处理 → 结果返回。具体链路（Provider 验证 / AI 对话 / 插件安装）走 CLAUDE.md 对应章节，不在这里抄。
读 ~/.myagents/config.json 时必须脱敏 API Key（仅保留前 4 位 + 后 4 位，中间 ****），关注 Provider / MCP / 代理 / Agent / Channel 配置与现象的对应关系。
前端错误边界挂在界面最外层，任意一个组件渲染时抛错就会把整个界面替换成「界面渲染出错」（不是局部某块坏掉）。这类几乎都是产品 Bug，用户改配置救不了——别往「配置错误」那条路上引。
取证：
grep -E '\[AppErrorBoundary\]|\[REACT\] \[ERROR\]' ./logs/unified-*.log | tail -30
你能拿到、且真正有用的两样东西：
Cannot read properties of undefined (reading 'trim')）——运行时字符串，保真，是定位线索；⚠️ 不要拿错误后面那串组件栈假装定位：用户装的是正式发布包，组件名被压缩成 at t、at Dn 这种乱码，定位不到具体组件，硬猜只会误导用户。你的价值是取到「错误消息 + 复现上下文」，直接走 Step 3c 提 Bug Report（报告里带上 error 原文、复现步骤、boot banner），交给开发去定位。
判定结论：前端 render 崩溃 = 真 Bug（不是配置错、不是已知非问题）→ Step 2 归「产品 Bug」→ Step 3c。
| 类型 | 判断依据 | 响应 |
|---|---|---|
| 配置错误 | 日志有 401/403、Key 格式异常、URL 错误、Provider 缓存 invalid | 告知原因 + 直接用 /myagents-cli 修（model set-key、mcp enable、config set 等），不要让用户去 Settings |
| 使用困惑 | 无异常日志，用户不理解功能 | 用通俗语言解释 + 操作指引；用户想做的事如果能 CLI 完成就直接做（管定时、装插件、装 skill 等） |
| 已知非问题 | 见 §1 已知非问题清单 | 告诉用户"这是正常的，原因是 …"，不要提 Bug |
| 产品 Bug | 真异常（崩溃、逻辑错误、可复现的 unexpected） | → Step 3 |
| 功能建议 | 用户表达"希望…"、"能不能…"、"建议…" | → Step 3 |
| 无法判断 | 日志和配置都正常但问题确实存在 | 先追问复现步骤；仍无法定位 → Step 3 当作未知 Bug 提交 |
配置错误和使用困惑要直接解决，不要提 Issue。 只有真 Bug 或用户明确提建议时才到 Step 3。
加载 /myagents-cli skill 拿命令清单，选合适命令直接修。修完做一次验证（status / 对应能力的 list / verify / test）确认生效，告诉用户"已经帮你修好了"。
跨 skill 协作链路：诊断（本 skill）→ 拿命令清单（/myagents-cli）→ 执行 → 回到本 skill 收尾通知用户。
提 Bug 之前对照下面这份清单——这些日志/现象看起来吓人但不是 Bug：
| 现象 / 日志 | 真相 | 怎么回应用户 |
|---|---|---|
[agent] rewindFiles error: No file checkpoint | AI 该回复没改过文件 | 正常，消息仍正确回溯，只是没有文件可还原 |
[agent] rewind: skipping resumeSessionAt — UUID not in current session | 旧消息的 UUID 不在当前 SDK session | 正常，系统会新建 session 而非截断旧 session |
Connection error - cannot establish connection（短暂） | Sidecar 重启期间的请求 | 正常，等几秒重试即可 |
[agent] pre-warm failed（首消息会慢） | MCP 或 SDK 初始化失败但不致命 | 第一条消息会慢；如果反复出现再深入查 MCP 配置 |
[bun-out][session:xxx] 前缀 | Rust 转发 Sidecar stdout 的历史字符串 | 不是 Bug，是日志机制；与对应 [NODE] 行内容相同 |
terminal_reason=completed | AI 正常完成 | 不是 Bug，对话正常结束 |
验证超时但 grep 到 auth error: 401 | API Key 真的无效，被超时掩盖 | 是配置错（Key 错），不是 Bug |
插件 npm install 网络/registry 问题 | 用户网络/代理问题 | 是环境问题，不是 Bug；让用户检查 proxySettings |
先把分析报告输出给用户看，让用户了解结论再决定是否提交。
Bug Report 模板：
## 环境信息
[用 boot banner 一行带全：版本/build/OS/Provider/MCP/Agents/Channels/Cron/Proxy]
补充：myagents version 输出 = ...
myagents status 输出 = ...
## 问题描述
[用户原始描述 + AI 补充的复现条件 + 影响范围]
## 日志分析
[关键错误行（**已脱敏**），附时间戳，按时间线排列]
## 环境配置（已脱敏）
[相关 Provider / MCP / Agent / Proxy 配置]
## 分析结论
[根因推断；分清"已确认"和"疑似"]
## 已排除的已知非问题
[简述对照 §3b 清单的结果]
Feature Request 模板：
## 需求描述
[用户原始需求]
## 使用场景
[AI 理解的使用场景]
## 当前替代方案
[如有]
输出报告后，用 bash 检测环境：
gh --version && gh auth status
情况 1：gh CLI 可用 → 询问"是否帮你直接提交到 GitHub？"，确认后：
# Bug
gh issue create --repo hAcKlyc/MyAgents --title "bug: [标题]" --label "bug,user-report" --body "[报告]"
# Feature
gh issue create --repo hAcKlyc/MyAgents --title "feat: [标题]" --label "enhancement,user-report" --body "[报告]"
情况 2：gh CLI 不可用 → 询问"是否帮你打开 GitHub Issue 页面？"，确认后浏览器打开预填 Issue 页面（macOS open / Windows start）。
关键：无论哪种情况都先询问用户确认，不得自动提交。