mcpField
K
knowledge-consolidation

knowledge-consolidation

github.com/learnwy生産性565 回インストール21 週間前に更新
リポジトリ

knowledge-consolidation について

IDE に対応するプロジェクト内フォルダーへ、デバッグ、設定、ワークフロー、教訓を構造化 Markdown で記録するスキルです。CLI は追記専用のノートを作成し、汎用的な内容を llm-wiki に移せます。Stop フックは重要な問題の解決後に保存を促します。

主な機能

  1. 01プロジェクト内に構造化 Markdown ノートを作成
  2. 02ノートを種類別に分類
  3. 03一意なパスの解決と項目の検証
  4. 04汎用ノートを llm-wiki に移行
  5. 05重要な問題の解決後に保存を促す

活用シーン

  1. 01コードベース固有の不具合修正を記録
  2. 02ビルドや設定の判断を記録
  3. 03デプロイやロールバック手順を保存
  4. 04再利用可能なノートを llm-wiki に移行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/learnwy/skills --skill knowledge-consolidation

インストール後、Claude Code で/knowledge-consolidationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

hooks.json
assets/
knowledge.md.template
examples/
debug-session.md
references/
conditional-reflection.md
knowledge-types.md
scripts/
cli.cjs
scripts/hooks/
post-resolution-nudge.cjs

詳細

ナレッジの集約

プロジェクト内の修正記録です。1 回の会話につき、このリポジトリの IDE フォルダーに構造化された Markdown ファイルを 1 つ作成します。コードベースとともに保管され、リポジトリに含まれるため、このプロジェクトでの今後のセッションから参照できます。

**境界：**プロジェクト固有のデバッグ／設定／ワークフロー／教訓に関するメモは、ここに記録します。 全般的で再利用可能な知識（アーキテクチャ、設計パターン、API 統合、参考資料）は、llm-wiki に記録します。KC の promote コマンドは、Wiki に加える価値がある文書を境界を越えて移動します。

使用するタイミング

トリガーアクション
ユーザーが「これを保存して」「記録下来」「解決しました」と言ったcli.cjs save … を実行します
停止時の通知が表示された（「重要な問題を解決したようです」）保存するか尋ねます
このコードベース固有のバグを解決した--type debug
明白ではない設定／ビルド設定を確定した--type config
運用手順（デプロイ／ロールバック）を確立した--type workflow
ポストモーテム／振り返りから得た教訓--type lesson

**次の場合は使用しないでください：**プロジェクト横断の知識（→ llm-wiki）、再利用可能なスキル（→ project-skill-writer）、AI ルール（→ project-rules-writer）、以前保存した文書の更新（KC は一度だけ書き込みます）。

前提条件

  • Node.js ≥ 18
  • プロジェクトのルートに IDE マーカーディレクトリが含まれていること：.trae/、.claude/、.cursor/、または .windsurf/

通常使うコマンド

node scripts/cli.cjs save \
  -r <project_root> \
  -a <ai_type> \
  -t <type> \
  -n <kebab-slug> \
  --title "Short, specific title" \
  --summary "2-3 sentences readers can stop at" \
  --details "Body in Markdown." \
  --takeaways "First actionable insight\nSecond insight" \
  [--background "<one-line problem context>"] \
  [--context "<project / version / component>"] \
  [--related "<links / files>"]

新しいファイルの絶対パスを返します。日付順の名前をアトミックに解決し、ディレクトリを作成して、テンプレートを埋め、必須フィールドを検証します。

-a, --ai-typetrae、trae-cn、claude-code（または claude）、cursor、windsurf
-t, --typedebug、config、workflow、lesson のみ — knowledge-types.md を参照
-n, --namekebab-case のスラッグ、50 文字以内、具体的な名前（bug-fix ではなく react-18-hydration-mismatch）

出力ファイル名：{YYYYMMDD}_{NNN}_{type}_{slug}.md。保存先は <root>/<ide>/knowledges/ です。

グローバル Wiki への昇格

文書がプロジェクト横断で再利用できるとわかったら、llm-wiki の取り込みキューに追加します。

node scripts/cli.cjs promote -p <project>/.trae/knowledges/20260511_001_debug_x.md

元の文書へのフロントマターのポインターを付けて、~/.learnwy/llm-wiki/raw/notes/<date>-<slug>.md にコピーします。Wiki が初期化されていない場合は何も行いません。続けて llm-wiki の取り込みを実行してください。

その他のコマンド

node scripts/cli.cjs path -r <root> -a <ai> -t <type> -n <name>
# → just prints the resolved path; useful for scripts that want to write the file themselves.

Stop フック（自動通知）

Stop フックは、アシスタントの最後の応答から解決の兆候（「原因は…でした」「修正しました」「## 解決策」など）をスキャンします。解決の兆候があり、さらに実質的な指標（競合状態、リグレッション、設計上の判断、「微妙な」など）が示され、セッション内だけの些細な指標（誤字、セミコロンの不足、環境変数の誤り）がない場合、セッションごとに 1 回だけ通知を挿入します：「knowledge-consolidation save の実行を検討してください」。

フックが自動で書き込むことはありません。通知を表示し、AI がユーザーに尋ねます。

フックは learnwy-dispatch を通じて接続されます（単一の Node プロセスで、スキルごとのプロセス起動はありません）。

品質の高い文書を書くためのルール

  1. タイトルは「これから何を学べるか？」に答えるものにします。「デバッグセッション」ではなく、「WebSocket 再接続ハンドラーのメモリーリーク」のようにします。
  2. 概要だけで内容が完結するようにします。読み手が続きを読むかどうかを判断できるようにします。
  3. 詳細のコードブロックには言語タグを付け、長い内容には小見出しを使います。
  4. 要点は命令形にします。「X は重要です」ではなく、「Y の前に必ず X を確認する」とします。
  5. 関連情報には、該当する場合、ソースファイル、PR、または [[wiki-page]] 形式の参照へのリンクを記載します。

境界

このスキルが行うのは、次の処理のみです：

  • IDE マーカーを検出し、一意なナレッジ文書のパスを解決する
  • CLI 引数から構造化文書をアトミックに書き込む
  • 文書をグローバルな llm-wiki の取り込みキューに追加する
  • 重要な問題が解決したとき、セッションごとに 1 回 Stop 通知を表示する

このスキルが行わないのは、次の処理です：

  • 既存の文書を更新する（一度だけ書き込む仕様です）
  • インデックス作成／Lint／整理（これらは llm-wiki の役割です）
  • セッションをまたいで AI のメモリーを保存する
  • 過去のナレッジ文書を検索する

コメント

Markdown 対応