@knowledgine/cli 0.4.1 → 0.6.0

package/dist/templates/skills/knowledgine-explore/references.ja.js

@@ -0,0 +1,182 @@
+export const REFERENCES = {
+    "entity-types.md": `# エンティティの種類
+
+knowledgine がナレッジベースのコンテンツから認識・抽出するエンティティの種類。
+
+---
+
+## コアエンティティの種類
+
+| 種類 | 説明 | 例 |
+|------|------|-----|
+| \`technology\` | ライブラリ、フレームワーク、ツール、言語 | \`SQLite\`, \`TypeScript\`, \`Node.js\`, \`Zod\` |
+| \`concept\` | 抽象的なアイデア、パターン、アーキテクチャの概念 | \`caching\`, \`ESM\`, \`FTS5\`, \`semantic search\` |
+| \`project\` | プロジェクト、リポジトリ、製品 | \`knowledgine\`, \`claude-code\` |
+| \`person\` | 著者、コントリビュータ、連絡先 | チームメンバー、外部コントリビュータ |
+| \`component\` | コードコンポーネント、クラス、モジュール | \`KnowledgeRepository\`, \`IngestEngine\` |
+| \`command\` | CLI コマンドまたは API オペレーション | \`knowledgine init\`, \`capture_knowledge\` |
+| \`file\` | ソースファイルとパス | \`packages/core/src/config/config-loader.ts\` |
+| \`error\` | 名前付きエラー型またはエラーメッセージ | \`SQLITE_CONSTRAINT\`, \`ENOENT\` |
+
+---
+
+## エンティティの検索
+
+### 正確な名前で
+\`\`\`
+search_entities(query: "SQLite")
+search_entities(query: "KnowledgeRepository")
+\`\`\`
+
+### 種類 + 名前で
+\`\`\`
+search_entities(query: "technology sqlite")
+search_entities(query: "concept caching")
+\`\`\`
+
+### 部分的な名前で
+\`\`\`
+search_entities(query: "Knowledge")  // KnowledgeRepository, knowledgine などに一致
+\`\`\`
+
+---
+
+## エンティティ抽出の品質
+
+エンティティはNLPを使用してノートのコンテンツから自動的に抽出されます。品質は
+ノートの明確さに依存します。欠落または不正確なエンティティに気づいた場合は、
+\`knowledgine-feedback\` を使用して報告してください。
+
+**よくある抽出の問題**:
+- 略語（TS → TypeScript がリンクされない場合がある）
+- クラス名と同じ一般的な単語（Table, Manager）
+- 一部のみが捕捉されるマルチワードエンティティ
+
+---
+
+## 探索のためのエンティティの活用
+
+エンティティはナレッジグラフのナビゲーションハブとして機能します。\`SQLite\` のような
+技術エンティティは SQLite に言及するすべてのノートに接続されており、エンティティから
+関連するすべてのバグ修正、設計上の決定、パターンへと移動できます。
+
+**探索パターン**:
+\`\`\`
+1. search_entities(query: "SQLite") → エンティティ ID（数値）を取得
+2. get_entity_graph(entityId: 123) → すべての接続を確認
+3. find_related(noteId: 456) → 外側に向かって走査
+\`\`\`
+`,
+    "graph-navigation.md": `# グラフナビゲーション
+
+\`get_entity_graph\` と \`find_related\` を使ってナレッジグラフを効果的に走査する方法。
+
+---
+
+## ナレッジグラフの構造
+
+ナレッジグラフには 2 種類のノードがあります:
+
+- **ノート** — 個々の知識エントリ（バグ修正、決定、パターンなど）
+- **エンティティ** — ノートから抽出された名前付きの事物（技術、概念、人物）
+
+**エッジの種類**:
+- ノート → エンティティ: 「このノートはこのエンティティに言及している」
+- エンティティ → ノート: 「このエンティティはこれらのノートに登場する」
+- ノート → ノート: 「これらのノートはエンティティを共有している」（エンティティの接続を通じた暗示的なもの）
+
+---
+
+## get_entity_graph
+
+エンティティと、それが登場するすべてのノート、さらに関連エンティティを返します。
+
+\`\`\`
+get_entity_graph(entityId: 123)
+// 戻り値: { entity, notes: [...], relatedEntities: [...] }
+
+get_entity_graph(entityName: "SQLite")
+// 名前でエンティティを検索してからグラフを返す
+\`\`\`
+
+**以下のときに使用**:
+- 特定の技術や概念に関するすべてのノートを確認したい
+- このエンティティと共に登場する他のエンティティを発見したい
+- より深い走査を行う前に概要を把握したい
+
+---
+
+## find_related
+
+共有エンティティを通じて、出発点（ノートまたはファイルパス）に関連するノートを返します。
+
+\`\`\`
+find_related(noteId: 456, limit: 10, maxHops: 2)
+find_related(filePath: "src/commands/setup.ts", limit: 10)
+\`\`\`
+
+**パラメータ**:
+- \`noteId\`（数値）または \`filePath\`: 走査の出発点
+- \`limit\`: 返すノートの最大数（デフォルト 5）
+- \`maxHops\`: 許可するエッジ走査のステップ数（1〜3、デフォルト 1）
+
+### maxHops ガイド
+
+| maxHops | 意味 | 使用するタイミング |
+|---------|------|-----------------|
+| 1 | 出発ノートと直接エンティティを共有するノートのみ | デフォルト、焦点を絞ったルックアップ |
+| 2 | 2 ホップ離れたノート（1 ホップのノートとエンティティを共有） | より広い探索 |
+| 3 | 3 ホップ離れたノート | オープンエンドの探索、大きなグラフ |
+
+**maxHops を大きくするほど結果が増えるが、平均的な関連性は低くなります。** 1 から始め、
+結果が疎すぎる場合にのみ増やしてください。
+
+---
+
+## ナビゲーションパターン
+
+### パターン 1: 技術の詳細調査
+
+\`\`\`
+// ナレッジベースにある TypeScript に関するすべてを理解する
+1. search_entities(query: "TypeScript") → { id: 42, name: "TypeScript" }
+2. get_entity_graph(entityId: 42)
+   → 15 件のノートが TypeScript に言及
+   → 関連エンティティ: ESM, tsconfig, type-safety
+3. find_related(noteId: <上位ノートの id>, maxHops: 2)
+   → 隣接するノートを提示
+\`\`\`
+
+### パターン 2: コンポーネントの歴史
+
+\`\`\`
+// セットアップコマンドの歴史を理解する
+1. search_entities(query: "setupCommand") → エンティティ
+2. get_entity_graph(entityId: <id>) → setupCommand に関するノート
+3. design-decision とリファクタリングのノートをフィルタリング
+4. 時系列順に読んで変遷を理解する
+\`\`\`
+
+### パターン 3: 領域をまたいだ接続
+
+\`\`\`
+// 2つのコンポーネント間の接続を見つける
+1. get_entity_graph(entityName: "IngestEngine") → ノート + エンティティのセット A
+2. get_entity_graph(entityName: "KnowledgeRepository") → セット B
+3. relatedEntities の重複を調べてブリッジを見つける
+\`\`\`
+
+---
+
+## 結果の解釈
+
+\`get_entity_graph\` が多くのノートを返す場合、タグで優先順位を付けます:
+
+| 優先度 | タグ |
+|--------|------|
+| 高 | \`design-decision\`, \`bug-fix\`, \`troubleshooting\` |
+| 中 | \`pattern\`, \`refactoring\`, \`external-knowledge\` |
+| 低 | タグなしのノート |
+`,
+};
+//# sourceMappingURL=references.ja.js.map

