@knowledgine/cli 0.4.1 → 0.6.0

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

@@ -0,0 +1,214 @@
+export const REFERENCES = {
+    "error-types.md": `# エラータイプ
+
+3つのエンティティ抽出エラータイプの説明と例。
+
+---
+
+## false_positive（誤検出）
+
+**定義**：意味のある固有表現ではないエンティティが抽出された。
+抽出システムが単語やフレーズを重要なエンティティとして誤って識別した。
+
+**一般的な原因**：
+- エンティティタイプとして抽出された一般的な英単語（例：技術として「Map」）
+- 実在するエンティティではないコンテキスト固有の専門用語（例：概念として「Result」）
+- エンティティ名の部分一致（例：「TypeScript」から「Type」が抽出される）
+
+**例**：
+
+| エンティティ | 抽出されたタイプ | 誤りの理由 |
+|--------|---------------|----------------|
+| "the" | concept | 一般的な冠詞で、エンティティではない |
+| "Manager" | technology | 一般的なクラス名サフィックスで、製品ではない |
+| "Error" | technology | 一般的なプログラミング用語で、特定のツールではない |
+| "Result" | concept | どこでも使われる汎用的なプログラミング用語 |
+
+**報告するタイミング**：
+誤検出されたエンティティが検索結果に頻繁に現れて結果の品質を低下させている場合に報告する。
+目立たないノートの1回だけの出現は報告する価値がないかもしれない。
+
+**報告方法**：
+\`\`\`
+report_extraction_error(
+  entityName: "Manager",
+  errorType: "false_positive",
+  entityType: "technology",
+  details: "Generic class name suffix, not a specific technology product"
+)
+\`\`\`
+
+---
+
+## wrong_type（誤分類）
+
+**定義**：実在する意味のあるエンティティが抽出されたが、誤ったタイプに分類された。
+エンティティは存在して有効だが、誤って分類されている。
+
+**一般的な原因**：
+- 人名のように聞こえる技術名（例：「Rust」は姓と混同される可能性がある）
+- 技術的な名前を持つ概念
+- 一般的な単語と同じ名前を持つプロジェクトやツール
+
+**例**：
+
+| エンティティ | 誤ったタイプ | 正しいタイプ | 理由 |
+|--------|-----------|--------------|--------|
+| "TypeScript" | person | technology | プログラミング言語であり、人ではない |
+| "Rust" | concept | technology | プログラミング言語 |
+| "knowledgine" | concept | project | このプロジェクトの名前 |
+| "Jest" | person | technology | JavaScriptテストフレームワーク |
+
+**報告するタイミング**：
+誤った分類によりエンティティが無関係な検索に現れたり、
+正しいエンティティタイプのクエリに現れなくなったりする場合に報告する。
+
+**報告方法**：
+\`\`\`
+report_extraction_error(
+  entityName: "TypeScript",
+  errorType: "wrong_type",
+  entityType: "person",
+  correctType: "technology",
+  details: "TypeScript is a programming language, not a person's name"
+)
+\`\`\`
+
+---
+
+## missed_entity（見落とし）
+
+**定義**：重要なエンティティがまったく抽出されなかった。エンティティはナレッジベースの
+ノートに存在するが、グラフにエンティティレコードがない。
+
+**一般的な原因**：
+- このエンティティに対してエンティティ抽出の信頼度閾値が高すぎた
+- エンティティ名が通常とは異なる形式やコンテキストで言及されていた
+- エンティティが新しく、抽出器のモデルがそれについて学習されていない
+- エンティティが散文ではなくコードブロック内に現れている
+
+**例**：
+- バリデーションコード全体で「Zod」が言及されているがエンティティが抽出されていない
+- コミットメッセージに現れるチームメンバーの名前がエンティティグラフにない
+- 頻繁に参照される特定のエラーコード（例：「SQLITE_CONSTRAINT_UNIQUE」）
+- importステートメントにのみ現れるライブラリ名
+
+**報告するタイミング**：
+\`search_entities\` または \`get_entity_graph\` でそのエンティティを検索するほど重要な場合に報告する。
+頻度の低いマイナーなエンティティは追加する価値がないかもしれない。
+
+**報告方法**：
+\`\`\`
+report_extraction_error(
+  entityName: "Zod",
+  errorType: "missed_entity",
+  details: "Validation library used throughout packages/core for schema validation. \
+Appears in imports and error messages but no entity was extracted."
+)
+\`\`\`
+`,
+    "feedback-guide.md": `# フィードバックガイド
+
+抽出の改善につながる効果的なフィードバックレポートの書き方。
+
+---
+
+## 効果的なフィードバックの条件
+
+良いフィードバック：
+1. **具体的なエンティティを特定する** — 説明ではなく正確な名前
+2. **正しい分類を述べる** — どのタイプであるべきか、またはあるべきでないか
+3. **理由を説明する** — 簡潔な理由付けがフィードバックを実行可能にする
+4. **ノートを参照する** — 問題が確認された場所へのリンク（可能な場合）
+
+---
+
+## フィードバック報告のワークフロー
+
+### ステップ1：問題を特定する
+
+\`search_entities\` を使って対象のエンティティを探す：
+\`\`\`
+search_entities(query: "TypeScript", limit: 5)
+\`\`\`
+
+返されたタイプと期待するものを照合する。
+
+### ステップ2：関連するノートを探す（任意だが有用）
+
+特定のノートでエンティティの誤分類を確認した場合は、そのIDをメモする。
+ノートIDはsearch_knowledgeの結果で確認できる。
+
+### ステップ3：報告する
+
+利用可能なすべての情報を含めて \`report_extraction_error\` を呼び出す：
+\`\`\`
+report_extraction_error(
+  entityName: "<exact name>",
+  errorType: "<false_positive|wrong_type|missed_entity>",
+  entityType: "<current type if known>",
+  correctType: "<correct type for wrong_type errors>",
+  noteId: "<note id if available>",
+  details: "<1〜2文の説明>"
+)
+\`\`\`
+
+### ステップ4：送信を確認する
+
+ツールがフィードバックIDを含む成功レスポンスを返したことを確認する。
+後でフィードバックの状態を追跡したい場合はIDをメモしておく。
+
+---
+
+## detailsフィールドの書き方
+
+\`details\` フィールドは効果的なフィードバックで最も重要な部分。以下を含める：
+
+- エンティティが実際に何であるか（名前だけで明確でない場合）
+- 抽出されたタイプがなぜ誤りなのか
+- エンティティがどのくらいの頻度で現れるか（見落としの場合）
+- 抽出器の改善に役立つコンテキスト
+
+**弱い詳細**：
+\`\`\`
+details: "wrong"
+details: "this is not right"
+\`\`\`
+
+**強い詳細**：
+\`\`\`
+details: "Zod is a TypeScript-first schema validation library. It appears in ~20 notes
+under packages/core/src as imports and in error messages but was not extracted. It
+should be classified as 'technology'."
+\`\`\`
+
+---
+
+## 何を報告するかの優先順位
+
+| 優先度 | 基準 |
+|----------|----------|
+| 高 | エンティティが多くのノートに現れる；誤分類が検索結果を汚染している |
+| 高 | 見落とされたエンティティがプロジェクトドメインの中心である |
+| 中 | 誤検出が頻繁に現れるが、大きな害を与えていない |
+| 低 | 検索品質への影響が軽微な1回限りの問題 |
+
+---
+
+## 報告後の対応
+
+フィードバックの状態を確認し、改善を適用する：
+
+\`\`\`bash
+# 保留中のフィードバックを一覧表示
+knowledgine feedback list --status pending
+
+# フィードバック品質の統計を確認
+knowledgine feedback stats
+\`\`\`
+
+適用されたフィードバックは抽出設定を更新し、将来のインジェストがより良い結果を生成します。
+却下されたフィードバックは記録されますが、変更は行われません。
+`,
+};
+//# sourceMappingURL=references.ja.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2GnB;IAEC,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGtB;CACA,CAAC"}

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

