第5章

知識管理と蓄積

ナレッジベース、ドキュメント体系、蓄積メカニズムを整備し、チームの知識資産が継続的に蓄積・再利用され、重複作業を避けられるようにします。

ナレッジベース構築

Skillライブラリ、Patternsライブラリ、ベストプラクティスライブラリは、チームの中核となる知識資産です。

Skill ライブラリ管理

.cursor/skills/
ディレクトリ構造:プロジェクト/技術スタック別に分類
  • 命名規則:`project-name-skill-name.md`
  • バージョン管理:Gitで管理し、ロールバックをサポート
  • 使用統計:Skill の使用頻度を追跡する
  • 品質評価:定期的に Skill の効果を評価し、改善を最適化する

Patterns ライブラリ管理

fabric/patterns/
Fabric Patterns:チーム共有の Patterns ディレクトリ
  • 分類管理:タスクの種類ごとに分類(コード生成/コードレビュー/ドキュメント生成)
  • 品質評価:Patterns の効果評価と最適化
  • 貢献メカニズム:チームメンバーに Patterns への貢献を促す
  • 使用文档:各 Pattern には使用説明と例があります

ベストプラクティスライブラリ

  • ツール使用のベストプラクティス:Cursor、Windsurf、Fabric の使い方のコツ
  • Prompt エンジニアリングのベストプラクティス:RTCC フレームワーク、CoT、Few-Shot などのテクニック
  • コードレビューのベストプラクティス:チェックリスト、フィードバックテンプレート、レビュープロセス
  • ケースライブラリ:成功事例/失敗事例、経験から得た教訓のまとめ

文書体系

技術ドキュメント、業務プロセス文書、研修ドキュメントの完全な体系を構築する。

技術文書

  • • ツール使用マニュアル(Cursor/Windsurf/Fabric)
  • • 設定ガイド(MCP/Skill/Patterns)
  • • トラブルシューティングマニュアル
  • • API ドキュメント

プロセス文書

  • • 開発フロー文書
  • • コードレビューのプロセス
  • • デプロイ手順ドキュメント
  • • 部門横断の協働プロセス

研修資料

  • • 新人向け onboarding ドキュメント
  • • ツールのトレーニング資料
  • • 実戦ケースドキュメント
  • • 学習パスガイド

知識蓄積の仕組み

定期的なまとめと事例の蓄積メカニズムを構築し、知識が継続的に蓄積・最適化されるようにする。

定期的にまとめる

毎週のまとめ
  • • ツール使用の心得
  • • 発生した問題
  • • ソリューション
月次サマリー
  • • ベストプラクティス
  • • ツール更新
  • • チーム効率の向上
四半期ごとのまとめ
  • • ナレッジベースの最適化
  • • プロセス改善
  • • チームの能力向上

事例の蓄積

成功事例
  • • AI ツールの使用に成功したプロジェクトを記録する
  • • 成功要因を分析する
  • • 再利用可能な経験を抽出する
失敗事例
  • • 問題と解決策を記録する
  • • 失敗の原因を分析する
  • • 同じミスを繰り返さない
経験共有
  • • チームメンバーの経験共有
  • • ツールの使いこなし
  • • ベストプラクティスのまとめ

実践演習

練習の提案:

  • 1チームの Skill ライブラリを構築する(ディレクトリ構造、命名規則、バージョン管理を作成する)
  • 2Patterns ライブラリを作成する(カテゴリ管理、品質評価、貢献メカニズム)
  • 3知識管理プラットフォームを設計する(ドキュメント体系、検索機能、バージョン管理)

学習成果

この章を終えると、あなたは:

  • 1ナレッジベース構築手法を習得する(Skill ライブラリ、Patterns ライブラリ、ベストプラクティスライブラリ)
  • 2文書体系を構築できる(技術文書、手順書、研修文書)
  • 3知識の蓄積の重要性を理解する(定期的なまとめ、事例の蓄積、経験の共有)