research

調査 - 詳細な調査

複数の情報源と AI による統合を組み合わせた、徹底的な調査です。

前提条件

• GitHub 検索用の gh CLI
• AI による統合用の gemini CLI

brew install gh
pip install google-generativeai
gh auth login
export GEMINI_API_KEY=your_api_key

調査操作

詳細調査

多角的な包括的調査です。

# Step 1: Gather information from multiple angles
TOPIC="your research topic"
OBJECTIVE="what you're trying to learn"

# 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"

クイック調査

簡単な質問に対する迅速な回答です。

gemini -m pro -o text -e "" "Quick research: [question]

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

テクノロジーの比較

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."

ライブラリの調査

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

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

# 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"

GitHub の Issue 検索

デバッグに役立つ関連 Issue を見つけます。

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

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

# Search with labels
gh search issues "[topic]" --label "bug" --state open

調査パターン

ライブラリを採用する前に

#!/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."

外部検索によるデバッグ

ERROR="your error message"

# Search for similar issues
gh search issues "$ERROR" --json repository,title,url,state --limit 10

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

# AI analysis of error
gemini -m pro -o text -e "" "Explain this error and likely causes: $ERROR"

アーキテクチャの調査

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"

最新情報の把握

# 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."

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

調査結果の統合

標準的な調査結果

## Executive Summary
- Key point 1
- Key point 2
- Key point 3

## Detailed Findings
### Finding 1
[Details and evidence]

### Finding 2
[Details and evidence]

## Critical Analysis
- What's contested or uncertain
- What biases might exist
- What's missing

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

比較結果

## Quick Verdict
[1-2 sentence recommendation]

## Detailed Comparison
| Criterion | Option A | Option B | Option C |
|-----------|----------|----------|----------|
| Performance | ... | ... | ... |
| Ease of use | ... | ... | ... |

## Recommendation
[Detailed reasoning]

ベストプラクティス

1. 目的を明確にする - どのような判断を下そうとしていますか？
2. 複数の情報源を使う - GitHub、ウェブ、AI による統合を活用します。
3. 情報の新しさを確認する - テクノロジーは急速に変化します。
4. 主張を検証する - AI は幻覚を起こすことがあるため、複数の情報源を照合します。
5. 価値のある調査結果を保存する - 今後参照できるよう、メモリに保存します。
6. 不足している点を追跡する - 不確かな点を調査します。