deep-research

深度研究

此技能提供了一种系统化的方法，用于研究和分析代码库及外部依赖项。它旨在用于开始复杂的实现任务之前。

<critical_tools> 你必须严格遵循项目命令指南中定义的规则。

1. 本地代码发现

   • **必需的子技能：**使用 codebase_search 发现本地代码。
   • 强制要求：使用 codebase_search 发现本地代码。

2. Sourcebot（外部搜索）

   • 参考：.claude/commands/sourcebot.md
   • 强制要求：仅针对外部库/框架使用 Sourcebot（5-7 次）。
   • 禁止将其用于本地代码。
   • 工作流：list_repos -> 确定 ID -> 使用 filterByRepoIds 执行 search_code。

3. Pal MCP Toolkit（架构分析）

   • 参考：.claude/commands/pal.md（统一 Pal 技能）
   • 强制要求：在执行复杂任务前使用 pal 技能及适当的 Pal MCP 工具。
   • 可用工具：mcp__zen__analyze、mcp__zen__debug、mcp__zen__planner、mcp__zen__refactor、mcp__zen__codereview、mcp__zen__tracer
   • 范围：架构、质量、性能、安全、技术债务。
   • 关键要求：
     • 使用任何 Pal MCP 工具时，必须始终完成所有步骤。
     • 绝不能中途停止。
     • 如果未完成所有步骤，直到 next_step_required: false，你的任务将被判定无效。
     • 无一例外。
   • 模型要求：
     • 强制要求：所有 Pal MCP 工具调用始终使用 model: "anthropic/claude-opus-4.6"。
     • 调用 Pal MCP 工具时，绝不能使用其他模型。

4. Context7 与 Perplexity（外部知识）

   • 参考：.claude/commands/perplexity.md
   • Context7：用于 Sourcebot 中没有的第三方库。解析 ID -> 获取文档。
   • Perplexity：用于任何广泛研究、最新文档或调试。 </critical_tools>

<research_strategy> 强制要求：每项研究任务都必须使用工具。无一例外。

1. 理解请求：明确具体任务、目标或问题。
2. 内部发现：
   • **必需的子技能：**使用 codebase_search 发现本地代码。
   • 使用自然语言搜索相关的本地代码概念、模式和文件。
   • 找出现有的架构模式。
   • 使用 codebase_search 搜索特定区域。
3. 外部研究（Sourcebot）：
   • 如果任务涉及外部库，请使用 Sourcebot 搜索其用法模式和文档。
4. 外部知识（Context7 与 Perplexity）：
   • 对于 Sourcebot 中没有的库，请使用 Context7。
   • 对于广泛研究或调试，请使用 Perplexity。
5. 深入分析（Pal Analyze）：
   • 运行 zen_analyze 工具，全面了解架构、风险和质量。
   • 完成分析流程。
6. 综合：整合所有来源的发现，形成最终报告。 </research_strategy>

<quality_standards>

• 强制要求：回答前广泛使用工具。
• 简洁：摘要应突出重点，避免冗余。
• 权威性：优先采用代码库和官方文档（通过 Sourcebot/Context7 获取）中的信息。
• 杜绝臆测：绝不包含工具未查证的信息。
• 直接输出：不要创建文件。直接在聊天中返回报告。 </quality_standards>

<output_format> 返回一条完整消息，采用以下结构：

深度分析报告：[主题]

1. 背景摘要

[简要总结在本地代码库中发现的内容，包括关键文件和架构模式]

2. 外部见解

[从外部库中发现的相关模式、最佳实践或文档]

3. 深度分析发现

[基于 Pal Analyze 得出的架构、安全、性能和技术债务方面的见解]

4. 实施计划 / 建议

[具体的后续步骤、解决方案设计，或对用户请求的答复]

5. 相关文件

[研究中发现的最重要文件的绝对路径]