AgentSkillsCN

gap-analysis

当用户请求“分析实施差距”、“评估可行性”、“评估代码库兼容性”、“比较需求与现有代码”或“规划实施路径”时，此功能将大显身手。它通过分析需求与现有代码库之间的差距，为实施策略提供有力参考。

SKILL.md
--- frontmatter
name: gap-analysis
description: This skill should be used when the user asks to "analyze implementation gap", "evaluate feasibility", "assess codebase compatibility", "compare requirements with existing code", or "plan implementation approach". Analyzes gaps between requirements and existing codebase to inform implementation strategy.
version: 1.0.0

Gap Analysis Skill

要件と既存コードベースのギャップを分析し、実装戦略を策定するスキル。 既存プロジェクトへの機能追加、リファクタリング計画策定に使用する。

前提条件

条件必須説明
docs/requirements/user-stories.md○分析対象の要件（web-requirements 出力）
既存ソースコード○ギャップ分析対象

出力ファイル

ファイルテンプレート説明
docs/00_analysis/gap_analysis.md{baseDir}/references/gap_analysis.mdギャップ分析結果

依存関係

種別対象
前提スキルweb-requirements
後続スキルarchitecture-skeleton, design-inventory

ワークフロー

code
1. 要件ドキュメント読み込み
2. 現状調査（Current State Investigation）
   - ディレクトリ構造・主要モジュール分析
   - 再利用可能なコンポーネント特定
   - アーキテクチャパターン・制約把握
   - 統合ポイント（データモデル、API、認証）特定
3. 要件実現可能性分析（Requirements Feasibility Analysis）
   - 技術要件の抽出（データモデル、API、UI、ビジネスルール）
   - ギャップ・制約の特定
   - 複雑性シグナルの評価
4. 実装アプローチ検討（Implementation Approach Options）
   - Option A: 既存コンポーネント拡張
   - Option B: 新規コンポーネント作成
   - Option C: ハイブリッドアプローチ
5. 複雑性・リスク評価
6. 推奨事項まとめ

分析フレームワーク

現状調査項目

調査項目内容
ドメイン関連資産主要ファイル/モジュール、ディレクトリ構成
規約命名規則、レイヤリング、依存方向
統合ポイントデータモデル/スキーマ、APIクライアント、認証機構

実装アプローチ評価

Option A: 既存コンポーネント拡張

評価項目内容
対象ファイル変更が必要なファイル特定
互換性既存インターフェースとの整合性
複雑性認知負荷、単一責任原則の維持

Trade-offs:

  • •新規ファイル最小限、既存パターン活用
  • •既存コンポーネント肥大化リスク

Option B: 新規コンポーネント作成

評価項目内容
作成理由責務分離、既存の複雑性、独立ライフサイクル
統合ポイント既存システムとの接続方法
責務境界新規コンポーネントの所有範囲

Trade-offs:

  • •クリーンな責務分離、テスト容易性
  • •ファイル増加、インターフェース設計必要

Option C: ハイブリッドアプローチ

評価項目内容
組み合わせ戦略拡張部分と新規部分の分担
フェーズ分け段階的実装計画
リスク軽減インクリメンタルロールアウト、Feature Flag

複雑性・リスク評価

工数（Effort）

レベル目安条件
S1-3日既存パターン、最小依存、単純統合
M3-7日新パターン/統合あり、中程度複雑性
L1-2週大きな機能、複数統合/ワークフロー
XL2週以上アーキテクチャ変更、未知技術、広範影響

リスク（Risk）

レベル条件
High未知技術、複雑な統合、アーキテクチャ変更、不明確なパフォーマンス/セキュリティ
Mediumガイダンス付き新パターン、管理可能な統合、既知のパフォーマンス解決策
Low確立パターンの拡張、馴染みの技術、明確なスコープ、最小統合

ツール

ツール用途
Grepコードベース内パターン検索
Globファイル構造調査
Readファイル内容分析
WebSearch外部依存調査（必要時）
WebFetchドキュメント参照（必要時）

原則

原則説明
情報提供優先決定ではなく分析とオプションを提供
複数オプション実現可能な複数の選択肢を提示
明示的なギャップ不明点と制約を明確にフラグ
コンテキスト考慮既存パターンとアーキテクチャ制限に沿う
透明な見積り工数とリスクを簡潔に根拠付け

エラーハンドリング

エラー対応
要件不在requirements スキルの実行を促す
ソースコードなし対象ディレクトリ確認を促す
複雑な統合が不明確"Research Needed" としてフラグ、設計フェーズで詳細調査

SendMessage 完了報告

タスク完了時に以下の YAML 形式で Lead に SendMessage を送信する:

yaml
status: ok
severity: null
artifacts:
  - docs/00_analysis/gap_analysis.md
contract_outputs:
  - key: analysis.effort
    value: S/M/L/XL
  - key: analysis.risk
    value: High/Medium/Low
  - key: analysis.recommended_approach
    value: A/B/C
open_questions: []
blockers: []

注意: project-context.yaml には直接書き込まない（Aggregator の責務）。