Back to Details

research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Research - Deep Investigation

研究 - 深度调研

Thorough research combining multiple sources and AI synthesis.
整合多源信息与AI合成的深度调研方法。

Prerequisites

前置条件

  • gh
    CLI for GitHub searches
  • gemini
    CLI for AI synthesis
bash
brew install gh
pip install google-generativeai
gh auth login
export GEMINI_API_KEY=your_api_key
  • 用于GitHub搜索的
    gh
    CLI
  • 用于AI合成的
    gemini
    CLI
bash
brew install gh
pip install google-generativeai
gh auth login
export GEMINI_API_KEY=your_api_key

Research Operations

调研操作

Deep Research

深度调研

Comprehensive multi-angle investigation:
bash
undefined
全方位多角度调研：
bash
undefined

Step 1: Gather information from multiple angles

Step 1: Gather information from multiple angles

TOPIC="your research topic" OBJECTIVE="what you're trying to learn"
TOPIC="your research topic" OBJECTIVE="what you're trying to learn"

Web search synthesis

Web search synthesis

gemini -m pro -o text -e "" "Research '$TOPIC' comprehensively.
OBJECTIVE: $OBJECTIVE
Provide:
  1. Executive summary (3-5 bullet points)
  2. Key findings with sources
  3. Different perspectives and debates
  4. Knowledge gaps and uncertainties
  5. Actionable recommendations"
undefined
gemini -m pro -o text -e "" "Research '$TOPIC' comprehensively.
OBJECTIVE: $OBJECTIVE
Provide:
  1. Executive summary (3-5 bullet points)
  2. Key findings with sources
  3. Different perspectives and debates
  4. Knowledge gaps and uncertainties
  5. Actionable recommendations"
undefined

Quick Research

快速调研

Fast answers for straightforward questions:
bash
gemini -m pro -o text -e "" "Quick research: [question]

Provide:
- Direct answer
- Key facts
- Important caveats
- Actionable next step"
针对简单问题的快速解答：
bash
gemini -m pro -o text -e "" "Quick research: [question]

Provide:
- Direct answer
- Key facts
- Important caveats
- Actionable next step"

Technology Comparison

技术对比

bash
gemini -m pro -o text -e "" "Compare these technologies for [use case]:

CANDIDATES:
1. [Tech A]
2. [Tech B]
3. [Tech C]

CRITERIA:
- Performance
- Learning curve
- Community/ecosystem
- Maintenance burden
- Production readiness

Include real-world adoption examples and common pitfalls."
bash
gemini -m pro -o text -e "" "Compare these technologies for [use case]:

CANDIDATES:
1. [Tech A]
2. [Tech B]
3. [Tech C]

CRITERIA:
- Performance
- Learning curve
- Community/ecosystem
- Maintenance burden
- Production readiness

Include real-world adoption examples and common pitfalls."

Library Investigation

类库调研

bash
undefined
bash
undefined

GitHub search for the library

GitHub search for the library

gh search repos "[library name]" --json fullName,description,stargazersCount,updatedAt --limit 5
gh search repos "[library name]" --json fullName,description,stargazersCount,updatedAt --limit 5

Check issues

Check issues

gh search issues "[library] bug" --json title,url,state --limit 10
gh search issues "[library] bug" --json title,url,state --limit 10

AI analysis

AI analysis

gemini -m pro -o text -e "" "Evaluate [library] for production use:
  1. Maturity and stability
  2. Maintenance status
  3. Common issues
  4. Alternatives to consider
  5. Recommendation"
undefined
gemini -m pro -o text -e "" "Evaluate [library] for production use:
  1. Maturity and stability
  2. Maintenance status
  3. Common issues
  4. Alternatives to consider
  5. Recommendation"
undefined

GitHub Issues Search

GitHub Issues搜索

Find related issues for debugging:
bash
undefined
查找与调试相关的Issues：
bash
undefined

Search GitHub issues

Search GitHub issues

gh search issues "[error message]" --json repository,title,url,state --limit 20
gh search issues "[error message]" --json repository,title,url,state --limit 20

Search in specific repo

Search in specific repo

gh search issues "[error]" --repo owner/repo --json title,url,state
gh search issues "[error]" --repo owner/repo --json title,url,state

Search with labels

Search with labels

gh search issues "[topic]" --label "bug" --state open
undefined
gh search issues "[topic]" --label "bug" --state open
undefined

Research Patterns

调研模式

Before Adopting a Library

类库选型前调研

bash
#!/bin/bash
LIB="$1"

echo "=== GitHub Presence ==="
gh search repos "$LIB" --json fullName,stargazersCount,updatedAt --limit 3