@@ -1,2 +1,2 @@
-export declare const SKILL_MD = "---\nname: knowledgine-feedback\ndescription: >\n  Report incorrect, missing, or misclassified entity extractions to improve knowledge\n  base quality. Invoke when you notice an entity that should not exist (false positive),\n  an entity assigned to the wrong type (wrong_type), or a real entity that was not\n  extracted at all (missed_entity).\n---\n# knowledgine-feedback\n\n## Purpose\n\nImprove the quality of automatic entity extraction by reporting errors. Feedback is\nstored and can be applied to update extraction rules, preventing the same errors from\nrecurring in future ingests.\n\n## When to Use\n\n- **False positive detected** \u2014 An entity was extracted that is not actually a named entity\n  (e.g., a common English word extracted as a \"technology\" entity)\n- **Wrong type detected** \u2014 An entity exists but is classified incorrectly\n  (e.g., \"TypeScript\" classified as \"person\" instead of \"technology\")\n- **Missed entity detected** \u2014 An important entity was not extracted at all\n  (e.g., a library name that appears frequently but has no entity record)\n\n## When NOT to Use\n\n- When entity extraction quality is acceptable \u2014 minor imprecision is normal\n- For subjective disagreements about entity importance (not extracting an entity\n  does not always mean it was missed \u2014 the extractor uses confidence thresholds)\n\n## How to Report (MCP Tool)\n\nUse the `report_extraction_error` MCP tool:\n\n```\nreport_extraction_error(\n  entityName: string,      // The entity name as it appears in the note\n  errorType: string,       // \"false_positive\" | \"wrong_type\" | \"missed_entity\"\n  entityType?: string,     // Current entity type (for wrong_type and false_positive)\n  correctType?: string,    // What the type should be (for wrong_type)\n  noteId?: string,         // ID of the note where the issue was observed\n  details?: string         // Additional context about the error\n)\n```\n\n## How to Report (CLI Alternative)\n\n```bash\n# Report a false positive\nknowledgine feedback report   --entity \"the\"   --type false_positive   --entity-type concept   --details \"Common English article incorrectly extracted as entity\"\n\n# Report wrong type\nknowledgine feedback report   --entity \"TypeScript\"   --type wrong_type   --entity-type person   --correct-type technology\n\n# Report missed entity\nknowledgine feedback report   --entity \"Zod\"   --type missed_entity   --details \"Validation library used throughout packages/core but not extracted\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the error type** \u2014 Is it a false positive, wrong type, or missed entity?\n2. **Find the entity name** \u2014 Use `search_entities` to find the exact stored name if it exists\n3. **Note the note ID** \u2014 If you observed the error in a specific note, record its ID\n4. **Call report_extraction_error** \u2014 Include all applicable parameters\n5. **Verify submission** \u2014 Confirm the tool returned a success response\n\n## Managing Feedback\n\n```bash\n# View pending feedback\nknowledgine feedback list --status pending\n\n# Apply a specific feedback report (admin operation)\nknowledgine feedback apply <id>\n\n# Dismiss feedback without applying\nknowledgine feedback dismiss <id>\n\n# View feedback statistics\nknowledgine feedback stats\n```\n\n## Best Practices\n\n- Report high-frequency errors first \u2014 they have the most impact\n- Include specific details about what makes the extraction incorrect\n- Reference a note ID when possible so the error can be verified in context\n- Do not report minor cases that have no practical impact on search quality\n\n## Reference Files\n\n- See `error-types.md` for detailed descriptions and examples of each error type\n- See `feedback-guide.md` for how to write effective feedback reports\n";
+export declare const SKILL_MD = "---\nname: knowledgine-feedback\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Report incorrect, missing, or misclassified entity extractions to improve knowledge\n  base quality. Invoke when you notice an entity that should not exist (false positive),\n  an entity assigned to the wrong type (wrong_type), or a real entity that was not\n  extracted at all (missed_entity).\n---\n# knowledgine-feedback\n\n## Purpose\n\nImprove the quality of automatic entity extraction by reporting errors. Feedback is\nstored and can be applied to update extraction rules, preventing the same errors from\nrecurring in future ingests.\n\n## When to Use\n\n- **False positive detected** \u2014 An entity was extracted that is not actually a named entity\n  (e.g., a common English word extracted as a \"technology\" entity)\n- **Wrong type detected** \u2014 An entity exists but is classified incorrectly\n  (e.g., \"TypeScript\" classified as \"person\" instead of \"technology\")\n- **Missed entity detected** \u2014 An important entity was not extracted at all\n  (e.g., a library name that appears frequently but has no entity record)\n\n## When NOT to Use\n\n- When entity extraction quality is acceptable \u2014 minor imprecision is normal\n- For subjective disagreements about entity importance (not extracting an entity\n  does not always mean it was missed \u2014 the extractor uses confidence thresholds)\n\n## How to Report (MCP Tool)\n\nUse the `report_extraction_error` MCP tool:\n\n```\nreport_extraction_error(\n  entityName: string,      // The entity name as it appears in the note\n  errorType: \"false_positive\" | \"wrong_type\" | \"missed_entity\",\n  entityType?: string,     // Current entity type (for wrong_type and false_positive)\n  correctType?: string,    // What the type should be (for wrong_type)\n  noteId?: number,         // ID of the note where the issue was observed\n  details?: string         // Additional context about the error\n)\n```\n\n## How to Report (CLI Alternative)\n\n```bash\n# Report a false positive\nknowledgine feedback report   --entity \"the\"   --type false_positive   --entity-type concept   --details \"Common English article incorrectly extracted as entity\"\n\n# Report wrong type\nknowledgine feedback report   --entity \"TypeScript\"   --type wrong_type   --entity-type person   --correct-type technology\n\n# Report missed entity\nknowledgine feedback report   --entity \"Zod\"   --type missed_entity   --details \"Validation library used throughout packages/core but not extracted\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the error type** \u2014 Is it a false positive, wrong type, or missed entity?\n2. **Find the entity name** \u2014 Use `search_entities` to find the exact stored name if it exists\n3. **Note the note ID** \u2014 If you observed the error in a specific note, record its ID\n4. **Call report_extraction_error** \u2014 Include all applicable parameters\n5. **Verify submission** \u2014 Confirm the tool returned a success response\n\n## Managing Feedback\n\n```bash\n# View pending feedback\nknowledgine feedback list --status pending\n\n# Apply a specific feedback report (admin operation)\nknowledgine feedback apply <id>\n\n# Dismiss feedback without applying\nknowledgine feedback dismiss <id>\n\n# View feedback statistics\nknowledgine feedback stats\n```\n\n## Best Practices\n\n- Report high-frequency errors first \u2014 they have the most impact\n- Include specific details about what makes the extraction incorrect\n- Reference a note ID when possible so the error can be verified in context\n- Do not report minor cases that have no practical impact on search quality\n\n## Reference Files\n\n- See `error-types.md` for detailed descriptions and examples of each error type\n- See `feedback-guide.md` for how to write effective feedback reports\n";
 //# sourceMappingURL=skill-md.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-feedback\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306E\u54C1\u8CEA\u3092\u5411\u4E0A\u3055\u305B\u308B\u305F\u3081\u306B\u3001\u8AA4\u3063\u305F\u30FB\u6B20\u843D\u3057\u3066\u3044\u308B\u30FB\u8AA4\u5206\u985E\u3055\u308C\u305F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u62BD\u51FA\u3092\n  \u5831\u544A\u3057\u307E\u3059\u3002\u5B58\u5728\u3059\u3079\u304D\u3067\u306A\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\uFF08false_positive\uFF09\u3001\u8AA4\u3063\u305F\u30BF\u30A4\u30D7\u306B\u5206\u985E\u3055\u308C\u305F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\n  \uFF08wrong_type\uFF09\u3001\u307E\u305F\u306F\u5B9F\u5728\u3059\u308B\u304C\u62BD\u51FA\u3055\u308C\u306A\u304B\u3063\u305F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\uFF08missed_entity\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D\u306B\n  \u547C\u3073\u51FA\u3057\u3066\u304F\u3060\u3055\u3044\u3002\n---\n# knowledgine-feedback\n\n## \u76EE\u7684\n\n\u30A8\u30E9\u30FC\u3092\u5831\u544A\u3059\u308B\u3053\u3068\u3067\u3001\u81EA\u52D5\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u62BD\u51FA\u306E\u54C1\u8CEA\u3092\u6539\u5584\u3057\u307E\u3059\u3002\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u306F\u4FDD\u5B58\u3055\u308C\u3001\n\u62BD\u51FA\u30EB\u30FC\u30EB\u306E\u66F4\u65B0\u306B\u9069\u7528\u3067\u304D\u307E\u3059\u3002\u3053\u308C\u306B\u3088\u308A\u3001\u5C06\u6765\u306E\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u3067\u540C\u3058\u30A8\u30E9\u30FC\u304C\u7E70\u308A\u8FD4\u3055\u308C\u308B\u3053\u3068\u3092\u9632\u304E\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u8AA4\u691C\u51FA\uFF08false positive\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D** \u2014 \u5B9F\u969B\u306B\u306F\u56FA\u6709\u8868\u73FE\u3067\u306F\u306A\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\n  \u62BD\u51FA\u3055\u308C\u305F\u5834\u5408\uFF08\u4F8B\uFF1A\u4E00\u822C\u7684\u306A\u82F1\u5358\u8A9E\u304C\u300Ctechnology\u300D\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3068\u3057\u3066\u62BD\u51FA\u3055\u308C\u305F\uFF09\n- **\u8AA4\u3063\u305F\u5206\u985E\uFF08wrong type\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306F\u5B58\u5728\u3059\u308B\u304C\u8AA4\u5206\u985E\u3055\u308C\u3066\u3044\u308B\u5834\u5408\n  \uFF08\u4F8B\uFF1A\u300CTypeScript\u300D\u304C\u300Ctechnology\u300D\u3067\u306F\u306A\u304F\u300Cperson\u300D\u3068\u3057\u3066\u5206\u985E\u3055\u308C\u3066\u3044\u308B\uFF09\n- **\u898B\u843D\u3068\u3057\uFF08missed entity\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D** \u2014 \u91CD\u8981\u306A\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\u307E\u3063\u305F\u304F\u62BD\u51FA\u3055\u308C\u306A\u304B\u3063\u305F\u5834\u5408\n  \uFF08\u4F8B\uFF1A\u983B\u7E41\u306B\u767B\u5834\u3059\u308B\u30E9\u30A4\u30D6\u30E9\u30EA\u540D\u306B\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30EC\u30B3\u30FC\u30C9\u304C\u306A\u3044\uFF09\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u62BD\u51FA\u306E\u54C1\u8CEA\u304C\u8A31\u5BB9\u7BC4\u56F2\u5185\u306E\u3068\u304D\u2014\u2014\u8EFD\u5FAE\u306A\u4E0D\u7CBE\u78BA\u3055\u306F\u6B63\u5E38\n- \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306E\u91CD\u8981\u6027\u306B\u95A2\u3059\u308B\u4E3B\u89B3\u7684\u306A\u610F\u898B\u306E\u76F8\u9055\uFF08\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\u62BD\u51FA\u3055\u308C\u3066\u3044\u306A\u3044\u3053\u3068\u304C\n  \u5E38\u306B\u898B\u843D\u3068\u3057\u3092\u610F\u5473\u3059\u308B\u308F\u3051\u3067\u306F\u306A\u3044\u2014\u2014\u62BD\u51FA\u5668\u306F\u4FE1\u983C\u5EA6\u95BE\u5024\u3092\u4F7F\u7528\u3057\u3066\u3044\u308B\uFF09\n\n## \u5831\u544A\u65B9\u6CD5\uFF08MCP\u30C4\u30FC\u30EB\uFF09\n\n`report_extraction_error` MCP\u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u307E\u3059\uFF1A\n\n```\nreport_extraction_error(\n  entityName: string,      // \u30CE\u30FC\u30C8\u306B\u8A18\u8F09\u3055\u308C\u3066\u3044\u308B\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\n  errorType: \"false_positive\" | \"wrong_type\" | \"missed_entity\",\n  entityType?: string,     // \u73FE\u5728\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30BF\u30A4\u30D7\uFF08wrong_type \u3068 false_positive \u306E\u5834\u5408\uFF09\n  correctType?: string,    // \u6B63\u3057\u3044\u30BF\u30A4\u30D7\uFF08wrong_type \u306E\u5834\u5408\uFF09\n  noteId?: number,         // \u554F\u984C\u3092\u78BA\u8A8D\u3057\u305F\u30CE\u30FC\u30C8\u306EID\n  details?: string         // \u30A8\u30E9\u30FC\u306B\u95A2\u3059\u308B\u8FFD\u52A0\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\n)\n```\n\n## \u5831\u544A\u65B9\u6CD5\uFF08CLI\u306E\u4EE3\u66FF\u624B\u6BB5\uFF09\n\n```bash\n# \u8AA4\u691C\u51FA\u3092\u5831\u544A\nknowledgine feedback report \\\n  --entity \"the\" \\\n  --type false_positive \\\n  --entity-type concept \\\n  --details \"Common English article incorrectly extracted as entity\"\n\n# \u8AA4\u3063\u305F\u5206\u985E\u3092\u5831\u544A\nknowledgine feedback report \\\n  --entity \"TypeScript\" \\\n  --type wrong_type \\\n  --entity-type person \\\n  --correct-type technology\n\n# \u898B\u843D\u3068\u3057\u3092\u5831\u544A\nknowledgine feedback report \\\n  --entity \"Zod\" \\\n  --type missed_entity \\\n  --details \"Validation library used throughout packages/core but not extracted\"\n```\n\n## \u30B9\u30C6\u30C3\u30D7\u30D0\u30A4\u30B9\u30C6\u30C3\u30D7\u306E\u624B\u9806\n\n1. **\u30A8\u30E9\u30FC\u30BF\u30A4\u30D7\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u8AA4\u691C\u51FA\u3001\u8AA4\u3063\u305F\u5206\u985E\u3001\u898B\u843D\u3068\u3057\u306E\u3069\u308C\u304B\uFF1F\n2. **\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u5B58\u5728\u3059\u308B\u5834\u5408\u306F `search_entities` \u3067\u6B63\u78BA\u306A\u767B\u9332\u540D\u3092\u78BA\u8A8D\u3059\u308B\n3. **\u30CE\u30FC\u30C8ID\u3092\u30E1\u30E2\u3059\u308B** \u2014 \u7279\u5B9A\u306E\u30CE\u30FC\u30C8\u3067\u30A8\u30E9\u30FC\u3092\u78BA\u8A8D\u3057\u305F\u5834\u5408\u306F\u3001\u305D\u306EID\u3092\u8A18\u9332\u3059\u308B\n4. **report_extraction_error\u3092\u547C\u3073\u51FA\u3059** \u2014 \u8A72\u5F53\u3059\u308B\u3059\u3079\u3066\u306E\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u542B\u3081\u308B\n5. **\u9001\u4FE1\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u30C4\u30FC\u30EB\u304C\u6210\u529F\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u8FD4\u3057\u305F\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\n\n## \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u306E\u7BA1\u7406\n\n```bash\n# \u4FDD\u7559\u4E2D\u306E\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3092\u78BA\u8A8D\nknowledgine feedback list --status pending\n\n# \u7279\u5B9A\u306E\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3092\u9069\u7528\uFF08\u7BA1\u7406\u8005\u64CD\u4F5C\uFF09\nknowledgine feedback apply <id>\n\n# \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3092\u9069\u7528\u305B\u305A\u306B\u5374\u4E0B\nknowledgine feedback dismiss <id>\n\n# \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u306E\u7D71\u8A08\u3092\u78BA\u8A8D\nknowledgine feedback stats\n```\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- \u6700\u521D\u306B\u9AD8\u983B\u5EA6\u306E\u30A8\u30E9\u30FC\u3092\u5831\u544A\u3059\u308B\u2014\u2014\u6700\u3082\u5F71\u97FF\u304C\u5927\u304D\u3044\n- \u62BD\u51FA\u304C\u8AA4\u308A\u3067\u3042\u308B\u7406\u7531\u306B\u3064\u3044\u3066\u5177\u4F53\u7684\u306A\u8A73\u7D30\u3092\u542B\u3081\u308B\n- \u53EF\u80FD\u306A\u5834\u5408\u306F\u30CE\u30FC\u30C8ID\u3092\u53C2\u7167\u3057\u3066\u3001\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304B\u3089\u30A8\u30E9\u30FC\u3092\u78BA\u8A8D\u3067\u304D\u308B\u3088\u3046\u306B\u3059\u308B\n- \u691C\u7D22\u54C1\u8CEA\u3078\u306E\u5B9F\u969B\u306E\u5F71\u97FF\u304C\u306A\u3044\u8EFD\u5FAE\u306A\u30B1\u30FC\u30B9\u306F\u5831\u544A\u3057\u306A\u3044\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- \u5404\u30A8\u30E9\u30FC\u30BF\u30A4\u30D7\u306E\u8A73\u7D30\u306A\u8AAC\u660E\u3068\u4F8B\u306F `error-types.md` \u3092\u53C2\u7167\n- \u52B9\u679C\u7684\u306A\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u30EC\u30DD\u30FC\u30C8\u306E\u66F8\u304D\u65B9\u306F `feedback-guide.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

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

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

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