package/dist/templates/skills/knowledgine-explore/references.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEpB;IAEC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8GxB;CACA,CAAC"}

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.js

@@ -62,9 +62,9 @@ the entity to all related bug fixes, design decisions, and patterns.
 
 **Exploration pattern**:
 \`\`\`
-1. search_entities(query: "SQLite") → get entity ID
-2. get_entity_graph(entityId: "<id>") → see all connections
-3. find_related(noteId: "<connected note id>") → traverse outward
+1. search_entities(query: "SQLite") → get entity ID (number)
+2. get_entity_graph(entityId: 123) → see all connections
+3. find_related(noteId: 456) → traverse outward
 \`\`\`
 `,
     "graph-navigation.md": `# Graph Navigation
@@ -93,7 +93,7 @@ The knowledge graph has two node types:
 Returns the entity and all notes it appears in, plus related entities.
 
 \`\`\`
-get_entity_graph(entityId: "123")
+get_entity_graph(entityId: 123)
 // Returns: { entity, notes: [...], relatedEntities: [...] }
 
 get_entity_graph(entityName: "SQLite")
@@ -112,25 +112,25 @@ get_entity_graph(entityName: "SQLite")
 Returns notes related to a starting point (note or file path) via shared entities.
 
 \`\`\`
-find_related(noteId: "abc123", limit: 10, maxHops: 2)
+find_related(noteId: 456, limit: 10, maxHops: 2)
 find_related(filePath: "src/commands/setup.ts", limit: 10)
 \`\`\`
 
 **Parameters**:
-- \`noteId\` or \`filePath\`: Starting point for traversal
-- \`limit\`: Maximum notes to return
-- \`maxHops\`: How many edge-traversal steps to allow (1–3)
+- \`noteId\` (number) or \`filePath\`: Starting point for traversal
+- \`limit\`: Maximum notes to return (default 5)
+- \`maxHops\`: How many edge-traversal steps to allow (1–3, default 1)
 
 ### maxHops Guide
 
 | maxHops | Meaning | When to use |
 |---------|---------|-------------|
-| 1 | Only notes that share a direct entity with the starting note | Focused lookup |
-| 2 | Notes 2 hops away (share an entity with a 1-hop note) | Default, good balance |
+| 1 | Only notes that share a direct entity with the starting note | Default, focused lookup |
+| 2 | Notes 2 hops away (share an entity with a 1-hop note) | Broader exploration |
 | 3 | Notes 3 hops away | Open-ended exploration, large graph |
 
 **Higher maxHops returns more results but with lower average relevance.** Start at 1
-or 2 and increase only if the results are too sparse.
+and increase only if the results are too sparse.
 
 ---
 
@@ -140,11 +140,11 @@ or 2 and increase only if the results are too sparse.
 
 \`\`\`
 // Understand everything in the knowledge base about TypeScript
-1. search_entities(query: "TypeScript") → { id: "42", name: "TypeScript" }
-2. get_entity_graph(entityId: "42")
+1. search_entities(query: "TypeScript") → { id: 42, name: "TypeScript" }
+2. get_entity_graph(entityId: 42)
    → 15 notes mention TypeScript
    → related entities: ESM, tsconfig, type-safety
-3. find_related(noteId: "<top note id>", maxHops: 2)
+3. find_related(noteId: <top note id>, maxHops: 2)
    → Surface adjacent notes
 \`\`\`
 
@@ -153,7 +153,7 @@ or 2 and increase only if the results are too sparse.
 \`\`\`
 // Understand the history of the setup command
 1. search_entities(query: "setupCommand") → entity
-2. get_entity_graph(entityId: "<id>") → notes about setupCommand
+2. get_entity_graph(entityId: <id>) → notes about setupCommand
 3. Filter for design-decision and refactoring notes
 4. Read chronologically to understand evolution
 \`\`\`

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.js.map

@@ -1 +1 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explain/references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEpB;IAEC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GxB;CACA,CAAC"}
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEpB;IAEC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GxB;CACA,CAAC"}

package/dist/templates/skills/knowledgine-explore/skill-md.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-explore\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Explore entities, knowledge graph connections, and design history for unfamiliar\n  components. Invoke when exploring code you did not write, tracing the history of a\n  design decision, or understanding how a named entity (technology, library, project,\n  component) relates to other parts of the knowledge base.\n---\n# knowledgine-explore\n\n## Purpose\n\nTrace the knowledge graph to understand why things are the way they are. Explore uses\nentity search and graph traversal to surface the full context around a component or\nconcept \u2014 not just what exists, but how it connects to other parts of the system and\nwhat decisions shaped it.\n\n## When to Use\n\n- **Exploring unfamiliar code** \u2014 Who wrote what and why? What decisions shaped this?\n- **Understanding design rationale** \u2014 What alternatives were considered?\n- **Tracing knowledge provenance** \u2014 Where did this pattern or approach come from?\n- **Auditing a technology choice** \u2014 Why is this library used here?\n- **Understanding relationships** \u2014 How do components A and B relate?\n\n## When NOT to Use\n\n- When you just need to find a specific past solution (use knowledgine-search instead)\n- When the entity does not exist in the knowledge base yet\n- For trivial well-known concepts with no project-specific context\n\n## How to Explore (MCP Tools)\n\n### Step 1: Search for entities\n\n```\nsearch_entities(\n  query: string,   // Entity name, technology, concept, or person\n  limit?: number   // Max results (default 20)\n)\n```\n\n### Step 2: Explore entity graph\n\n```\nget_entity_graph(\n  entityId?: number,    // ID from search_entities result\n  entityName?: string   // Or search by name directly\n)\n```\n\n### Step 3: Find related notes\n\n```\nfind_related(\n  noteId?: number,    // A relevant note ID found in earlier steps\n  filePath?: string,  // Or a relevant file path\n  limit?: number,     // Max notes to return (default 5)\n  maxHops?: number    // 1\u20133, default 1\n)\n```\n\n## How to Explore (CLI Alternative)\n\n```bash\nknowledgine explain \"<entity name or concept>\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the subject** \u2014 What entity, component, or concept do you want to understand?\n2. **Search for the entity** \u2014 Call `search_entities` with the subject name\n3. **Inspect the entity graph** \u2014 Call `get_entity_graph` with the entity ID\n4. **Traverse related notes** \u2014 Call `find_related` for notes that mention this entity\n5. **Synthesize findings** \u2014 Summarize what you learned about the entity's history and connections\n\n## Best Practices\n\n- Start with `search_entities` to discover the exact entity name as stored in the knowledge base\n- Use `get_entity_graph` to map the neighborhood before diving into individual notes\n- Increase `maxHops` gradually \u2014 start at 1, go to 2 or 3 if the immediate neighborhood is sparse\n- Look specifically for notes tagged `design-decision` \u2014 they explain the \"why\"\n\n## Edge Cases\n\n- **If the knowledge base is empty** \u2014 No entities will be found. Run `knowledgine-ingest` first to populate the knowledge base before exploring.\n- **If semantic search is unavailable** \u2014 Fall back to keyword search by using specific technology or component names as the query string.\n\n## Reference Files\n\n- See `entity-types.md` for the entity taxonomy used in knowledgine\n- See `graph-navigation.md` for how to traverse the knowledge graph effectively\n";
+//# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skills/knowledgine-explore/skill-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,4/GA8FpB,CAAC"}

package/dist/templates/skills/knowledgine-explore/skill-md.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-explore\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u6163\u308C\u306A\u3044\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3001\u30CA\u30EC\u30C3\u30B8\u30B0\u30E9\u30D5\u306E\u63A5\u7D9A\u3001\u8A2D\u8A08\u306E\u6B74\u53F2\u3092\u63A2\u7D22\u3057\u307E\u3059\u3002\n  \u81EA\u5206\u304C\u66F8\u3044\u3066\u3044\u306A\u3044\u30B3\u30FC\u30C9\u3092\u63A2\u7D22\u3059\u308B\u3068\u304D\u3001\u8A2D\u8A08\u4E0A\u306E\u6C7A\u5B9A\u306E\u7D4C\u7DEF\u3092\u8FFD\u8DE1\u3059\u308B\u3068\u304D\u3001\n  \u307E\u305F\u306F\u540D\u524D\u4ED8\u304D\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\uFF08\u6280\u8853\u3001\u30E9\u30A4\u30D6\u30E9\u30EA\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\uFF09\u304C\n  \u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306E\u4ED6\u306E\u90E8\u5206\u3068\u3069\u306E\u3088\u3046\u306B\u95A2\u9023\u3057\u3066\u3044\u308B\u304B\u3092\u7406\u89E3\u3059\u308B\u3068\u304D\u306B\u547C\u3073\u51FA\u3057\u307E\u3059\u3002\n---\n# knowledgine-explore\n\n## \u76EE\u7684\n\n\u30CA\u30EC\u30C3\u30B8\u30B0\u30E9\u30D5\u3092\u8FFD\u8DE1\u3057\u3066\u3001\u306A\u305C\u7269\u4E8B\u304C\u73FE\u72B6\u306E\u3088\u3046\u306B\u306A\u3063\u3066\u3044\u308B\u304B\u3092\u7406\u89E3\u3057\u307E\u3059\u3002\nExplore \u306F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u691C\u7D22\u3068\u30B0\u30E9\u30D5\u8D70\u67FB\u3092\u4F7F\u7528\u3057\u3066\u3001\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3084\u6982\u5FF5\u3092\u53D6\u308A\u5DFB\u304F\n\u5B8C\u5168\u306A\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u63D0\u793A\u3057\u307E\u3059 \u2014 \u4F55\u304C\u5B58\u5728\u3059\u308B\u304B\u3060\u3051\u3067\u306A\u304F\u3001\u305D\u308C\u304C\u30B7\u30B9\u30C6\u30E0\u306E\u4ED6\u306E\u90E8\u5206\u3068\n\u3069\u306E\u3088\u3046\u306B\u63A5\u7D9A\u3055\u308C\u3066\u3044\u308B\u304B\u3001\u305D\u3057\u3066\u3069\u306E\u3088\u3046\u306A\u6C7A\u5B9A\u304C\u305D\u308C\u3092\u5F62\u6210\u3057\u305F\u304B\u3082\u542B\u3081\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u6163\u308C\u306A\u3044\u30B3\u30FC\u30C9\u3092\u63A2\u7D22\u3059\u308B\u3068\u304D** \u2014 \u8AB0\u304C\u4F55\u3092\u306A\u305C\u4F5C\u3063\u305F\u306E\u304B\uFF1F\u3069\u306E\u3088\u3046\u306A\u6C7A\u5B9A\u304C\u3053\u308C\u3092\u5F62\u6210\u3057\u305F\u306E\u304B\uFF1F\n- **\u8A2D\u8A08\u306E\u6839\u62E0\u3092\u7406\u89E3\u3059\u308B\u3068\u304D** \u2014 \u3069\u306E\u3088\u3046\u306A\u4EE3\u66FF\u6848\u304C\u691C\u8A0E\u3055\u308C\u305F\u306E\u304B\uFF1F\n- **\u77E5\u8B58\u306E\u51FA\u6240\u3092\u8FFD\u8DE1\u3059\u308B\u3068\u304D** \u2014 \u3053\u306E\u30D1\u30BF\u30FC\u30F3\u3084\u30A2\u30D7\u30ED\u30FC\u30C1\u306F\u3069\u3053\u304B\u3089\u6765\u305F\u306E\u304B\uFF1F\n- **\u6280\u8853\u9078\u629E\u306E\u76E3\u67FB** \u2014 \u306A\u305C\u3053\u3053\u3067\u3053\u306E\u30E9\u30A4\u30D6\u30E9\u30EA\u304C\u4F7F\u308F\u308C\u3066\u3044\u308B\u306E\u304B\uFF1F\n- **\u95A2\u4FC2\u6027\u3092\u7406\u89E3\u3059\u308B\u3068\u304D** \u2014 \u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8 A \u3068 B \u306F\u3069\u306E\u3088\u3046\u306B\u95A2\u9023\u3057\u3066\u3044\u308B\u306E\u304B\uFF1F\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u7279\u5B9A\u306E\u904E\u53BB\u306E\u89E3\u6C7A\u7B56\u3092\u898B\u3064\u3051\u305F\u3044\u3060\u3051\u306E\u3068\u304D\uFF08\u4EE3\u308F\u308A\u306B knowledgine-search \u3092\u4F7F\u7528\uFF09\n- \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\u307E\u3060\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306B\u5B58\u5728\u3057\u306A\u3044\u3068\u304D\n- \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u56FA\u6709\u306E\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u306A\u3044\u81EA\u660E\u306E\u5E83\u304F\u77E5\u3089\u308C\u305F\u6982\u5FF5\n\n## \u63A2\u7D22\u65B9\u6CD5 (MCP \u30C4\u30FC\u30EB)\n\n### Step 1: \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3092\u691C\u7D22\u3059\u308B\n\n```\nsearch_entities(\n  query: string,   // \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\u3001\u6280\u8853\u3001\u6982\u5FF5\u3001\u307E\u305F\u306F\u4EBA\u7269\n  limit?: number   // \u6700\u5927\u7D50\u679C\u6570\uFF08\u30C7\u30D5\u30A9\u30EB\u30C8 20\uFF09\n)\n```\n\n### Step 2: \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30B0\u30E9\u30D5\u3092\u63A2\u7D22\u3059\u308B\n\n```\nget_entity_graph(\n  entityId?: number,    // search_entities \u306E\u7D50\u679C\u304B\u3089\u306E ID\n  entityName?: string   // \u307E\u305F\u306F\u540D\u524D\u3067\u76F4\u63A5\u691C\u7D22\n)\n```\n\n### Step 3: \u95A2\u9023\u30CE\u30FC\u30C8\u3092\u898B\u3064\u3051\u308B\n\n```\nfind_related(\n  noteId?: number,    // \u524D\u306E\u30B9\u30C6\u30C3\u30D7\u3067\u898B\u3064\u3051\u305F\u95A2\u9023\u30CE\u30FC\u30C9\u306E ID\n  filePath?: string,  // \u307E\u305F\u306F\u95A2\u9023\u3059\u308B\u30D5\u30A1\u30A4\u30EB\u30D1\u30B9\n  limit?: number,     // \u8FD4\u3059\u30CE\u30FC\u30C8\u306E\u6700\u5927\u6570\uFF08\u30C7\u30D5\u30A9\u30EB\u30C8 5\uFF09\n  maxHops?: number    // 1\u301C3\u3001\u30C7\u30D5\u30A9\u30EB\u30C8 1\n)\n```\n\n## \u63A2\u7D22\u65B9\u6CD5 (CLI \u306E\u4EE3\u66FF\u624B\u6BB5)\n\n```bash\nknowledgine explain \"<entity name or concept>\"\n```\n\n## \u624B\u9806\n\n1. **\u5BFE\u8C61\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u7406\u89E3\u3057\u305F\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3001\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3001\u307E\u305F\u306F\u6982\u5FF5\u306F\u4F55\u304B\uFF1F\n2. **\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3092\u691C\u7D22\u3059\u308B** \u2014 \u5BFE\u8C61\u306E\u540D\u524D\u3067 `search_entities` \u3092\u547C\u3073\u51FA\u3059\n3. **\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30B0\u30E9\u30D5\u3092\u8ABF\u3079\u308B** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3 ID \u3067 `get_entity_graph` \u3092\u547C\u3073\u51FA\u3059\n4. **\u95A2\u9023\u30CE\u30FC\u30C8\u3092\u8D70\u67FB\u3059\u308B** \u2014 \u3053\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306B\u8A00\u53CA\u3059\u308B\u30CE\u30FC\u30C8\u306B\u5BFE\u3057\u3066 `find_related` \u3092\u547C\u3073\u51FA\u3059\n5. **\u767A\u898B\u5185\u5BB9\u3092\u7D71\u5408\u3059\u308B** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306E\u6B74\u53F2\u3068\u63A5\u7D9A\u306B\u3064\u3044\u3066\u5B66\u3093\u3060\u3053\u3068\u3092\u307E\u3068\u3081\u308B\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- `search_entities` \u304B\u3089\u59CB\u3081\u3066\u3001\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306B\u4FDD\u5B58\u3055\u308C\u3066\u3044\u308B\u6B63\u78BA\u306A\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\u3092\u767A\u898B\u3059\u308B\n- \u500B\u3005\u306E\u30CE\u30FC\u30C8\u3092\u8A73\u3057\u304F\u898B\u308B\u524D\u306B `get_entity_graph` \u3067\u8FD1\u96A3\u3092\u30DE\u30C3\u30D4\u30F3\u30B0\u3059\u308B\n- `maxHops` \u3092\u6BB5\u968E\u7684\u306B\u5897\u3084\u3059 \u2014 1 \u304B\u3089\u59CB\u3081\u3001\u8FD1\u96A3\u304C\u758E\u306A\u5834\u5408\u306F 2 \u307E\u305F\u306F 3 \u306B\u3059\u308B\n- `design-decision` \u30BF\u30B0\u304C\u4ED8\u3044\u305F\u30CE\u30FC\u30C8\u3092\u7279\u306B\u63A2\u3059 \u2014 \u305D\u308C\u3089\u304C\u300C\u306A\u305C\u300D\u3092\u8AAC\u660E\u3057\u3066\u3044\u308B\n\n## \u30A8\u30C3\u30B8\u30B1\u30FC\u30B9\n\n- **\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u304C\u7A7A\u306E\u5834\u5408** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306F\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u63A2\u7D22\u3059\u308B\u524D\u306B\n  `knowledgine-ingest` \u3092\u5B9F\u884C\u3057\u3066\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002\n- **\u30BB\u30DE\u30F3\u30C6\u30A3\u30C3\u30AF\u691C\u7D22\u304C\u5229\u7528\u3067\u304D\u306A\u3044\u5834\u5408** \u2014 \u7279\u5B9A\u306E\u6280\u8853\u307E\u305F\u306F\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u540D\u3092\n  \u30AF\u30A8\u30EA\u6587\u5B57\u5217\u3068\u3057\u3066\u4F7F\u7528\u3057\u3066\u30AD\u30FC\u30EF\u30FC\u30C9\u691C\u7D22\u306B\u30D5\u30A9\u30FC\u30EB\u30D0\u30C3\u30AF\u3057\u3066\u304F\u3060\u3055\u3044\u3002\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- knowledgine \u3067\u4F7F\u7528\u3055\u308C\u308B\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306E\u5206\u985E\u306B\u3064\u3044\u3066\u306F `entity-types.md` \u3092\u53C2\u7167\n- \u30CA\u30EC\u30C3\u30B8\u30B0\u30E9\u30D5\u3092\u52B9\u679C\u7684\u306B\u8D70\u67FB\u3059\u308B\u65B9\u6CD5\u306B\u3064\u3044\u3066\u306F `graph-navigation.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

package/dist/templates/skills/knowledgine-explore/skill-md.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,2sQAgGpB,CAAC"}

package/dist/templates/skills/knowledgine-explore/skill-md.ja.js

@@ -0,0 +1,98 @@
+export const SKILL_MD = `---
+name: knowledgine-explore
+version: "1.0.0"
+lang: ja
+description: >
+  慣れないコンポーネントのエンティティ、ナレッジグラフの接続、設計の歴史を探索します。
+  自分が書いていないコードを探索するとき、設計上の決定の経緯を追跡するとき、
+  または名前付きエンティティ（技術、ライブラリ、プロジェクト、コンポーネント）が
+  ナレッジベースの他の部分とどのように関連しているかを理解するときに呼び出します。
+---
+# knowledgine-explore
+
+## 目的
+
+ナレッジグラフを追跡して、なぜ物事が現状のようになっているかを理解します。
+Explore はエンティティ検索とグラフ走査を使用して、コンポーネントや概念を取り巻く
+完全なコンテキストを提示します — 何が存在するかだけでなく、それがシステムの他の部分と
+どのように接続されているか、そしてどのような決定がそれを形成したかも含めます。
+
+## 使用するタイミング
+
+- **慣れないコードを探索するとき** — 誰が何をなぜ作ったのか？どのような決定がこれを形成したのか？
+- **設計の根拠を理解するとき** — どのような代替案が検討されたのか？
+- **知識の出所を追跡するとき** — このパターンやアプローチはどこから来たのか？
+- **技術選択の監査** — なぜここでこのライブラリが使われているのか？
+- **関係性を理解するとき** — コンポーネント A と B はどのように関連しているのか？
+
+## 使用しないタイミング
+
+- 特定の過去の解決策を見つけたいだけのとき（代わりに knowledgine-search を使用）
+- エンティティがまだナレッジベースに存在しないとき
+- プロジェクト固有のコンテキストがない自明の広く知られた概念
+
+## 探索方法 (MCP ツール)
+
+### Step 1: エンティティを検索する
+
+\`\`\`
+search_entities(
+  query: string,   // エンティティ名、技術、概念、または人物
+  limit?: number   // 最大結果数（デフォルト 20）
+)
+\`\`\`
+
+### Step 2: エンティティグラフを探索する
+
+\`\`\`
+get_entity_graph(
+  entityId?: number,    // search_entities の結果からの ID
+  entityName?: string   // または名前で直接検索
+)
+\`\`\`
+
+### Step 3: 関連ノートを見つける
+
+\`\`\`
+find_related(
+  noteId?: number,    // 前のステップで見つけた関連ノードの ID
+  filePath?: string,  // または関連するファイルパス
+  limit?: number,     // 返すノートの最大数（デフォルト 5）
+  maxHops?: number    // 1〜3、デフォルト 1
+)
+\`\`\`
+
+## 探索方法 (CLI の代替手段)
+
+\`\`\`bash
+knowledgine explain "<entity name or concept>"
+\`\`\`
+
+## 手順
+
+1. **対象を特定する** — 理解したいエンティティ、コンポーネント、または概念は何か？
+2. **エンティティを検索する** — 対象の名前で \`search_entities\` を呼び出す
+3. **エンティティグラフを調べる** — エンティティ ID で \`get_entity_graph\` を呼び出す
+4. **関連ノートを走査する** — このエンティティに言及するノートに対して \`find_related\` を呼び出す
+5. **発見内容を統合する** — エンティティの歴史と接続について学んだことをまとめる
+
+## ベストプラクティス
+
+- \`search_entities\` から始めて、ナレッジベースに保存されている正確なエンティティ名を発見する
+- 個々のノートを詳しく見る前に \`get_entity_graph\` で近隣をマッピングする
+- \`maxHops\` を段階的に増やす — 1 から始め、近隣が疎な場合は 2 または 3 にする
+- \`design-decision\` タグが付いたノートを特に探す — それらが「なぜ」を説明している
+
+## エッジケース
+
+- **ナレッジベースが空の場合** — エンティティは見つかりません。探索する前に
+  \`knowledgine-ingest\` を実行してナレッジベースを入力してください。
+- **セマンティック検索が利用できない場合** — 特定の技術またはコンポーネント名を
+  クエリ文字列として使用してキーワード検索にフォールバックしてください。
+
+## 参照ファイル
+
+- knowledgine で使用されるエンティティの分類については \`entity-types.md\` を参照
+- ナレッジグラフを効果的に走査する方法については \`graph-navigation.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

package/dist/templates/skills/knowledgine-explore/skill-md.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGvB,CAAC"}

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/skill-md.js

@@ -1,16 +1,18 @@
 export const SKILL_MD = `---
-name: knowledgine-explain
+name: knowledgine-explore
+version: "1.0.0"
+lang: en
 description: >
   Explore entities, knowledge graph connections, and design history for unfamiliar
   components. Invoke when exploring code you did not write, tracing the history of a
   design decision, or understanding how a named entity (technology, library, project,
-  person) relates to other parts of the knowledge base.
+  component) relates to other parts of the knowledge base.
 ---
