长亭百智云长亭百智云
登录
返回全部 Skills

tesseron-docs

知识检索

通过 `@tesseron/docs-mcp` MCP 服务器权威查询 Tesseron 文档。当用户需要 Tesseron 协议或 SDK 行为的精确细节（而非概述）时，调用 `search_docs` 查找相关页面，并用 `read_doc` 获取完整 markdown 正文。适用于需要确切规范的请求——包括线格式（JSON-RPC 信封、`tesseron/hello`、`tesseron/welcome`、`tesseron/resume`、`actions/progress`、`actions/cancel`）、传输帧结构、握手与申领码流程、会话恢复与 resumeToken、生命周期转换、采样契约、诱导契约（`ctx.confirm`、`ctx.elicit`）、通过 `AbortSignal` 实现的进度与取消、错误码（`TesseronErrorCode`、`SamplingNotAvailableError`、`ElicitationNotAvailableError`、`TimeoutError`、`CancelledError`、`ResumeFailedError`）、能力协商、来源允许列表、多应用命名空间、MCP 网关配置、标准模式（Zod、Valibot、Typebox）集成、操作构建器步骤、资源读取/订阅、React 钩子语义。使用以下表述：“X 返回什么错误码”、“tesseron/hello 是什么样子的”、“确切的握手形状”、“resumeToken 流程”、“网关来源允许列表”、“给我看 XX 的规范”、“X 接受哪些字段”。`framework` 技能负责方向与心智模型；`tesseron-docs` 负责逐章逐节的精确问题。

3

下载量

AI SkillHub 能力展示图

安装方式

命令行安装

在项目根目录执行以下命令，完成 Skill 安装。

npx bzskills add BrainBlend-AI/tesseron --skill tesseron-docs

skill.md

name: tesseron-docs
description: 通过 `@tesseron/docs-mcp` MCP 服务器权威查询 Tesseron 文档。当用户需要 Tesseron 协议或 SDK 行为的精确细节（而非概述）时，调用 `search_docs` 查找相关页面，并用 `read_doc` 获取完整 markdown 正文。适用于需要确切规范的请求——包括线格式（JSON-RPC 信封、`tesseron/hello`、`tesseron/welcome`、`tesseron/resume`、`actions/progress`、`actions/cancel`）、传输帧结构、握手与申领码流程、会话恢复与 resumeToken、生命周期转换、采样契约、诱导契约（`ctx.confirm`、`ctx.elicit`）、通过 `AbortSignal` 实现的进度与取消、错误码（`TesseronErrorCode`、`SamplingNotAvailableError`、`ElicitationNotAvailableError`、`TimeoutError`、`CancelledError`、`ResumeFailedError`）、能力协商、来源允许列表、多应用命名空间、MCP 网关配置、标准模式（Zod、Valibot、Typebox）集成、操作构建器步骤、资源读取/订阅、React 钩子语义。使用以下表述：“X 返回什么错误码”、“tesseron/hello 是什么样子的”、“确切的握手形状”、“resumeToken 流程”、“网关来源允许列表”、“给我看 XX 的规范”、“X 接受哪些字段”。`framework` 技能负责方向与心智模型；`tesseron-docs` 负责逐章逐节的精确问题。

Tesseron 文档

此技能是 Tesseron 文档的按需、权威查询路径。当需要精确信息时（如确切的线缆格式信封、特定错误码、握手携带的字段、恢复机制的结构契约），优先调用以下 MCP 工具，而非依赖记忆或 framework 技能的速查表。

使用方法

该插件在安装时捆绑了 @tesseron/docs-mcp，因此这些工具通常在 Claude Code 中已作为 mcp__plugin_tesseron_tesseron-docs__* 连接。

  1. 优先搜索。 调用 search_docs({ query, limit })，直接使用用户的问题原文（或简短改写但保留关键名词）。返回结果按相关性排序，包含 slug、title、description、score 以及约 240 字符的 snippet。limit 默认为 8，上限为 20；4–8 为最佳范围。
  1. 阅读顶部结果。 对第一个有希望的结果调用 read_doc({ slug })。返回完整的 Markdown 正文以及结构化 frontmatter（title、description、section、related`）。将确切的规范原文引用到你的回答中，而非转述。
  1. 如果答案涉及跨领域内容，则遍历相关文档。 read_doc 响应中的 related 字段是一个 slug 列表。当单个页面无法覆盖问题时，通过更多 read_doc 调用沿着这些边缘查找。典型示例：protocol/resume 不完整，需结合 protocol/handshake 和 protocol/transport。
  1. 仅当用户想要完整目录（如“所有协议页面有哪些？”）或 search_docs 始终找不到预期页面时，才退回到 list_docs。

不应使用本技能的场合

  • 对于概念性或思维模型类问题（如“什么是 Tesseron？”、“SDK 如何组合？”、“我应该使用哪个消费者包？”）——请加载 framework 技能。该技能是速查表；本技能是手册。
  • 对于项目集成类任务（如“将该 Tesseron 添加到这个应用”、“切换到 @tesseron/react”、“升级版本”）——请加载 tesseron-dev 技能。
  • 对于代码库映射或审查——请加载 tesseron-explorer 或 tesseron-reviewer 技能。它们读取的是项目本身，而非文档。

当 MCP 服务器未配置时的回退方案

如果调用 mcp__plugin_tesseron_tesseron-docs__* 失败（例如用户禁用了 MCP 服务器），则按顺序回退：

  1. 如果工作区是 Tesseron 单仓库本身，则直接从 docs/src/content/docs/**/*.{md,mdx} 读取。
  2. 获取已部署站点：https://eigenwise.github.io/tesseron/llms-full.txt 包含完整文档的纯文本版本；https://eigenwise.github.io/tesseron/<section>/<slug>/ 提供渲染后的页面。
  3. 交给 framework 技能捆绑的参考文件（plugin/skills/framework/references/*.md）。

切勿仅凭训练数据回答精确问题而不说明未能检索到当前规范。

引用来源

当你通过 read_doc 阅读页面时，请通过 slug 和托管 URL 链接引用，以便用户验证。例如：

根据 protocol/handshake（https://eigenwise.github.io/tesseron/protocol/handshake/），欢迎帧携带 sessionId、claimCode、resumeToken 以及协商后的 capabilities。

slug 是稳定的；发布的 URL 遵循相同路径。