@@ -0,0 +1,108 @@
+export const SKILL_MD = `---
+name: knowledgine-feedback
+version: "1.0.0"
+lang: ja
+description: >
+  ナレッジベースの品質を向上させるために、誤った・欠落している・誤分類されたエンティティ抽出を
+  報告します。存在すべきでないエンティティ（false_positive）、誤ったタイプに分類されたエンティティ
+  （wrong_type）、または実在するが抽出されなかったエンティティ（missed_entity）を発見したときに
+  呼び出してください。
+---
+# knowledgine-feedback
+
+## 目的
+
+エラーを報告することで、自動エンティティ抽出の品質を改善します。フィードバックは保存され、
+抽出ルールの更新に適用できます。これにより、将来のインジェストで同じエラーが繰り返されることを防ぎます。
+
+## 使用するタイミング
+
+- **誤検出（false positive）を発見したとき** — 実際には固有表現ではないエンティティが
+  抽出された場合（例：一般的な英単語が「technology」エンティティとして抽出された）
+- **誤った分類（wrong type）を発見したとき** — エンティティは存在するが誤分類されている場合
+  （例：「TypeScript」が「technology」ではなく「person」として分類されている）
+- **見落とし（missed entity）を発見したとき** — 重要なエンティティがまったく抽出されなかった場合
+  （例：頻繁に登場するライブラリ名にエンティティレコードがない）
+
+## 使用しないタイミング
+
+- エンティティ抽出の品質が許容範囲内のとき——軽微な不精確さは正常
+- エンティティの重要性に関する主観的な意見の相違（エンティティが抽出されていないことが
+  常に見落としを意味するわけではない——抽出器は信頼度閾値を使用している）
+
+## 報告方法（MCPツール）
+
+\`report_extraction_error\` MCPツールを使用します：
+
+\`\`\`
+report_extraction_error(
+  entityName: string,      // ノートに記載されているエンティティ名
+  errorType: "false_positive" | "wrong_type" | "missed_entity",
+  entityType?: string,     // 現在のエンティティタイプ（wrong_type と false_positive の場合）
+  correctType?: string,    // 正しいタイプ（wrong_type の場合）
+  noteId?: number,         // 問題を確認したノートのID
+  details?: string         // エラーに関する追加コンテキスト
+)
+\`\`\`
+
+## 報告方法（CLIの代替手段）
+
+\`\`\`bash
+# 誤検出を報告
+knowledgine feedback report \\
+  --entity "the" \\
+  --type false_positive \\
+  --entity-type concept \\
+  --details "Common English article incorrectly extracted as entity"
+
+# 誤った分類を報告
+knowledgine feedback report \\
+  --entity "TypeScript" \\
+  --type wrong_type \\
+  --entity-type person \\
+  --correct-type technology
+
+# 見落としを報告
+knowledgine feedback report \\
+  --entity "Zod" \\
+  --type missed_entity \\
+  --details "Validation library used throughout packages/core but not extracted"
+\`\`\`
+
+## ステップバイステップの手順
+
+1. **エラータイプを特定する** — 誤検出、誤った分類、見落としのどれか？
+2. **エンティティ名を確認する** — 存在する場合は \`search_entities\` で正確な登録名を確認する
+3. **ノートIDをメモする** — 特定のノートでエラーを確認した場合は、そのIDを記録する
+4. **report_extraction_errorを呼び出す** — 該当するすべてのパラメータを含める
+5. **送信を確認する** — ツールが成功レスポンスを返したことを確認する
+
+## フィードバックの管理
+
+\`\`\`bash
+# 保留中のフィードバックを確認
+knowledgine feedback list --status pending
+
+# 特定のフィードバックを適用（管理者操作）
+knowledgine feedback apply <id>
+
+# フィードバックを適用せずに却下
+knowledgine feedback dismiss <id>
+
+# フィードバックの統計を確認
+knowledgine feedback stats
+\`\`\`
+
+## ベストプラクティス
+
+- 最初に高頻度のエラーを報告する——最も影響が大きい
+- 抽出が誤りである理由について具体的な詳細を含める
+- 可能な場合はノートIDを参照して、コンテキストからエラーを確認できるようにする
+- 検索品質への実際の影響がない軽微なケースは報告しない
+
+## 参照ファイル
+
+- 各エラータイプの詳細な説明と例は \`error-types.md\` を参照
+- 効果的なフィードバックレポートの書き方は \`feedback-guide.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

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

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

package/dist/templates/skills/knowledgine-feedback/skill-md.js

@@ -1,5 +1,7 @@
 export const SKILL_MD = `---
 name: knowledgine-feedback
