task-analyzer

タスクの本質を分析し適切なスキルを選択。規模見積もりとメタデータを返却。タスク開始時、スキル選択時に使用。

$ 安裝

git clone https://github.com/shinpr/ai-coding-project-boilerplate /tmp/ai-coding-project-boilerplate && cp -r /tmp/ai-coding-project-boilerplate/.claude/skills-ja/task-analyzer ~/.claude/skills/ai-coding-project-boilerplate

// tip: Run this command in your terminal to install the skill


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ファイルを読み込んだ後に別途行う。

スキル選択の優先順位

  1. 必須 - タスクタイプに直接関連
  2. 品質 - テストと品質保証
  3. プロセス - ワークフローとドキュメント
  4. 補助 - リファレンスとベストプラクティス

メタ認知質問の設計

タスクの性質に応じて3-5個の質問を生成:

タスクタイプ質問の焦点
実装設計の妥当性、エッジケース、パフォーマンス
修正根本原因(5 Whys)、影響範囲、回帰テスト
リファクタリング現状の問題、目標状態、段階的計画
設計要件の明確性、将来の拡張性、トレードオフ

警告パターン

これらのパターンを検出してフラグを立てる:

パターン警告緩和策
一度に大規模変更高リスクフェーズに分割
テストなしの実装品質リスクTDDに従う
エラー発見時の即座の修正根本原因の見落とし一時停止、分析
計画なしのコーディングスコープクリープまず計画