-# knowledgine-explain
+# knowledgine-explore
 
 ## Purpose
 
-Trace the knowledge graph to understand why things are the way they are. Explain uses
+Trace the knowledge graph to understand why things are the way they are. Explore uses
 entity search and graph traversal to surface the full context around a component or
 concept — not just what exists, but how it connects to other parts of the system and
 what decisions shaped it.
@@ -25,18 +27,18 @@ what decisions shaped it.
 
 ## When NOT to Use
 
-- When you just need to find a specific past solution (use knowledgine-recall instead)
+- When you just need to find a specific past solution (use knowledgine-search instead)
 - When the entity does not exist in the knowledge base yet
 - For trivial well-known concepts with no project-specific context
 
-## How to Explain (MCP Tools)
+## How to Explore (MCP Tools)
 
 ### Step 1: Search for entities
 
 \`\`\`
 search_entities(
   query: string,   // Entity name, technology, concept, or person
-  limit?: number   // Max results (default 10)
+  limit?: number   // Max results (default 20)
 )
 \`\`\`
 
@@ -44,7 +46,7 @@ search_entities(
 
 \`\`\`
 get_entity_graph(
-  entityId?: string,    // ID from search_entities result
+  entityId?: number,    // ID from search_entities result
   entityName?: string   // Or search by name directly
 )
 \`\`\`
@@ -53,14 +55,14 @@ get_entity_graph(
 
 \`\`\`
 find_related(
-  noteId?: string,    // A relevant note ID found in earlier steps
+  noteId?: number,    // A relevant note ID found in earlier steps
   filePath?: string,  // Or a relevant file path
-  limit?: number,
-  maxHops?: number    // 1–3, default 2
+  limit?: number,     // Max notes to return (default 5)
+  maxHops?: number    // 1–3, default 1
 )
 \`\`\`
 
-## How to Explain (CLI Alternative)
+## How to Explore (CLI Alternative)
 
 \`\`\`bash
 knowledgine explain "<entity name or concept>"
@@ -81,6 +83,11 @@ knowledgine explain "<entity name or concept>"
 - Increase \`maxHops\` gradually — start at 1, go to 2 or 3 if the immediate neighborhood is sparse
 - Look specifically for notes tagged \`design-decision\` — they explain the "why"
 
+## Edge Cases
+
+- **If the knowledge base is empty** — No entities will be found. Run \`knowledgine-ingest\` first to populate the knowledge base before exploring.
+- **If semantic search is unavailable** — Fall back to keyword search by using specific technology or component names as the query string.
+
 ## Reference Files
 
 - See \`entity-types.md\` for the entity taxonomy used in knowledgine

package/dist/templates/skills/{knowledgine-suggest → knowledgine-explore}/skill-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-suggest/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FvB,CAAC"}
+{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FvB,CAAC"}

package/dist/templates/skills/knowledgine-feedback/references.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCES: Record<string, string>;
+//# sourceMappingURL=references.ja.d.ts.map

package/dist/templates/skills/knowledgine-feedback/references.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqN7C,CAAC"}