| name | tech-catchup-workflow |
| description | 対象技術の最新情報を調査し、技術調査レポートを作成する |
技術キャッチアップ・完全ワークフロー
対象技術に関する最新情報を調査し、技術調査レポートを作成する自動化ワークフローです。
基本設計フェーズ前に実行することで、技術選定の精度向上と設計ミスの予防を図ります。
使用モデル: Gemini 3 Flash（コスト効率重視）
入力
$ARGUMENTS（対象技術リスト、調査深度など）
入力形式
以下の形式で入力を受け付けます：
技術: [調査対象技術のリスト（カンマ区切り）]
深度: [quick/standard/deep]（省略時: standard）
要件: [要件定義書のパス（任意）]
目的: [調査の目的・背景（任意）]
入力例:
技術: Next.js 15, Prisma, TanStack Query v5
深度: standard
要件: docs/requirements/REQ-XXX-001_機能名.md
目的: 半年ぶりの技術更新、Breaking Changes確認
簡易入力（技術名のみ）:
React 19, Bun
調査深度の定義
| 深度 | 調査範囲 | 所要時間目安 | 成果物 |
|---|
| quick | 最新バージョン・Breaking Changesのみ | 5-10分 | 簡易レポート |
| standard | 上記 + 新機能・非推奨・マイグレーション + 実装向け情報 | 15-30分 | 標準レポート |
| deep | 上記 + ベストプラクティス・エコシステム動向・競合比較 | 30-60分 | 詳細レポート |
standard以上で含まれる実装向け情報
| 項目 | 内容 |
|---|
| インストール方法 | パッケージマネージャー別のインストールコマンド |
| 基本的な使い方 | 最小構成のコード例（コピペで動く） |
| 参照リンク集 | 公式ドキュメント、GitHub、APIリファレンス等 |
| よくあるエラーと対処 | 初期セットアップで躓きやすいポイント |
全体フロー
| Phase | 名称 | 内容 |
|---|
| 0 | 入力解析 | 技術リスト・深度・目的の解析 |
| 0.5 | コンテキスト確認 | 既存バージョン確認、重複調査防止 |
| 1 | 調査対象特定 | 優先度付け、スキップ判定 |
| 2 | 最新情報収集 | librarianエージェントによる調査 |
| 2.5 | ユーザー確認 | 調査結果の確認・承認 |
| 3 | レポート作成 | 技術調査レポート生成 |
| 4 | 引き継ぎ | 基本設計への引き継ぎ情報出力 |
Phase規約: workflow-phase-convention skill を参照
実行プロセス
Phase 0: 入力解析
入力引数から以下を抽出：
- 調査対象技術リスト
- 調査深度（quick/standard/deep）
- 要件定義書パス（任意）
- 調査目的（任意）
Phase 0.5: コンテキスト確認
実行内容:
- 既存プロジェクトの
package.json / Cargo.toml 等から現行バージョンを確認
- 直近30日以内に同一技術の調査レポートが存在するか確認
- 調査の重複を防止
スキップ条件:
- 直近30日以内に同一技術の調査レポートが存在 → ユーザーに確認
Phase 1: 調査対象の特定と優先度付け
実行内容:
- 入力から調査対象技術を抽出
- 要件定義書が指定されている場合、追加の技術キーワードを抽出
- 調査優先度を決定
優先度判定基準:
| 優先度 | 条件 | 例 |
|---|
| 高 | メジャーバージョン差あり | Next.js 13 → 15 |
| 高 | 未使用技術（新規導入） | 初めてのRust |
| 中 | マイナーバージョン差あり | React 18.2 → 18.3 |
| 中 | 1年以上触れていない | 久しぶりのDocker |
| 低 | 現行最新、日常的に使用 | 毎日使うTypeScript |
スキップ条件:
- 全技術が「低」優先度 かつ ユーザーが明示的にスキップを許可
Phase 2: 最新情報収集
librarianエージェントを起動して調査（深度に応じた情報を収集）:
実装方法:
call_omo_agent でバックグラウンド実行- 使用ツール:
websearch_exa, context7_query-docs
⚠️ 制約（調査深度による差分）:
- quick: 公式サイトのメタデータ（バージョン、日付、URL）のみ取得
- standard以上: インストール手順・基本的な使い方・コード例も調査
- リポジトリへのダウンロード・ビルドは一切行わない
-
基本情報確認
- 最新バージョン番号とリリース日
- 公式ドキュメントURL
- 概要（1-2行）
-
詳細調査（standard以上で実施）
- インストールコマンド（npm/yarn/pnpm等）
- 基本的な使い方（最小構成のコード例）
- マイグレーションガイド（メジャーバージョン差がある場合）
- よくあるエラーと対処法
調査ソース:
- 公式ドキュメント（最優先）
- GitHub Releases / Changelog
- 公式ブログ
- RFC / Proposal（deep のみ）
- 公式Getting Started / Quickstart（standard以上）
- 公式Examples / Tutorials（standard以上）
Phase 2.5: ユーザー確認
調査結果のサマリーを提示し、承認を得る。
共通仕様: approval-gate skill を参照
| 選択肢 | アクション |
|---|
1 | Phase 3（レポート作成）へ |
2 | 追加の技術を指定して Phase 2 に戻る |
3 | 調査を中止 |
番号を選択してください（1-3）:
Phase 3: 技術調査レポート作成
出力先:
- 単体調査時:
docs/research/TECH-[カテゴリ]-[連番]_[技術名].md
- 複数調査時:
docs/research/TECH-REPORT-[YYYYMMDD]_Combined.md（統合レポート）
Note: 大量ファイル生成を防ぐため、複数技術の調査時は1つのMarkdownファイルに統合します。
カテゴリ定義:
| カテゴリ | 対象 |
|---|
| FE | フロントエンドフレームワーク・ライブラリ |
| BE | バックエンドフレームワーク・ライブラリ |
| DB | データベース・ORM |
| INFRA | インフラ・DevOps・コンテナ |
| LANG | プログラミング言語・ランタイム |
| TOOL | 開発ツール・ビルドツール |
レポート構成（standard以上）:
# 技術調査レポート: [技術名]
| 項目 | 内容 |
|------|------|
| 調査日 | YYYY-MM-DD |
| 最新バージョン | vX.Y.Z |
| 調査深度 | standard / deep |
## 参照リンク（公式）
- **公式ドキュメント**: [URL]
- **GitHubリポジトリ**: [URL]
- **Getting Started**: [URL]
## 技術概要
[1-2行で記載]
## インストール方法
### npm
```bash
npm install [package-name]
yarn
yarn add [package-name]
pnpm
pnpm add [package-name]
基本的な使い方
最小構成例
主要なAPI/関数
よくあるエラーと対処
| エラー | 原因 | 対処法 |
|---|
| Error: xxx | 原因の説明 | 対処法 |
メモ
[必要に応じて追記]
**レポート構成（quick - 参照インデックス版）:**
```markdown
# 技術調査レポート: [技術名]
| 項目 | 内容 |
|------|------|
| 調査日 | YYYY-MM-DD |
| 最新バージョン | vX.Y.Z |
## 参照リンク（公式）
- **公式ドキュメント**: [URL]
- **GitHubリポジトリ**: [URL]
## 技術概要
[LLMの知識ベースに基づいて1-2行で記載]
## メモ
[必要に応じて追記]
Phase 4: 基本設計への引き継ぎ
実行内容:
-
完了報告の生成
- 調査結果一覧（技術名、現行→最新、影響度）
- 実装クイックリファレンス（インストールコマンド、リンク集）
- 成果物パス一覧
-
次ステップの案内
/basic-design-workflow の実行を促す
サーキットブレーカー
| 条件 | アクション |
|---|
| 公式ドキュメントにアクセス不可 | 代替ソース使用 + 警告表示 |
| 情報が古い可能性あり | ⚠️ 要確認 マークを付与 |
| 調査時間超過（deep: 90分以上） | 中間レポート出力して終了 |
最終出力
## 技術キャッチアップ完了報告
### 実行サマリー
| 項目 | 内容 |
|------|------|
| 調査技術数 | X件 |
| 調査深度 | standard |
| 所要時間 | XX分 |
### 調査結果一覧
| 技術 | 現行 | 最新 | 影響度 | レポート |
|------|------|------|--------|---------|
| Next.js | 14.0.0 | 15.1.0 | 🔴 高 | [リンク] |
| Prisma | 5.0.0 | 5.5.0 | 🟡 中 | [リンク] |
| TanStack Query | v4 | v5 | 🔴 高 | [リンク] |
### 実装クイックリファレンス
| 技術 | インストール | 公式ドキュメント | GitHub |
|------|-------------|-----------------|--------|
| Next.js | `npm install next`15` skill` | [nextjs.org/docs](URL) | [vercel/next.js](URL) |
| Prisma | `npm install prisma` | [prisma.io/docs](URL) | [prisma/prisma](URL) |
| TanStack Query | `npm install `tanstack` skill/react-query` | [tanstack.com/query](URL) | [TanStack/query](URL) |
### 設計への影響サマリー
#### 🚨 必須対応（基本設計前に決定必要）
1. **Next.js 15**: App Router完全移行が必要。Pages Router非推奨
2. **TanStack Query v5**: API大幅変更。既存コード要修正
#### ⚠️ 注意事項
- Prisma 5.5: 新しいクエリエンジン。パフォーマンステスト推奨
#### 未解決課題
| ID | 課題 | 対応方針 |
|----|------|---------|
| I-XXX | Next.js 14→15移行戦略 | 基本設計で決定 |
### 成果物
- docs/research/TECH-FE-001_Next.js.md
- docs/research/TECH-BE-002_Prisma.md
- docs/research/TECH-FE-003_TanStack-Query.md
### 次のステップを選択してください
1. 基本設計に進む（`/basic-design-workflow`）
2. 技術調査レポートを確認・修正する
3. 一旦終了する
> 番号を選択してください（1-3）:
エラーハンドリング
| 状況 | 対処法 |
|---|
| 技術名が曖昧 | 候補を提示してユーザーに確認 |
| 公式ドキュメントなし | GitHub / npm / crates.io から情報収集 |
| バージョン情報取得失敗 | 手動入力を依頼 |
| 深度「deep」で時間超過 | 中間成果を保存して続行オプション提示 |
Sisyphusへの指示
使用ツール
call_omo_agent(subagent_type='librarian'): 外部ドキュメント調査（バックグラウンド実行）websearch_exa: Web検索context7_query-docs: ライブラリドキュメント検索
処理フロー
-
Phase 0.5: コンテキスト確認
package.json, Cargo.toml 等から現在のバージョン確認docs/research/TECH-*.md で直近30日以内の調査レポート確認- 調査済みの場合はスキップ候補としてユーザーに確認
-
Phase 1: 調査対象の特定
- 引数から技術リストを抽出
- 要件定義書パスがあれば技術キーワードを追加抽出
- 既存調査済み技術を除外して優先度付け
-
Phase 2: 情報収集（librarian エージェント使用）
- 調査深度に応じた収集項目:
- quick: バージョン、ドキュメントURL、GitHub URL のみ
- standard: + インストールコマンド、コード例、主要API、エラー対処
- deep: + ベストプラクティス、エコシステム、競合比較
- タイムアウト: quick=15分, standard=45分, deep=90分
- タイムアウト時は中間レポートを出力
-
Phase 3: レポート作成
- 複数技術 →
docs/research/TECH-REPORT-{date}_Combined.md
- 単体技術 →
docs/research/TECH-{category}-{id}_{name}.md
-
Phase 4: 完了報告
関連ドキュメント
- 前工程:
/req-workflow（要件定義）
- 次工程:
/basic-design-workflow（基本設計）
- 参照:
.opencode/README.md（ワークフロー全体図）
参照スキル
| スキル | 用途 |
|---|
workflow-phase-convention skill | Phase番号体系・承認ゲート規約 |
approval-gate skill | ユーザー承認ゲートの共通フォーマット |
Phase規約: workflow-phase-convention skill を参照