+version: "1.0.0"
+lang: en
 description: >
   Report incorrect, missing, or misclassified entity extractions to improve knowledge
   base quality. Invoke when you notice an entity that should not exist (false positive),
@@ -36,10 +38,10 @@ Use the \`report_extraction_error\` MCP tool:
 \`\`\`
 report_extraction_error(
   entityName: string,      // The entity name as it appears in the note
-  errorType: string,       // "false_positive" | "wrong_type" | "missed_entity"
+  errorType: "false_positive" | "wrong_type" | "missed_entity",
   entityType?: string,     // Current entity type (for wrong_type and false_positive)
   correctType?: string,    // What the type should be (for wrong_type)
-  noteId?: string,         // ID of the note where the issue was observed
+  noteId?: number,         // ID of the note where the issue was observed
   details?: string         // Additional context about the error
 )
 \`\`\`

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

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

package/dist/templates/skills/knowledgine-ingest/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-ingest/references.ja.d.ts.map

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

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

@@ -0,0 +1,244 @@
+export const REFERENCES = {
+    "plugin-guide.md": `# プラグインガイド
+
+knowledgine インジェストプラグインの詳細ドキュメント。
+
+---
+
+## markdown
+
+**Plugin ID**: \`markdown\`
+**ソース**: ナレッジベースディレクトリ内のローカル Markdown ファイル
+
+\`knowledgine init\` で使用されるデフォルトプラグイン。設定済みのルートディレクトリを
+スキャンして \`.md\` ファイルをインデックスする。
+
+\`\`\`bash
+knowledgine ingest --source markdown --path ~/notes
+\`\`\`
+
+**キャプチャ内容**: Markdown ファイルの全文、フロントマターのメタデータ、見出し、
+コードブロック。
+
+**増分対応**: あり。ファイルの更新日時を追跡し、変更されたファイルのみ再インジェストする。
+
+---
+
+## git-history
+
+**Plugin ID**: \`git-history\`
+**ソース**: Git リポジトリのコミット履歴
+
+Git コミットメッセージと関連する差分から知識を抽出する。特定のファイルの
+過去の設計上の意思決定や変遷を理解するのに有用。
+
+\`\`\`bash
+knowledgine ingest --source git-history --path ~/project
+\`\`\`
+
+**キャプチャ内容**: コミットメッセージ（特に \`feat:\`、\`fix:\`、\`refactor:\` などの
+Conventional Commits プレフィックス）、変更されたファイルパス、コミットのメタデータ。
+
+**前提条件**: Git リポジトリ内で実行するか、\`--path\` でリポジトリを指定する必要がある。
+
+**増分対応**: あり。最後に処理したコミットハッシュを追跡する。
+
+**ヒント**:
+- 初回セットアップ時に \`--full\` を付けて実行し、完全な履歴を取得する
+- Conventional Commits 形式のコミットメッセージを使用すると、より高品質なキャプチャが得られる
+
+---
+
+## github
+
+**Plugin ID**: \`github\`
+**ソース**: GitHub Pull Request と Issue
+
+GitHub リポジトリから PR の説明、Issue の本文、コメントを取得する。
+設計上の議論、バグ報告、意思決定の根拠をキャプチャする。
+
+\`\`\`bash
+GITHUB_TOKEN=<token> knowledgine ingest --source github --repo owner/repo --path ~/project
+\`\`\`
+
+**前提条件**:
+- \`repo\` スコープ（公開リポジトリは \`public_repo\`）を持つ \`GITHUB_TOKEN\` 環境変数
+- リポジトリを指定する \`--repo\` フラグ（形式: \`owner/repo\`）
+
+**キャプチャ内容**: PR のタイトルと本文、Issue のタイトルと本文、ラベル。
+
+**レート制限**: 認証済みリクエストを使用；トークンあり 5000 リクエスト/時間。
+
+**増分対応**: あり。最後に取得したアイテム番号を追跡する。
+
+---
+
+## obsidian
+
+**Plugin ID**: \`obsidian\`
+**ソース**: Obsidian Vault の Markdown ノート
+
+Obsidian Vault からノートをインポートし、内部リンクとタグを保持する。
+
+\`\`\`bash
+knowledgine ingest --source obsidian --path ~/vault
+\`\`\`
+
+**キャプチャ内容**: ノートの内容、Obsidian タグ（knowledgine タグに変換）、
+WikiLink、フロントマター。
+
+**前提条件**: Obsidian Vault ディレクトリにアクセスできること。特別な設定は不要—
+Obsidian はノートをプレーンな Markdown として保存する。
+
+**ヒント**:
+- Vault を再編成した後は \`--full\` を使用する
+- \`#private\` または \`#ignore\` タグが付いたノートはプラグイン設定で除外できる
+
+---
+
+## claude-sessions
+
+**Plugin ID**: \`claude-sessions\`
+**ソース**: Claude Code セッション履歴
+
+セッション履歴に保存された過去の Claude Code セッションのコンテキストをインポートする。
+
+\`\`\`bash
+knowledgine ingest --source claude-sessions --path ~/project
+\`\`\`
+
+**キャプチャ内容**: セッションのサマリー、過去の Claude Code セッション中に記録された
+主要な意思決定と発見。
+
+**保存場所**: Claude Code はセッション履歴を
+\`~/.claude/projects/<project-hash>/\` に保存する。
+
+---
+
+## cursor-sessions
+
+**Plugin ID**: \`cursor-sessions\`
+**ソース**: Cursor IDE セッション履歴
+
+Cursor IDE の AI 会話履歴から知識をインポートする。
+
+\`\`\`bash
+knowledgine ingest --source cursor-sessions --path ~/project
+\`\`\`
+
+**キャプチャ内容**: コードの意思決定、バグ修正、アーキテクチャの議論を含む
+Cursor AI の会話内容。
+
+**保存場所**: Cursor はセッションデータを SQLite ワークスペースデータベースに保存する。
+
+---
+
+## cicd
+
+**Plugin ID**: \`cicd\`
+**ソース**: CI/CD パイプラインの結果（GitHub Actions）
+
+CI/CD パイプラインの結果、失敗したテスト結果、デプロイ記録をインポートする。
+
+\`\`\`bash
+GITHUB_TOKEN=<token> knowledgine ingest --source cicd --repo owner/repo --path ~/project
+\`\`\`
+
+**キャプチャ内容**: ワークフロー実行のサマリー、失敗したジョブの詳細、デプロイイベント。
+
+**前提条件**: \`GITHUB_TOKEN\` と \`--repo\` フラグ（github プラグインと同様）。
+
+**ユースケース**: CI 履歴から不安定なテスト、インフラの問題、デプロイパターンに
+関する知識を構築する。
+`,
+    "source-types.md": `# ソースタイプと設定
+
+各インジェストソースの設定要件と環境変数。
+
+---
+
+## 設定サマリー
+
+| ソース | 必須設定 | オプション設定 |
+|--------|----------------|-----------------|
+| \`markdown\` | \`--path\`（ナレッジベースディレクトリ） | — |
+| \`git-history\` | \`--path\`（Git リポジトリディレクトリ） | \`--full\` でカーソルをリセット |
+| \`github\` | \`GITHUB_TOKEN\`、\`--repo\` | \`--full\` |
+| \`obsidian\` | \`--path\`（Vault ディレクトリ） | \`--full\` |
+| \`claude-sessions\` | \`--path\` | — |
+| \`cursor-sessions\` | \`--path\` | — |
+| \`cicd\` | \`GITHUB_TOKEN\`、\`--repo\` | \`--full\` |
+
+---
+
+## 環境変数
+
+### GITHUB_TOKEN
+
+\`github\` と \`cicd\` プラグインで必要。
+
+\`\`\`bash
+# シェルで設定
+export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
+
+# またはコマンドに前置する
+GITHUB_TOKEN=ghp_xxx knowledgine ingest --source github --repo owner/repo
+\`\`\`
+
+**必要なスコープ**:
+- 公開リポジトリ: \`public_repo\`
+- プライベートリポジトリ: \`repo\`
+- CI/CD 用: \`workflow\` スコープを追加
+
+**トークンの作成**:
+GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
+
+---
+
+## カーソル状態の管理
+
+各プラグインは増分インジェストを可能にするため「カーソル」（最後に処理した位置）を追跡する。
+カーソル状態を確認してリセットできる:
+
+\`\`\`bash
+# すべてのプラグインのカーソル状態を確認
+knowledgine plugins status --path ~/project
+
+# カーソルをリセットして完全な再インジェストを強制
+knowledgine ingest --source <plugin> --full --path ~/project
+\`\`\`
+
+---
+
+## 複数プラグインの実行
+
+\`\`\`bash
+# 登録済みプラグインをすべて順番に実行
+knowledgine ingest --all --path ~/project
+
+# 登録済みプラグインを確認
+knowledgine plugins list
+\`\`\`
+
+---
+
+## トラブルシューティング
+
+### "No plugin registered with ID: xxx"
+プラグインが登録されていない。\`knowledgine plugins list\` でプラグイン ID のスペルを確認する。
+
+### "GITHUB_TOKEN not set"
+github または cicd プラグインを実行する前に \`GITHUB_TOKEN\` 環境変数を設定する。
+
+### "Repository not found"
+\`--repo\` フラグが \`owner/repo\` 形式になっているか、トークンがリポジトリへのアクセス権を
+持っているか確認する。
+
+### インジェストで 0 件のノートが生成された
+- \`--path\` が正しいディレクトリを指しているか確認する
+- git-history の場合: パスに .git ディレクトリが含まれているか確認する
+- obsidian の場合: パスに .md ファイルが含まれているか確認する
+- \`--full\` を試してカーソルをリセットし、すべてのコンテンツを再処理する
+`,
+};
+//# sourceMappingURL=references.ja.js.map

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

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