Oss Survey

OSS Survey

Overview

このskillは、OSS（オープンソースソフトウェア）やツールの概要調査を体系的に実施し、構造化されたMarkdownレポートを生成する。調査範囲は基本的な情報に絞り、プロジェクトの理解と評価に必要な情報を効率的に収集する。

When to Use

このskillは以下の状況で使用する：

• ユーザーが特定のOSS/ツールについて「概要調査」「調査」「情報収集」を依頼した場合
• ツールの基本情報、技術スタック、主要機能を知りたい場合
• 競合ツールとの比較情報が必要な場合
• ツールの制約や限界を理解したい場合
• 日本語サポート状況を確認したい場合

Survey Workflow

Step 1: 調査の開始

ユーザーから調査対象のOSS/ツール名を受け取ったら、確認なしで即座に調査を開始する。

標準調査項目（すべて実施）:

1. 概要（プロジェクト基本情報、技術概要）
2. 機能と競合比較（主要機能、対抗馬、Googleトレンド、制約）
3. 想定Q&A
4. 参考情報（公式ドキュメント、学習リソース、関連リンク）

標準的な目次構造:

# [ツール名] 概要調査

## 概要
### プロジェクト基本情報
### 技術概要

## 機能と競合比較
### 主要機能
### 対抗馬と比較
### Googleトレンド比較
### 制約・できないこと

## 想定Q&A

## 参考情報
### 公式ドキュメント
### 学習リソース
### 関連リンク

除外される項目（明示的な要求がない限り）:

• ライセンス情報
• Stars数、フォーク数
• 最新バージョン
• オープンIssue/PR数
• 採用事例
• パフォーマンスベンチマーク
• 導入方法の詳細手順

注意: ユーザーが特定の項目のみを調査してほしい場合や、追加の調査項目がある場合は、その指示に従う。

Step 2: 情報収集

標準の目次構造に基づいて情報を収集する。

情報源:

• WebSearch: 一般的な情報、比較記事、技術記事
• WebFetch: 公式サイト、GitHubリポジトリ
• mcp__brave-search__bravewebsearch: 補完的な検索
• mcp__github__*: GitHubの詳細情報（必要に応じて）

収集する情報:

1. プロジェクト基本情報:

• プロジェクト名
• 説明（1-2文で簡潔に）
• GitHubリポジトリURL
• 公式サイトURL

1. 技術概要:

• 主要言語
• フレームワーク・ビルドツール
• 日本語サポート状況（UI/コンテンツ、検索、公式ドキュメント）

1. 機能と競合比較:

• 主要機能（コア機能のリスト）
• 対抗馬となるツール（3-5個程度）
• 各ツールとの比較ポイント
• 差別化ポイント
• Googleトレンド比較URL
• 制約・できないこと

1. 想定Q&A:

• 典型的な質問7個程度
• 用途、選択基準、移行、パフォーマンス、実績、制約対処、日本語対応など

1. 参考情報:

• 公式ドキュメントURL
• 学習リソース（クイックスタート、サンプル、ディスカッションなど）
• 関連リンク（公式リソース、コミュニティ、比較記事、技術記事）

重要な原則:

• すべての情報に参考URL（根拠となるURL）を付与する
• 情報が見つからない場合は、その旨を明記する
• 推測や不確実な情報は避ける

Step 3: レポート生成

収集した情報を基に、Markdown形式のレポートを生成する。

フォーマット規則:

1. 見出し:

• レベル1（#）: タイトル
• レベル2（##）: 大見出し
• レベル3（###）: 中見出し
• 見出しに番号は付けない

1. 箇条書き:

• すべての情報を箇条書きで記載
• 太字（**）で項目名を強調
• 参考URLはインデントして「- 参考: [URL]」形式で記載

1. Q&A形式:

```markdown

• Q1: 質問内容
• A1: 回答内容

• Q2: 質問内容
• A2: 回答内容

```

1. 日本語サポート表記:

• ✅ 対応
• ⚠️ 制約あり
• ❌ 未対応/未提供

1. ファイル保存:

• ファイル名: [ツール名]-概要調査.md
• 保存先: ユーザーが指定（指定がなければカレントディレクトリ）

Step 4: ユーザー確認とイテレーション

レポート生成後、ユーザーからの修正依頼に対応する：

• 構造の調整（セクションの統合、移動、削除）
• フォーマットの変更
• 追加調査
• 情報の精査

Resources

references/survey-structure.md

レポートの標準的な構造とテンプレートを定義したリファレンスファイル。以下の情報を含む：

• 完全なMarkdownテンプレート
• 各セクションの記載内容
• 除外する項目のリスト
• 日本語サポート調査のポイント
• 想定Q&Aの作成ガイドライン
• 出力フォーマットの詳細

このファイルは必要に応じて参照し、レポート構造の一貫性を保つために使用する。

Best Practices

1. 即座に実行: 調査対象を受け取ったら確認なしで標準調査を開始する
2. 根拠の明示: すべての情報に参考URLを付与し、情報の出典を明確にする
3. 簡潔さ: 基本的な概要調査に徹し、詳細すぎる情報は避ける
4. 構造化: 一貫した構造とフォーマットを維持する
5. 柔軟性: ユーザーの要望に応じて調査項目や構造を調整する
6. 日本語重視: 日本語サポート状況は必ず確認する（特に検索機能）

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: taktamur
• Source: taktamur/claude-code-skills
• License: CC0-1.0

Install and usage instructions live in the source repository linked above.