Skip to content

feat: 新增内置 memoh-help skill,让 agent 依据官方文档回答产品问题 - #1617

Merged
sheepbox8646 merged 2 commits into
mainfrom
feat/memoh-169-memoh-help-skill
Oct 18, 2026
Merged

sheepbox8646 merged 2 commits into
mainfrom
feat/memoh-169-memoh-help-skill

Conversation

@sheepbox8646

@sheepbox8646 sheepbox8646 commented Oct 18, 2026 •

Copy link
Copy Markdown
Member

Author

  • Human
  • Agent

Type

  • bug
  • feat
  • test

Summary

问题:内置 Agent 回答 Memoh 产品自身的问题时没有依据,会根据工作区环境的检查结果得出“不支持”之类的错误结论。例如用户问能否按 .node-version 切换 Node 版本,Agent 发现工作区只有一个 Node 版本,就回答需要另装工具。

改动:新增内置 skill memoh-help,放在 templates/workspace/.memoh/skills/ 下作为托管文件,随工作区模板下发。每次 reconcile 都会刷新,已有 bot 也能拿到。

  • description:首先说明“你就是 Memoh,用户问 Memoh 就是在问你”,再列出触发场景:功能、设置、用法、各模块、桌面版、自部署、套餐、额度、计费、账号、隐私与安全,以及准备断言“Memoh 不支持某功能”之前。
  • 基本原则:工作区里装了什么不等于 Memoh 支持什么;官方资料没有覆盖的问题,如实说明“资料未写明”,不做臆断。
  • 两个官方来源,回答时实时获取,skill 中不写死任何参考内容:
  • 取资料方法:先用 web_fetch 读索引,再读 1–3 个 .md 页面;按用户的语言选择 /zh/、/ja/、/ru/ 等前缀的页面,没有对应语言时用英文;跳过 “Redirecting” 条目;只读单页,不读 llms-full.txt。web_fetch 失败时改用工作区的 curl;两个来源都不可达时如实告知用户,不凭记忆回答。
  • 回答要求:先给结论,再按界面路径给步骤,并附上所依据的页面链接;行为与文档不一致时说明可能是版本差异。

templates/workspace_test.go 增加对新 skill 被嵌入的断言,templates/README.md 更新内置 skill 列表。系统提示词没有修改。

依赖

各 runtime 的覆盖范围(读代码核实,未实测)

  • 原生 runtime:通过 use_skill 加载。
  • Codex / Claude Code:Memoh 不会把 skill 同步到它们自己的 skill 目录,只能经由挂载的 Memoh MCP 工具网关调用 use_skill,尚未实测。
  • 没有工作区的 bot:拿不到任何 skill。

Related Issues

Validation

已执行:

  • go test ./templates/ ./internal/workspace/ ./internal/skills/:通过。
  • quick_validate.py templates/workspace/.memoh/skills/memoh-help:[OK] skill is valid。
  • 用 curl 确认 https://docs.memoh.ai/llms.txt 以及 en、zh 页面的 .md 返回 text/markdown;帮助中心的纯文本路径在 landing 本地 dev 服务器上验证过(见 landing#31)。

未执行:

  • 未运行 mise run lint。
  • 未进行 dev 环境与真实 UI 验证。 隔离 dev 环境启动时遇到 Docker Hub / npm 网络问题,用户明确要求本次先不起环境验证、直接提交。因此以下各项均未验证:Skills Tab 中出现 memoh-help、Agent 实际调用该 skill 的效果、验收问题集的回答质量。

Screenshots / Recordings

暂无截图:本次未在运行中的应用里验证(原因见上),没有可上传的证据。

Human QA

  • Human QA passed

🤖 Generated with Claude Code

Adds a managed workspace skill that teaches the agent to answer questions
about Memoh itself from the official Markdown docs instead of inferring
missing features from the workspace environment. A bundled quick reference
covers core concepts, bot detail tabs, and the doc page for each topic so
basic questions still work when the docs are unreachable.

Refs MEMOH-169

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added feat Adds or improves functionality size:S PR size uses the larger of added or deleted lines, excluding generated files labels Oct 18, 2026
…enter

Drop the bundled quick reference so the skill always reads the live
docs.memoh.ai and memoh.ai/help indexes, pick pages in the user's
language from whatever locales the indexes list, and state in the
description that the agent is Memoh.

Refs MEMOH-169

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sheepbox8646
sheepbox8646 merged commit 860ff03 into main Oct 18, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feat Adds or improves functionality size:S PR size uses the larger of added or deleted lines, excluding generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant