mcpField
P
perplexity

perplexity

github.com/softaworks生产力2.6k774 次安装34 周前更新
代码仓库

关于 perplexity

用于将通用网络查询分流至 Perplexity Search、Perplexity Ask 或 researcher agent 的 Skill，也说明何时改用 Context7 MCP、Graphite MCP、Nx MCP 或 URL Crawler。

主要功能

  1. 01将查询分流至搜索或对话回答
  2. 02深度研究时使用 researcher agent
  3. 03设置精简的搜索结果默认值
  4. 04转交文档与工作区查询

适用场景

  1. 01查找最新实践或教程
  2. 02获取基于网络的信息解说
  3. 03通过搜索发现资源和网址
  4. 04为文档查询选择合适工具

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/softaworks/agent-toolkit --skill perplexity

安装后在 Claude Code 中输入/perplexity确认已加载。

附带文件README.md

详细介绍

Perplexity 工具

仅在用户针对通用查询说出“搜索”、“查找”、“查询”、“询问”、“研究”或“最新”时使用。不要用于库/框架文档（使用 Context7）、gt CLI（使用 Graphite MCP）或工作区问题（使用 Nx MCP）。

快速参考

选择哪个 Perplexity 工具？

  • 需要搜索结果/URL？→ Perplexity Search
  • 需要对话式回答？→ Perplexity Ask
  • 需要深度研究？→ Researcher Agent（/research <topic>）

不要使用 Perplexity - 改用这些：

  • 库/框架文档 → Context7 MCP
  • Graphite gt CLI → Graphite MCP
  • 本工作区 → Nx MCP
  • 特定 URL → URL Crawler

Perplexity Search

何时使用：

  • 通用搜索、查找资源
  • 当前最佳实践、近期信息
  • 发现教程/博客文章
  • 用户说“搜索……”、“查找……”、“查询……”

默认参数（始终使用）：

mcp__perplexity__perplexity_search({
  query: "your search query",
  max_results: 3,           // Default is 10 - too many!
  max_tokens_per_page: 512  // Reduce per-result content
})

何时增加限制： 仅在以下情况下：

  • 用户明确需要全面结果
  • 初始搜索未找到有用内容
  • 复杂主题需要多个来源
// Increased limits (use sparingly)
mcp__perplexity__perplexity_search({
  query: "complex topic",
  max_results: 5,
  max_tokens_per_page: 1024
})

Perplexity Ask

何时使用：

  • 需要对话式解释，而不是搜索结果
  • 综合来自网络的信息
  • 结合当前上下文解释概念

用法：

mcp__perplexity__perplexity_ask({
  messages: [
    {
      role: "user",
      content: "Explain how postgres advisory locks work"
    }
  ]
})

不适用于：

  • 库文档（使用 Context7）
  • 深度多来源研究（使用 researcher agent）

禁止使用的工具

绝不使用： mcp__perplexity__perplexity_research

改用： Researcher Agent（/research <topic>）

  • Token 成本：30-50k tokens
  • 提供带引用的多来源综合
  • 仅用于复杂问题，且要少用

工具选择链

优先顺序：

  1. Context7 MCP - 库/框架文档
  2. Graphite MCP - 任何提到 gt CLI 的情况
  3. Nx MCP - 本工作区问题
  4. Perplexity Search - 通用搜索
  5. Perplexity Ask - 对话式回答
  6. Researcher agent - 深度多来源研究
  7. WebSearch - 最后手段（在 Perplexity 用尽之后）

示例

✅ 正确 - 使用 Perplexity Search：

  • “查找 postgres 迁移最佳实践”
  • “搜索 React 测试教程”
  • “查询微服务的最新趋势”

✅ 正确 - 使用 Perplexity Ask：

  • “解释 postgres 咨询锁如何工作”
  • “微服务的权衡是什么？”

❌ 错误 - 改用 Context7：

  • “搜索 React hooks 文档” → Context7 MCP
  • “查找 Next.js 路由文档” → Context7 MCP
  • “查询 Temporal 工作流 API” → Context7 MCP

❌ 错误 - 改用 Graphite MCP：

  • “搜索 gt stack 命令” → Graphite MCP
  • “查找 gt 分支工作流” → Graphite MCP

❌ 错误 - 改用 Nx MCP：

  • “搜索构建配置”（在本工作区中）→ Nx MCP
  • “查找项目依赖”（在本工作区中）→ Nx MCP

要点

  • 默认使用有限结果 - 避免上下文膨胀
  • 库文档 = Context7 - 始终先尝试 Context7
  • “gt” = Graphite MCP - 任何提到“gt”的情况都使用 Graphite
  • 深度研究 = /research - 不是 perplexity_research 工具
  • 回退链 - Search → Ask → WebSearch（最后手段）

评论

支持 Markdown