Agent skill

lorepedia-knowledge

バグ修正・エラー解消・技術的知見を自動記録するスキル。デバッグで発見したインサイト、実装上のハマりポイント、設定の回避策などをExocortexに保存し、将来の同様の問題解決を効率化する。プロジェクト固有でなくても、汎用的な技術知見も記録対象。

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/lorepedia-knowledge

SKILL.md

Knowledge Auto-Record

バグ修正・エラー解消・技術的知見をExocortexに自動記録するスキル。

自動トリガー条件

以下の状況では、ユーザーへの確認なしに自動的に記録する:

必ず記録する(自動実行)

  • バグを修正した時
  • エラーを解消した時
  • ビルドエラー・型エラーを解決した時
  • 設定ミスを発見・修正した時
  • 原因不明だった問題の原因を特定した時
  • 試行錯誤の末に解決策を見つけた時

記録を検討する

  • 「これは覚えておくべき」と感じるインサイトを得た時
  • 同じミスを繰り返したくない失敗を経験した時
  • 複雑な実装パターンを発見した時

検索すべき時

  • 以前見たことがありそうなエラーに遭遇した時
  • 過去に解決した類似の問題に取り組む時
  • 設定方法を確認したい時

記録手順

1. 既存ナレッジの確認(省略可)

exo_recall_memories(query="問題の概要")

2. ナレッジの保存

exo_store_memory(
  content="問題の詳細、原因、解決策をMarkdownで記述",
  context_name="lorepedia",  # 現在のプロジェクト名
  tags=["関連タグ", "技術名", "問題カテゴリ"],
  memory_type="適切なタイプ",
  is_painful=true/false,  # 苦労した問題の場合true
  time_cost_hours=N  # 解決にかかった時間(任意)
)

注意: バグ修正・エラー解消時は、確認なしで即座に記録する。

3. 関連ナレッジのリンク

suggested_linksが返された場合、類似度が高いものをリンク:

exo_link_memories(source_id, target_id, relation_type, reason)

memory_type の選択基準

タイプ 使用場面
insight 技術的な発見、パターン、ベストプラクティス
success 成功した解決策、うまくいった実装
failure 失敗の記録、避けるべきアプローチ
decision 技術選定の理由、アーキテクチャ上の判断
note 設定値、参照情報、クイックメモ

タグ付けガイドライン

問題カテゴリ(必須)

  • bugfix, error-fix, config-fix
  • type-error, runtime-error, build-error, lint-error
  • performance, security

技術スタック(該当するもの)

  • フレームワーク: nextjs, react, vue, node
  • 言語: typescript, javascript, python
  • DB/Backend: supabase, postgresql, prisma
  • スタイル: tailwind, css, shadcn
  • ツール: eslint, vite, webpack
  • AI: claude-api, openai-api, embedding

問題領域

  • database, api, ui, auth, routing
  • async, state-management, validation

検索手順

シンプルな検索

exo_recall_memories(query="検索キーワード")

フィルター付き検索

exo_recall_memories(
  query="検索キーワード",
  tag_filter=["bugfix", "typescript"],
  type_filter="success"
)

関連ナレッジの探索

exo_explore_related(memory_id="見つかったメモリID")

決定の経緯を追跡

exo_trace_lineage(memory_id="決定のID", direction="backward")

記録テンプレート(共通)

markdown
## 問題/発見
[エラーメッセージ、症状、または学んだこと]

## 原因/背景
[根本原因または文脈]

## 解決策/内容
[具体的な修正内容またはコード例]

## 再発防止/適用場面
[同様の問題を防ぐポイント、または知識が役立つシーン]

セッション管理

セッション開始時

exo_session_briefing(project_context="lorepedia")

セッション終了時(または大きなタスク完了時)

exo_sleep()

使用例

// エラー解決時の記録
exo_store_memory(
  content="## 問題\nTypeScriptで型エラー\n## 原因\n型定義が古い\n## 解決策\n型定義を再生成\n## 再発防止\nスキーマ変更後は型を再生成",
  context_name="lorepedia",
  tags=["type-error", "typescript", "bugfix"],
  memory_type="success"
)

// 類似問題の検索
exo_recall_memories(query="type error", tag_filter=["typescript"])

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results