echo ""
echo "=== Open Issues ==="
gh search issues "$LIB bug" --state open --json title,url --limit 5

echo ""
echo "=== AI Evaluation ==="
gemini -m pro -o text -e "" "Should I use $LIB in production? Consider maintenance, alternatives, and common issues."
bash
#!/bin/bash
LIB="$1"

echo "=== GitHub Presence ==="
gh search repos "$LIB" --json fullName,stargazersCount,updatedAt --limit 3

echo ""
echo "=== Open Issues ==="
gh search issues "$LIB bug" --state open --json title,url --limit 5

echo ""
echo "=== AI Evaluation ==="
gemini -m pro -o text -e "" "Should I use $LIB in production? Consider maintenance, alternatives, and common issues."

Debugging with External Search

结合外部搜索调试

bash
ERROR="your error message"
bash
ERROR="your error message"

Search for similar issues

Search for similar issues

gh search issues "$ERROR" --json repository,title,url,state --limit 10
gh search issues "$ERROR" --json repository,title,url,state --limit 10

Search discussions

Search discussions

gh search issues "$ERROR" type:discussion --limit 5
gh search issues "$ERROR" type:discussion --limit 5

AI analysis of error

AI analysis of error

gemini -m pro -o text -e "" "Explain this error and likely causes: $ERROR"
undefined
gemini -m pro -o text -e "" "Explain this error and likely causes: $ERROR"
undefined

Architectural Research

架构调研

bash
gemini -m pro -o text -e "" "Research best practices for: [architecture topic]

Specifically:
1. What do industry leaders (FAANG, etc.) do?
2. What are the tradeoffs?
3. Common mistakes to avoid
4. When to use vs. when to avoid
5. Concrete implementation guidance"
bash
gemini -m pro -o text -e "" "Research best practices for: [architecture topic]

Specifically:
1. What do industry leaders (FAANG, etc.) do?
2. What are the tradeoffs?
3. Common mistakes to avoid
4. When to use vs. when to avoid
5. Concrete implementation guidance"

Staying Current

跟踪技术动态

bash
undefined
bash
undefined

Recent news on a topic

Recent news on a topic

gemini -m pro -o text -e "" "What are the latest developments in [technology] as of 2024? Include version updates, new features, and ecosystem changes."
gemini -m pro -o text -e "" "What are the latest developments in [technology] as of 2024? Include version updates, new features, and ecosystem changes."

Recent GitHub activity

Recent GitHub activity

gh search repos "[technology]" --created ">2024-01-01" --sort stars --json fullName,description,stargazersCount --limit 10
undefined
gh search repos "[technology]" --created ">2024-01-01" --sort stars --json fullName,description,stargazersCount --limit 10
undefined

Output Synthesis

输出整合

Standard Research Output

标准调研输出

undefined
undefined

Executive Summary

Executive Summary

  • Key point 1
  • Key point 2
  • Key point 3
  • Key point 1
  • Key point 2
  • Key point 3

Detailed Findings

Detailed Findings

Finding 1

Finding 1

[Details and evidence]
[Details and evidence]

Finding 2

Finding 2

[Details and evidence]
[Details and evidence]

Critical Analysis

Critical Analysis

  • What's contested or uncertain
  • What biases might exist
  • What's missing
  • What's contested or uncertain
  • What biases might exist
  • What's missing

Recommendations

Recommendations

  1. Immediate action
  2. Further investigation needed
  3. Decisions to make
undefined
  1. Immediate action
  2. Further investigation needed
  3. Decisions to make
undefined

Comparison Output

对比输出

undefined
undefined

Quick Verdict

Quick Verdict

[1-2 sentence recommendation]
[1-2 sentence recommendation]

Detailed Comparison

Detailed Comparison

CriterionOption AOption BOption C
Performance.........
Ease of use.........
CriterionOption AOption BOption C
Performance.........
Ease of use.........

Recommendation

Recommendation

[Detailed reasoning]
undefined
[Detailed reasoning]
undefined

Best Practices

最佳实践

  1. State objective clearly - What decision are you trying to make?
  2. Use multiple sources - GitHub + web + AI synthesis
  3. Check recency - Technology changes quickly
  4. Verify claims - AI can hallucinate; cross-reference
  5. Save valuable research - Store in memory for future reference
  6. Follow up gaps - Research what's uncertain
  1. 明确目标 - 你需要做出什么决策？
  2. 多源验证 - GitHub + 网页 + AI合成
  3. 时效性检查 - 技术迭代速度快
  4. 验证结论 - AI可能产生幻觉，需交叉验证
  5. 保存调研成果 - 留存信息以备后续参考
  6. 填补知识空白 - 针对不确定内容进一步调研