| name | task-analyzer |
| description | メタ認知的タスク分析とスキル選択。タスクの本質を分析し、規模を見積もり、適切なスキルをメタデータと共に返却。 |
タスクアナライザー
メタ認知的タスク分析とスキル選択ガイダンスを提供。
スキルインデックス
利用可能なスキルのメタデータは skills-index.yaml を参照。
タスク分析プロセス
1. タスク本質の理解
表面的な作業を超えた根本目的を特定:
| 表面的な作業 | 根本目的 |
|---|---|
| 「このバグを直して」 | 問題解決、根本原因分析 |
| 「この機能を実装して」 | 機能追加、価値提供 |
| 「このコードをリファクタリングして」 | 品質改善、保守性向上 |
| 「このファイルを更新して」 | 変更管理、一貫性確保 |
キーとなる質問:
- 本当に解決しようとしている問題は何か?
- 期待される成果は何か?
- 表面的にアプローチした場合、何が問題になり得るか?
2. タスク規模の見積もり
| 規模 | ファイル数 | 指標 |
|---|---|---|
| 小規模 | 1-2 | 単一の関数/コンポーネントの変更 |
| 中規模 | 3-5 | 複数の関連コンポーネント |
| 大規模 | 6以上 | 横断的関心事、アーキテクチャへの影響 |
規模がスキル優先度に影響:
- 大規模 → プロセス/ドキュメントスキルがより重要
- 小規模 → 実装スキルに集中
3. タスクタイプの特定
| タイプ | 特徴 | キースキル |
|---|---|---|
| 実装 | 新規コード、機能 | coding-standards, typescript-testing |
| 修正 | バグ解決 | coding-standards, typescript-testing |
| リファクタリング | 構造改善 | coding-standards, implementation-approach |
| 設計 | アーキテクチャ決定 | documentation-criteria, implementation-approach |
| 品質 | テスト、レビュー | typescript-testing, integration-e2e-testing |
4. タグベースのスキルマッチング
タスク説明から関連タグを抽出し、skills-index.yamlとマッチング:
Task: "Implement user authentication with tests"
Extracted tags: [implementation, testing, security]
Matched skills:
- coding-standards (implementation, security)
- typescript-testing (testing)
- typescript-rules (implementation)
5. 暗黙的な関連性
隠れた依存関係を考慮:
| タスクに含まれる | 追加で含める |
|---|---|
| エラーハンドリング | デバッグ、テスト |
| 新機能 | 設計、実装、ドキュメント |
| パフォーマンス | プロファイリング、最適化、テスト |
| フロントエンド | typescript-rules, typescript-testing |
| API/統合 | integration-e2e-testing |
出力形式
skills-index.yamlからのスキルメタデータを含む構造化された分析を返却:
taskAnalysis:
essence: <string> # 特定された根本目的
type: <implementation|fix|refactoring|design|quality>
scale: <small|medium|large>
estimatedFiles: <number>
tags: [<string>, ...] # タスク説明から抽出
selectedSkills:
- skill: <skill-name> # skills-index.yamlから
priority: <high|medium|low>
reason: <string> # このスキルが選択された理由
# skills-index.yamlからメタデータを引き継ぐ
tags: [...]
typical-use: <string>
size: <small|medium|large>
sections: [...] # yamlからの全セクション(フィルタなし)
注意: セクション選択(どのセクションが関連するかの選定)は、実際のSKILL.mdファイルを読み込んだ後に別途行う。
スキル選択の優先順位
- 必須 - タスクタイプに直接関連
- 品質 - テストと品質保証
- プロセス - ワークフローとドキュメント
- 補助 - リファレンスとベストプラクティス
メタ認知質問の設計
タスクの性質に応じて3-5個の質問を生成:
| タスクタイプ | 質問の焦点 |
|---|---|
| 実装 | 設計の妥当性、エッジケース、パフォーマンス |
| 修正 | 根本原因(5 Whys)、影響範囲、回帰テスト |
| リファクタリング | 現状の問題、目標状態、段階的計画 |
| 設計 | 要件の明確性、将来の拡張性、トレードオフ |
警告パターン
これらのパターンを検出してフラグを立てる:
| パターン | 警告 | 緩和策 |
|---|---|---|
| 一度に大規模変更 | 高リスク | フェーズに分割 |
| テストなしの実装 | 品質リスク | TDDに従う |
| エラー発見時の即座の修正 | 根本原因の見落とし | 一時停止、分析 |
| 計画なしのコーディング | スコープクリープ | まず計画 |