@knowledgine/cli 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (146) hide show
  1. package/dist/commands/ingest.d.ts +4 -0
  2. package/dist/commands/ingest.d.ts.map +1 -1
  3. package/dist/commands/ingest.js +55 -13
  4. package/dist/commands/ingest.js.map +1 -1
  5. package/dist/commands/init.d.ts.map +1 -1
  6. package/dist/commands/init.js +15 -8
  7. package/dist/commands/init.js.map +1 -1
  8. package/dist/commands/search.d.ts +1 -0
  9. package/dist/commands/search.d.ts.map +1 -1
  10. package/dist/commands/search.js +45 -1
  11. package/dist/commands/search.js.map +1 -1
  12. package/dist/commands/serve.d.ts.map +1 -1
  13. package/dist/commands/serve.js +13 -2
  14. package/dist/commands/serve.js.map +1 -1
  15. package/dist/commands/setup-skills.d.ts +3 -1
  16. package/dist/commands/setup-skills.d.ts.map +1 -1
  17. package/dist/commands/setup-skills.js +24 -7
  18. package/dist/commands/setup-skills.js.map +1 -1
  19. package/dist/commands/setup.d.ts +2 -0
  20. package/dist/commands/setup.d.ts.map +1 -1
  21. package/dist/commands/setup.js +23 -3
  22. package/dist/commands/setup.js.map +1 -1
  23. package/dist/index.js +18 -1
  24. package/dist/index.js.map +1 -1
  25. package/dist/templates/skills/index.d.ts +8 -5
  26. package/dist/templates/skills/index.d.ts.map +1 -1
  27. package/dist/templates/skills/index.js +56 -41
  28. package/dist/templates/skills/index.js.map +1 -1
  29. package/dist/templates/skills/knowledgine-capture/references.ja.d.ts +2 -0
  30. package/dist/templates/skills/knowledgine-capture/references.ja.d.ts.map +1 -0
  31. package/dist/templates/skills/knowledgine-capture/references.ja.js +414 -0
  32. package/dist/templates/skills/knowledgine-capture/references.ja.js.map +1 -0
  33. package/dist/templates/skills/knowledgine-capture/skill-md.d.ts +1 -1
  34. package/dist/templates/skills/knowledgine-capture/skill-md.d.ts.map +1 -1
  35. package/dist/templates/skills/knowledgine-capture/skill-md.ja.d.ts +2 -0
  36. package/dist/templates/skills/knowledgine-capture/skill-md.ja.d.ts.map +1 -0
  37. package/dist/templates/skills/knowledgine-capture/skill-md.ja.js +98 -0
  38. package/dist/templates/skills/knowledgine-capture/skill-md.ja.js.map +1 -0
  39. package/dist/templates/skills/knowledgine-capture/skill-md.js +4 -2
  40. package/dist/templates/skills/knowledgine-capture/skill-md.js.map +1 -1
  41. package/dist/templates/skills/knowledgine-debrief/references.ja.d.ts +2 -0
  42. package/dist/templates/skills/knowledgine-debrief/references.ja.d.ts.map +1 -0
  43. package/dist/templates/skills/knowledgine-debrief/references.ja.js +141 -0
  44. package/dist/templates/skills/knowledgine-debrief/references.ja.js.map +1 -0
  45. package/dist/templates/skills/knowledgine-debrief/skill-md.d.ts +1 -1
  46. package/dist/templates/skills/knowledgine-debrief/skill-md.d.ts.map +1 -1
  47. package/dist/templates/skills/knowledgine-debrief/skill-md.ja.d.ts +2 -0
  48. package/dist/templates/skills/knowledgine-debrief/skill-md.ja.d.ts.map +1 -0
  49. package/dist/templates/skills/knowledgine-debrief/skill-md.ja.js +82 -0
  50. package/dist/templates/skills/knowledgine-debrief/skill-md.ja.js.map +1 -0
  51. package/dist/templates/skills/knowledgine-debrief/skill-md.js +10 -2
  52. package/dist/templates/skills/knowledgine-debrief/skill-md.js.map +1 -1
  53. package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.d.ts.map +1 -1
  54. package/dist/templates/skills/knowledgine-explore/references.ja.d.ts +2 -0
  55. package/dist/templates/skills/knowledgine-explore/references.ja.d.ts.map +1 -0
  56. package/dist/templates/skills/knowledgine-explore/references.ja.js +182 -0
  57. package/dist/templates/skills/knowledgine-explore/references.ja.js.map +1 -0
  58. package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.js +15 -15
  59. package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.js.map +1 -1
  60. package/dist/templates/skills/knowledgine-explore/skill-md.d.ts +2 -0
  61. package/dist/templates/skills/knowledgine-explore/skill-md.d.ts.map +1 -0
  62. package/dist/templates/skills/knowledgine-explore/skill-md.ja.d.ts +2 -0
  63. package/dist/templates/skills/knowledgine-explore/skill-md.ja.d.ts.map +1 -0
  64. package/dist/templates/skills/knowledgine-explore/skill-md.ja.js +98 -0
  65. package/dist/templates/skills/knowledgine-explore/skill-md.ja.js.map +1 -0
  66. package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/skill-md.js +19 -12
  67. package/dist/templates/skills/{knowledgine-suggest → knowledgine-explore}/skill-md.js.map +1 -1
  68. package/dist/templates/skills/knowledgine-feedback/references.ja.d.ts +2 -0
  69. package/dist/templates/skills/knowledgine-feedback/references.ja.d.ts.map +1 -0
  70. package/dist/templates/skills/knowledgine-feedback/references.ja.js +214 -0
  71. package/dist/templates/skills/knowledgine-feedback/references.ja.js.map +1 -0
  72. package/dist/templates/skills/knowledgine-feedback/skill-md.d.ts +1 -1
  73. package/dist/templates/skills/knowledgine-feedback/skill-md.d.ts.map +1 -1
  74. package/dist/templates/skills/knowledgine-feedback/skill-md.ja.d.ts +2 -0
  75. package/dist/templates/skills/knowledgine-feedback/skill-md.ja.d.ts.map +1 -0
  76. package/dist/templates/skills/knowledgine-feedback/skill-md.ja.js +108 -0
  77. package/dist/templates/skills/knowledgine-feedback/skill-md.ja.js.map +1 -0
  78. package/dist/templates/skills/knowledgine-feedback/skill-md.js +4 -2
  79. package/dist/templates/skills/knowledgine-feedback/skill-md.js.map +1 -1
  80. package/dist/templates/skills/knowledgine-ingest/references.ja.d.ts +2 -0
  81. package/dist/templates/skills/knowledgine-ingest/references.ja.d.ts.map +1 -0
  82. package/dist/templates/skills/knowledgine-ingest/references.ja.js +244 -0
  83. package/dist/templates/skills/knowledgine-ingest/references.ja.js.map +1 -0
  84. package/dist/templates/skills/knowledgine-ingest/skill-md.d.ts +1 -1
  85. package/dist/templates/skills/knowledgine-ingest/skill-md.d.ts.map +1 -1
  86. package/dist/templates/skills/knowledgine-ingest/skill-md.ja.d.ts +2 -0
  87. package/dist/templates/skills/knowledgine-ingest/skill-md.ja.d.ts.map +1 -0
  88. package/dist/templates/skills/knowledgine-ingest/skill-md.ja.js +81 -0
  89. package/dist/templates/skills/knowledgine-ingest/skill-md.ja.js.map +1 -0
  90. package/dist/templates/skills/knowledgine-ingest/skill-md.js +2 -0
  91. package/dist/templates/skills/knowledgine-ingest/skill-md.js.map +1 -1
  92. package/dist/templates/skills/{knowledgine-recall → knowledgine-memory}/references.d.ts.map +1 -1
  93. package/dist/templates/skills/knowledgine-memory/references.ja.d.ts +2 -0
  94. package/dist/templates/skills/knowledgine-memory/references.ja.d.ts.map +1 -0
  95. package/dist/templates/skills/knowledgine-memory/references.ja.js +188 -0
  96. package/dist/templates/skills/knowledgine-memory/references.ja.js.map +1 -0
  97. package/dist/templates/skills/knowledgine-memory/references.js +188 -0
  98. package/dist/templates/skills/knowledgine-memory/references.js.map +1 -0
  99. package/dist/templates/skills/knowledgine-memory/skill-md.d.ts +2 -0
  100. package/dist/templates/skills/knowledgine-memory/skill-md.d.ts.map +1 -0
  101. package/dist/templates/skills/knowledgine-memory/skill-md.ja.d.ts +2 -0
  102. package/dist/templates/skills/knowledgine-memory/skill-md.ja.d.ts.map +1 -0
  103. package/dist/templates/skills/knowledgine-memory/skill-md.ja.js +169 -0
  104. package/dist/templates/skills/knowledgine-memory/skill-md.ja.js.map +1 -0
  105. package/dist/templates/skills/knowledgine-memory/skill-md.js +169 -0
  106. package/dist/templates/skills/{knowledgine-recall → knowledgine-memory}/skill-md.js.map +1 -1
  107. package/dist/templates/skills/knowledgine-search/references.d.ts.map +1 -0
  108. package/dist/templates/skills/knowledgine-search/references.ja.d.ts +2 -0
  109. package/dist/templates/skills/knowledgine-search/references.ja.d.ts.map +1 -0
  110. package/dist/templates/skills/knowledgine-search/references.ja.js +313 -0
  111. package/dist/templates/skills/knowledgine-search/references.ja.js.map +1 -0
  112. package/dist/templates/skills/{knowledgine-recall → knowledgine-search}/references.js +124 -19
  113. package/dist/templates/skills/knowledgine-search/references.js.map +1 -0
  114. package/dist/templates/skills/knowledgine-search/skill-md.d.ts +2 -0
  115. package/dist/templates/skills/knowledgine-search/skill-md.d.ts.map +1 -0
  116. package/dist/templates/skills/knowledgine-search/skill-md.ja.d.ts +2 -0
  117. package/dist/templates/skills/knowledgine-search/skill-md.ja.d.ts.map +1 -0
  118. package/dist/templates/skills/knowledgine-search/skill-md.ja.js +175 -0
  119. package/dist/templates/skills/knowledgine-search/skill-md.ja.js.map +1 -0
  120. package/dist/templates/skills/knowledgine-search/skill-md.js +174 -0
  121. package/dist/templates/skills/knowledgine-search/skill-md.js.map +1 -0
  122. package/dist/templates/skills/types.d.ts +4 -0
  123. package/dist/templates/skills/types.d.ts.map +1 -0
  124. package/dist/templates/skills/types.js +3 -0
  125. package/dist/templates/skills/types.js.map +1 -0
  126. package/package.json +4 -4
  127. package/dist/lib/entity-extractor.d.ts +0 -17
  128. package/dist/lib/entity-extractor.d.ts.map +0 -1
  129. package/dist/lib/entity-extractor.js +0 -22
  130. package/dist/lib/entity-extractor.js.map +0 -1
  131. package/dist/templates/skills/knowledgine-explain/skill-md.d.ts +0 -2
  132. package/dist/templates/skills/knowledgine-explain/skill-md.d.ts.map +0 -1
  133. package/dist/templates/skills/knowledgine-explain/skill-md.js.map +0 -1
  134. package/dist/templates/skills/knowledgine-recall/references.js.map +0 -1
  135. package/dist/templates/skills/knowledgine-recall/skill-md.d.ts +0 -2
  136. package/dist/templates/skills/knowledgine-recall/skill-md.d.ts.map +0 -1
  137. package/dist/templates/skills/knowledgine-recall/skill-md.js +0 -86
  138. package/dist/templates/skills/knowledgine-suggest/references.d.ts.map +0 -1
  139. package/dist/templates/skills/knowledgine-suggest/references.js +0 -121
  140. package/dist/templates/skills/knowledgine-suggest/references.js.map +0 -1
  141. package/dist/templates/skills/knowledgine-suggest/skill-md.d.ts +0 -2
  142. package/dist/templates/skills/knowledgine-suggest/skill-md.d.ts.map +0 -1
  143. package/dist/templates/skills/knowledgine-suggest/skill-md.js +0 -94
  144. /package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.d.ts +0 -0
  145. /package/dist/templates/skills/{knowledgine-recall → knowledgine-memory}/references.d.ts +0 -0
  146. /package/dist/templates/skills/{knowledgine-suggest → knowledgine-search}/references.d.ts +0 -0
@@ -0,0 +1,244 @@
1
+ export const REFERENCES = {
2
+ "plugin-guide.md": `# プラグインガイド
3
+
4
+ knowledgine インジェストプラグインの詳細ドキュメント。
5
+
6
+ ---
7
+
8
+ ## markdown
9
+
10
+ **Plugin ID**: \`markdown\`
11
+ **ソース**: ナレッジベースディレクトリ内のローカル Markdown ファイル
12
+
13
+ \`knowledgine init\` で使用されるデフォルトプラグイン。設定済みのルートディレクトリを
14
+ スキャンして \`.md\` ファイルをインデックスする。
15
+
16
+ \`\`\`bash
17
+ knowledgine ingest --source markdown --path ~/notes
18
+ \`\`\`
19
+
20
+ **キャプチャ内容**: Markdown ファイルの全文、フロントマターのメタデータ、見出し、
21
+ コードブロック。
22
+
23
+ **増分対応**: あり。ファイルの更新日時を追跡し、変更されたファイルのみ再インジェストする。
24
+
25
+ ---
26
+
27
+ ## git-history
28
+
29
+ **Plugin ID**: \`git-history\`
30
+ **ソース**: Git リポジトリのコミット履歴
31
+
32
+ Git コミットメッセージと関連する差分から知識を抽出する。特定のファイルの
33
+ 過去の設計上の意思決定や変遷を理解するのに有用。
34
+
35
+ \`\`\`bash
36
+ knowledgine ingest --source git-history --path ~/project
37
+ \`\`\`
38
+
39
+ **キャプチャ内容**: コミットメッセージ(特に \`feat:\`、\`fix:\`、\`refactor:\` などの
40
+ Conventional Commits プレフィックス)、変更されたファイルパス、コミットのメタデータ。
41
+
42
+ **前提条件**: Git リポジトリ内で実行するか、\`--path\` でリポジトリを指定する必要がある。
43
+
44
+ **増分対応**: あり。最後に処理したコミットハッシュを追跡する。
45
+
46
+ **ヒント**:
47
+ - 初回セットアップ時に \`--full\` を付けて実行し、完全な履歴を取得する
48
+ - Conventional Commits 形式のコミットメッセージを使用すると、より高品質なキャプチャが得られる
49
+
50
+ ---
51
+
52
+ ## github
53
+
54
+ **Plugin ID**: \`github\`
55
+ **ソース**: GitHub Pull Request と Issue
56
+
57
+ GitHub リポジトリから PR の説明、Issue の本文、コメントを取得する。
58
+ 設計上の議論、バグ報告、意思決定の根拠をキャプチャする。
59
+
60
+ \`\`\`bash
61
+ GITHUB_TOKEN=<token> knowledgine ingest --source github --repo owner/repo --path ~/project
62
+ \`\`\`
63
+
64
+ **前提条件**:
65
+ - \`repo\` スコープ(公開リポジトリは \`public_repo\`)を持つ \`GITHUB_TOKEN\` 環境変数
66
+ - リポジトリを指定する \`--repo\` フラグ(形式: \`owner/repo\`)
67
+
68
+ **キャプチャ内容**: PR のタイトルと本文、Issue のタイトルと本文、ラベル。
69
+
70
+ **レート制限**: 認証済みリクエストを使用;トークンあり 5000 リクエスト/時間。
71
+
72
+ **増分対応**: あり。最後に取得したアイテム番号を追跡する。
73
+
74
+ ---
75
+
76
+ ## obsidian
77
+
78
+ **Plugin ID**: \`obsidian\`
79
+ **ソース**: Obsidian Vault の Markdown ノート
80
+
81
+ Obsidian Vault からノートをインポートし、内部リンクとタグを保持する。
82
+
83
+ \`\`\`bash
84
+ knowledgine ingest --source obsidian --path ~/vault
85
+ \`\`\`
86
+
87
+ **キャプチャ内容**: ノートの内容、Obsidian タグ(knowledgine タグに変換)、
88
+ WikiLink、フロントマター。
89
+
90
+ **前提条件**: Obsidian Vault ディレクトリにアクセスできること。特別な設定は不要—
91
+ Obsidian はノートをプレーンな Markdown として保存する。
92
+
93
+ **ヒント**:
94
+ - Vault を再編成した後は \`--full\` を使用する
95
+ - \`#private\` または \`#ignore\` タグが付いたノートはプラグイン設定で除外できる
96
+
97
+ ---
98
+
99
+ ## claude-sessions
100
+
101
+ **Plugin ID**: \`claude-sessions\`
102
+ **ソース**: Claude Code セッション履歴
103
+
104
+ セッション履歴に保存された過去の Claude Code セッションのコンテキストをインポートする。
105
+
106
+ \`\`\`bash
107
+ knowledgine ingest --source claude-sessions --path ~/project
108
+ \`\`\`
109
+
110
+ **キャプチャ内容**: セッションのサマリー、過去の Claude Code セッション中に記録された
111
+ 主要な意思決定と発見。
112
+
113
+ **保存場所**: Claude Code はセッション履歴を
114
+ \`~/.claude/projects/<project-hash>/\` に保存する。
115
+
116
+ ---
117
+
118
+ ## cursor-sessions
119
+
120
+ **Plugin ID**: \`cursor-sessions\`
121
+ **ソース**: Cursor IDE セッション履歴
122
+
123
+ Cursor IDE の AI 会話履歴から知識をインポートする。
124
+
125
+ \`\`\`bash
126
+ knowledgine ingest --source cursor-sessions --path ~/project
127
+ \`\`\`
128
+
129
+ **キャプチャ内容**: コードの意思決定、バグ修正、アーキテクチャの議論を含む
130
+ Cursor AI の会話内容。
131
+
132
+ **保存場所**: Cursor はセッションデータを SQLite ワークスペースデータベースに保存する。
133
+
134
+ ---
135
+
136
+ ## cicd
137
+
138
+ **Plugin ID**: \`cicd\`
139
+ **ソース**: CI/CD パイプラインの結果(GitHub Actions)
140
+
141
+ CI/CD パイプラインの結果、失敗したテスト結果、デプロイ記録をインポートする。
142
+
143
+ \`\`\`bash
144
+ GITHUB_TOKEN=<token> knowledgine ingest --source cicd --repo owner/repo --path ~/project
145
+ \`\`\`
146
+
147
+ **キャプチャ内容**: ワークフロー実行のサマリー、失敗したジョブの詳細、デプロイイベント。
148
+
149
+ **前提条件**: \`GITHUB_TOKEN\` と \`--repo\` フラグ(github プラグインと同様)。
150
+
151
+ **ユースケース**: CI 履歴から不安定なテスト、インフラの問題、デプロイパターンに
152
+ 関する知識を構築する。
153
+ `,
154
+ "source-types.md": `# ソースタイプと設定
155
+
156
+ 各インジェストソースの設定要件と環境変数。
157
+
158
+ ---
159
+
160
+ ## 設定サマリー
161
+
162
+ | ソース | 必須設定 | オプション設定 |
163
+ |--------|----------------|-----------------|
164
+ | \`markdown\` | \`--path\`(ナレッジベースディレクトリ) | — |
165
+ | \`git-history\` | \`--path\`(Git リポジトリディレクトリ) | \`--full\` でカーソルをリセット |
166
+ | \`github\` | \`GITHUB_TOKEN\`、\`--repo\` | \`--full\` |
167
+ | \`obsidian\` | \`--path\`(Vault ディレクトリ) | \`--full\` |
168
+ | \`claude-sessions\` | \`--path\` | — |
169
+ | \`cursor-sessions\` | \`--path\` | — |
170
+ | \`cicd\` | \`GITHUB_TOKEN\`、\`--repo\` | \`--full\` |
171
+
172
+ ---
173
+
174
+ ## 環境変数
175
+
176
+ ### GITHUB_TOKEN
177
+
178
+ \`github\` と \`cicd\` プラグインで必要。
179
+
180
+ \`\`\`bash
181
+ # シェルで設定
182
+ export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
183
+
184
+ # またはコマンドに前置する
185
+ GITHUB_TOKEN=ghp_xxx knowledgine ingest --source github --repo owner/repo
186
+ \`\`\`
187
+
188
+ **必要なスコープ**:
189
+ - 公開リポジトリ: \`public_repo\`
190
+ - プライベートリポジトリ: \`repo\`
191
+ - CI/CD 用: \`workflow\` スコープを追加
192
+
193
+ **トークンの作成**:
194
+ GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
195
+
196
+ ---
197
+
198
+ ## カーソル状態の管理
199
+
200
+ 各プラグインは増分インジェストを可能にするため「カーソル」(最後に処理した位置)を追跡する。
201
+ カーソル状態を確認してリセットできる:
202
+
203
+ \`\`\`bash
204
+ # すべてのプラグインのカーソル状態を確認
205
+ knowledgine plugins status --path ~/project
206
+
207
+ # カーソルをリセットして完全な再インジェストを強制
208
+ knowledgine ingest --source <plugin> --full --path ~/project
209
+ \`\`\`
210
+
211
+ ---
212
+
213
+ ## 複数プラグインの実行
214
+
215
+ \`\`\`bash
216
+ # 登録済みプラグインをすべて順番に実行
217
+ knowledgine ingest --all --path ~/project
218
+
219
+ # 登録済みプラグインを確認
220
+ knowledgine plugins list
221
+ \`\`\`
222
+
223
+ ---
224
+
225
+ ## トラブルシューティング
226
+
227
+ ### "No plugin registered with ID: xxx"
228
+ プラグインが登録されていない。\`knowledgine plugins list\` でプラグイン ID のスペルを確認する。
229
+
230
+ ### "GITHUB_TOKEN not set"
231
+ github または cicd プラグインを実行する前に \`GITHUB_TOKEN\` 環境変数を設定する。
232
+
233
+ ### "Repository not found"
234
+ \`--repo\` フラグが \`owner/repo\` 形式になっているか、トークンがリポジトリへのアクセス権を
235
+ 持っているか確認する。
236
+
237
+ ### インジェストで 0 件のノートが生成された
238
+ - \`--path\` が正しいディレクトリを指しているか確認する
239
+ - git-history の場合: パスに .git ディレクトリが含まれているか確認する
240
+ - obsidian の場合: パスに .md ファイルが含まれているか確認する
241
+ - \`--full\` を試してカーソルをリセットし、すべてのコンテンツを再処理する
242
+ `,
243
+ };
244
+ //# sourceMappingURL=references.ja.js.map
@@ -0,0 +1 @@
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"}
@@ -1,2 +1,2 @@
1
- export declare const SKILL_MD = "---\nname: knowledgine-ingest\ndescription: >\n Import knowledge from external sources into the local knowledge base. Invoke when\n the user wants to import from Git commit history, GitHub PRs and issues, Obsidian\n vaults, Claude or Cursor session histories, or CI/CD pipelines. Each source requires\n a specific plugin and configuration.\n---\n# knowledgine-ingest\n\n## Purpose\n\nPopulate the knowledge base from external knowledge repositories \u2014 version control\nhistory, issue trackers, personal note systems, AI session logs \u2014 without manual\ncapture. Ingestion enriches the knowledge base with historical context that predates\nthe current session.\n\n## When to Use\n\n- **Onboarding to a codebase** \u2014 Ingest Git history to capture past decisions\n- **Integrating GitHub knowledge** \u2014 Import PRs and issues for context\n- **Importing Obsidian notes** \u2014 Bring personal or team notes into the knowledge base\n- **Capturing AI session history** \u2014 Import Claude or Cursor session logs\n- **Building CI knowledge** \u2014 Import CI/CD pipeline outcomes and patterns\n- **User explicitly requests import** \u2014 \"Load my notes from Obsidian\"\n\n## When NOT to Use\n\n- When the source has already been fully ingested in this session (check cursor state)\n- When the user has not configured the required credentials (e.g., GITHUB_TOKEN)\n\n## How to Ingest (CLI)\n\n```bash\n# Run a specific plugin\nknowledgine ingest --source <plugin-id> --path <knowledge-base-path>\n\n# Run all registered plugins\nknowledgine ingest --all --path <knowledge-base-path>\n\n# Force full re-ingest (ignore stored cursor)\nknowledgine ingest --source <plugin-id> --full --path <knowledge-base-path>\n\n# GitHub-specific (requires GITHUB_TOKEN env var)\nknowledgine ingest --source github --repo owner/repo --path <path>\n```\n\n## Available Source Plugins\n\n| Plugin ID | Source | Notes |\n|-----------|--------|-------|\n| `markdown` | Local markdown files | Default; used by `knowledgine init` |\n| `git-history` | Git commit messages and diffs | Extracts decisions from commit history |\n| `github` | GitHub PRs and issues | Requires `GITHUB_TOKEN` env var |\n| `obsidian` | Obsidian vault notes | Reads from configured vault path |\n| `claude-sessions` | Claude Code session logs | Imports past AI session context |\n| `cursor-sessions` | Cursor IDE session history | Imports Cursor session context |\n| `cicd` | CI/CD pipeline results | GitHub Actions, build outcomes |\n\n## Step-by-Step Instructions\n\n1. **Identify the source** \u2014 Which external system contains the knowledge to import?\n2. **Check prerequisites** \u2014 Does the plugin need credentials or configuration? (see plugin-guide.md)\n3. **Run the ingest command** \u2014 Use the appropriate plugin ID and options\n4. **Verify results** \u2014 Run `knowledgine status` or search to confirm notes were imported\n5. **Re-ingest if needed** \u2014 Use `--full` flag to re-process already-seen content\n\n## Best Practices\n\n- Run `git-history` ingest when starting work on a new repository\n- Set `GITHUB_TOKEN` before ingesting GitHub content to avoid rate limiting\n- Use `--full` flag after changing ingest configuration\n- Check `knowledgine plugins status` to see the last ingest cursor for each plugin\n\n## Reference Files\n\n- See `plugin-guide.md` for detailed documentation on each plugin\n- See `source-types.md` for configuration requirements for each source type\n";
1
+ export declare const SKILL_MD = "---\nname: knowledgine-ingest\nversion: \"1.0.0\"\nlang: en\ndescription: >\n Import knowledge from external sources into the local knowledge base. Invoke when\n the user wants to import from Git commit history, GitHub PRs and issues, Obsidian\n vaults, Claude or Cursor session histories, or CI/CD pipelines. Each source requires\n a specific plugin and configuration.\n---\n# knowledgine-ingest\n\n## Purpose\n\nPopulate the knowledge base from external knowledge repositories \u2014 version control\nhistory, issue trackers, personal note systems, AI session logs \u2014 without manual\ncapture. Ingestion enriches the knowledge base with historical context that predates\nthe current session.\n\n## When to Use\n\n- **Onboarding to a codebase** \u2014 Ingest Git history to capture past decisions\n- **Integrating GitHub knowledge** \u2014 Import PRs and issues for context\n- **Importing Obsidian notes** \u2014 Bring personal or team notes into the knowledge base\n- **Capturing AI session history** \u2014 Import Claude or Cursor session logs\n- **Building CI knowledge** \u2014 Import CI/CD pipeline outcomes and patterns\n- **User explicitly requests import** \u2014 \"Load my notes from Obsidian\"\n\n## When NOT to Use\n\n- When the source has already been fully ingested in this session (check cursor state)\n- When the user has not configured the required credentials (e.g., GITHUB_TOKEN)\n\n## How to Ingest (CLI)\n\n```bash\n# Run a specific plugin\nknowledgine ingest --source <plugin-id> --path <knowledge-base-path>\n\n# Run all registered plugins\nknowledgine ingest --all --path <knowledge-base-path>\n\n# Force full re-ingest (ignore stored cursor)\nknowledgine ingest --source <plugin-id> --full --path <knowledge-base-path>\n\n# GitHub-specific (requires GITHUB_TOKEN env var)\nknowledgine ingest --source github --repo owner/repo --path <path>\n```\n\n## Available Source Plugins\n\n| Plugin ID | Source | Notes |\n|-----------|--------|-------|\n| `markdown` | Local markdown files | Default; used by `knowledgine init` |\n| `git-history` | Git commit messages and diffs | Extracts decisions from commit history |\n| `github` | GitHub PRs and issues | Requires `GITHUB_TOKEN` env var |\n| `obsidian` | Obsidian vault notes | Reads from configured vault path |\n| `claude-sessions` | Claude Code session logs | Imports past AI session context |\n| `cursor-sessions` | Cursor IDE session history | Imports Cursor session context |\n| `cicd` | CI/CD pipeline results | GitHub Actions, build outcomes |\n\n## Step-by-Step Instructions\n\n1. **Identify the source** \u2014 Which external system contains the knowledge to import?\n2. **Check prerequisites** \u2014 Does the plugin need credentials or configuration? (see plugin-guide.md)\n3. **Run the ingest command** \u2014 Use the appropriate plugin ID and options\n4. **Verify results** \u2014 Run `knowledgine status` or search to confirm notes were imported\n5. **Re-ingest if needed** \u2014 Use `--full` flag to re-process already-seen content\n\n## Best Practices\n\n- Run `git-history` ingest when starting work on a new repository\n- Set `GITHUB_TOKEN` before ingesting GitHub content to avoid rate limiting\n- Use `--full` flag after changing ingest configuration\n- Check `knowledgine plugins status` to see the last ingest cursor for each plugin\n\n## Reference Files\n\n- See `plugin-guide.md` for detailed documentation on each plugin\n- See `source-types.md` for configuration requirements for each source type\n";
2
2
  //# sourceMappingURL=skill-md.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,q5GA8EpB,CAAC"}
1
+ {"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,m7GAgFpB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare const SKILL_MD = "---\nname: knowledgine-ingest\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n \u5916\u90E8\u30BD\u30FC\u30B9\u304B\u3089\u30ED\u30FC\u30AB\u30EB\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3078\u77E5\u8B58\u3092\u30A4\u30F3\u30DD\u30FC\u30C8\u3059\u308B\u3002Git \u30B3\u30DF\u30C3\u30C8\u5C65\u6B74\u3001\n GitHub \u306E PR\u30FBIssue\u3001Obsidian Vault\u3001Claude \u307E\u305F\u306F Cursor \u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u5C65\u6B74\u3001\n CI/CD \u30D1\u30A4\u30D7\u30E9\u30A4\u30F3\u304B\u3089\u306E\u30A4\u30F3\u30DD\u30FC\u30C8\u3092\u884C\u3046\u969B\u306B\u547C\u3073\u51FA\u3059\u3002\n \u5404\u30BD\u30FC\u30B9\u306B\u306F\u5C02\u7528\u30D7\u30E9\u30B0\u30A4\u30F3\u3068\u8A2D\u5B9A\u304C\u5FC5\u8981\u3002\n---\n# knowledgine-ingest\n\n## \u76EE\u7684\n\n\u30D0\u30FC\u30B8\u30E7\u30F3\u7BA1\u7406\u5C65\u6B74\u3001Issue \u30C8\u30E9\u30C3\u30AB\u30FC\u3001\u500B\u4EBA\u30CE\u30FC\u30C8\u30B7\u30B9\u30C6\u30E0\u3001AI \u30BB\u30C3\u30B7\u30E7\u30F3\u30ED\u30B0\u306A\u3069\u3001\n\u5916\u90E8\u30CA\u30EC\u30C3\u30B8\u30EA\u30DD\u30B8\u30C8\u30EA\u304B\u3089\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3078\u624B\u52D5\u30AD\u30E3\u30D7\u30C1\u30E3\u306A\u3057\u306B\u30C7\u30FC\u30BF\u3092\u6295\u5165\u3059\u308B\u3002\n\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u306B\u3088\u308A\u3001\u73FE\u30BB\u30C3\u30B7\u30E7\u30F3\u4EE5\u524D\u306E\u6B74\u53F2\u7684\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3067\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u304C\u5F37\u5316\u3055\u308C\u308B\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u30B3\u30FC\u30C9\u30D9\u30FC\u30B9\u3078\u306E\u30AA\u30F3\u30DC\u30FC\u30C7\u30A3\u30F3\u30B0** \u2014 Git \u5C65\u6B74\u3092\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u3057\u3066\u904E\u53BB\u306E\u610F\u601D\u6C7A\u5B9A\u3092\u628A\u63E1\u3059\u308B\n- **GitHub \u77E5\u8B58\u306E\u7D71\u5408** \u2014 PR \u3068 Issue \u3092\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3068\u3057\u3066\u30A4\u30F3\u30DD\u30FC\u30C8\u3059\u308B\n- **Obsidian \u30CE\u30FC\u30C8\u306E\u30A4\u30F3\u30DD\u30FC\u30C8** \u2014 \u500B\u4EBA\u307E\u305F\u306F\u30C1\u30FC\u30E0\u306E\u30CE\u30FC\u30C8\u3092\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306B\u53D6\u308A\u8FBC\u3080\n- **AI \u30BB\u30C3\u30B7\u30E7\u30F3\u5C65\u6B74\u306E\u30AD\u30E3\u30D7\u30C1\u30E3** \u2014 Claude \u307E\u305F\u306F Cursor \u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u30ED\u30B0\u3092\u30A4\u30F3\u30DD\u30FC\u30C8\u3059\u308B\n- **CI \u77E5\u8B58\u306E\u69CB\u7BC9** \u2014 CI/CD \u30D1\u30A4\u30D7\u30E9\u30A4\u30F3\u306E\u7D50\u679C\u3068\u30D1\u30BF\u30FC\u30F3\u3092\u30A4\u30F3\u30DD\u30FC\u30C8\u3059\u308B\n- **\u30E6\u30FC\u30B6\u30FC\u304C\u660E\u793A\u7684\u306B\u30A4\u30F3\u30DD\u30FC\u30C8\u3092\u8981\u6C42\u3057\u305F\u5834\u5408** \u2014 \u300CObsidian \u304B\u3089\u30CE\u30FC\u30C8\u3092\u8AAD\u307F\u8FBC\u3093\u3067\u300D\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u5F53\u30BB\u30C3\u30B7\u30E7\u30F3\u5185\u3067\u305D\u306E\u30BD\u30FC\u30B9\u304C\u3059\u3067\u306B\u5B8C\u5168\u306B\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u6E08\u307F\u306E\u5834\u5408\uFF08\u30AB\u30FC\u30BD\u30EB\u72B6\u614B\u3092\u78BA\u8A8D\uFF09\n- \u5FC5\u8981\u306A\u8A8D\u8A3C\u60C5\u5831\uFF08\u4F8B: GITHUB_TOKEN\uFF09\u3092\u30E6\u30FC\u30B6\u30FC\u304C\u8A2D\u5B9A\u3057\u3066\u3044\u306A\u3044\u5834\u5408\n\n## \u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u65B9\u6CD5\uFF08CLI\uFF09\n\n```bash\n# \u7279\u5B9A\u306E\u30D7\u30E9\u30B0\u30A4\u30F3\u3092\u5B9F\u884C\nknowledgine ingest --source <plugin-id> --path <knowledge-base-path>\n\n# \u767B\u9332\u6E08\u307F\u30D7\u30E9\u30B0\u30A4\u30F3\u3092\u3059\u3079\u3066\u5B9F\u884C\nknowledgine ingest --all --path <knowledge-base-path>\n\n# \u5B8C\u5168\u306A\u518D\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u3092\u5F37\u5236\uFF08\u4FDD\u5B58\u6E08\u307F\u30AB\u30FC\u30BD\u30EB\u3092\u7121\u8996\uFF09\nknowledgine ingest --source <plugin-id> --full --path <knowledge-base-path>\n\n# GitHub \u5C02\u7528\uFF08GITHUB_TOKEN \u74B0\u5883\u5909\u6570\u304C\u5FC5\u8981\uFF09\nknowledgine ingest --source github --repo owner/repo --path <path>\n```\n\n## \u5229\u7528\u53EF\u80FD\u306A\u30BD\u30FC\u30B9\u30D7\u30E9\u30B0\u30A4\u30F3\n\n| Plugin ID | \u30BD\u30FC\u30B9 | \u5099\u8003 |\n|-----------|--------|-------|\n| `markdown` | \u30ED\u30FC\u30AB\u30EB\u306E Markdown \u30D5\u30A1\u30A4\u30EB | \u30C7\u30D5\u30A9\u30EB\u30C8\uFF1B`knowledgine init` \u3067\u4F7F\u7528 |\n| `git-history` | Git \u30B3\u30DF\u30C3\u30C8\u30E1\u30C3\u30BB\u30FC\u30B8\u3068\u5DEE\u5206 | \u30B3\u30DF\u30C3\u30C8\u5C65\u6B74\u304B\u3089\u610F\u601D\u6C7A\u5B9A\u3092\u62BD\u51FA |\n| `github` | GitHub \u306E PR \u3068 Issue | `GITHUB_TOKEN` \u74B0\u5883\u5909\u6570\u304C\u5FC5\u8981 |\n| `obsidian` | Obsidian Vault \u306E\u30CE\u30FC\u30C8 | \u8A2D\u5B9A\u6E08\u307F Vault \u30D1\u30B9\u304B\u3089\u8AAD\u307F\u8FBC\u3080 |\n| `claude-sessions` | Claude Code \u30BB\u30C3\u30B7\u30E7\u30F3\u30ED\u30B0 | \u904E\u53BB\u306E AI \u30BB\u30C3\u30B7\u30E7\u30F3\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u30A4\u30F3\u30DD\u30FC\u30C8 |\n| `cursor-sessions` | Cursor IDE \u30BB\u30C3\u30B7\u30E7\u30F3\u5C65\u6B74 | Cursor \u30BB\u30C3\u30B7\u30E7\u30F3\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u30A4\u30F3\u30DD\u30FC\u30C8 |\n| `cicd` | CI/CD \u30D1\u30A4\u30D7\u30E9\u30A4\u30F3\u306E\u7D50\u679C | GitHub Actions\u3001\u30D3\u30EB\u30C9\u7D50\u679C |\n\n## \u624B\u9806\n\n1. **\u30BD\u30FC\u30B9\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u3069\u306E\u5916\u90E8\u30B7\u30B9\u30C6\u30E0\u306B\u30A4\u30F3\u30DD\u30FC\u30C8\u3059\u3079\u304D\u77E5\u8B58\u304C\u3042\u308B\u304B\uFF1F\n2. **\u524D\u63D0\u6761\u4EF6\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u30D7\u30E9\u30B0\u30A4\u30F3\u306B\u8A8D\u8A3C\u60C5\u5831\u3084\u8A2D\u5B9A\u304C\u5FC5\u8981\u304B\uFF1F\uFF08plugin-guide.md \u3092\u53C2\u7167\uFF09\n3. **\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u30B3\u30DE\u30F3\u30C9\u3092\u5B9F\u884C\u3059\u308B** \u2014 \u9069\u5207\u306A\u30D7\u30E9\u30B0\u30A4\u30F3 ID \u3068\u30AA\u30D7\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3059\u308B\n4. **\u7D50\u679C\u3092\u78BA\u8A8D\u3059\u308B** \u2014 `knowledgine status` \u3092\u5B9F\u884C\u3059\u308B\u304B\u3001\u691C\u7D22\u3057\u3066\u30CE\u30FC\u30C8\u304C\u30A4\u30F3\u30DD\u30FC\u30C8\u3055\u308C\u305F\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\n5. **\u5FC5\u8981\u306B\u5FDC\u3058\u3066\u518D\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u3059\u308B** \u2014 `--full` \u30D5\u30E9\u30B0\u3067\u51E6\u7406\u6E08\u307F\u30B3\u30F3\u30C6\u30F3\u30C4\u3092\u518D\u51E6\u7406\u3059\u308B\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- \u65B0\u3057\u3044\u30EA\u30DD\u30B8\u30C8\u30EA\u3067\u4F5C\u696D\u3092\u958B\u59CB\u3059\u308B\u969B\u306F `git-history` \u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u3092\u5B9F\u884C\u3059\u308B\n- \u30EC\u30FC\u30C8\u5236\u9650\u3092\u907F\u3051\u308B\u305F\u3081\u3001GitHub \u30B3\u30F3\u30C6\u30F3\u30C4\u306E\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u524D\u306B `GITHUB_TOKEN` \u3092\u8A2D\u5B9A\u3059\u308B\n- \u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u8A2D\u5B9A\u3092\u5909\u66F4\u3057\u305F\u5F8C\u306F `--full` \u30D5\u30E9\u30B0\u3092\u4F7F\u7528\u3059\u308B\n- `knowledgine plugins status` \u3067\u5404\u30D7\u30E9\u30B0\u30A4\u30F3\u306E\u6700\u7D42\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u30AB\u30FC\u30BD\u30EB\u3092\u78BA\u8A8D\u3059\u308B\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- \u5404\u30D7\u30E9\u30B0\u30A4\u30F3\u306E\u8A73\u7D30\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306F `plugin-guide.md` \u3092\u53C2\u7167\n- \u5404\u30BD\u30FC\u30B9\u30BF\u30A4\u30D7\u306E\u8A2D\u5B9A\u8981\u4EF6\u306F `source-types.md` \u3092\u53C2\u7167\n";
2
+ //# sourceMappingURL=skill-md.ja.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,0hPA+EpB,CAAC"}
@@ -0,0 +1,81 @@
1
+ export const SKILL_MD = `---
2
+ name: knowledgine-ingest
3
+ version: "1.0.0"
4
+ lang: ja
5
+ description: >
6
+ 外部ソースからローカルナレッジベースへ知識をインポートする。Git コミット履歴、
7
+ GitHub の PR・Issue、Obsidian Vault、Claude または Cursor のセッション履歴、
8
+ CI/CD パイプラインからのインポートを行う際に呼び出す。
9
+ 各ソースには専用プラグインと設定が必要。
10
+ ---
11
+ # knowledgine-ingest
12
+
13
+ ## 目的
14
+
15
+ バージョン管理履歴、Issue トラッカー、個人ノートシステム、AI セッションログなど、
16
+ 外部ナレッジリポジトリからナレッジベースへ手動キャプチャなしにデータを投入する。
17
+ インジェストにより、現セッション以前の歴史的コンテキストでナレッジベースが強化される。
18
+
19
+ ## 使用するタイミング
20
+
21
+ - **コードベースへのオンボーディング** — Git 履歴をインジェストして過去の意思決定を把握する
22
+ - **GitHub 知識の統合** — PR と Issue をコンテキストとしてインポートする
23
+ - **Obsidian ノートのインポート** — 個人またはチームのノートをナレッジベースに取り込む
24
+ - **AI セッション履歴のキャプチャ** — Claude または Cursor のセッションログをインポートする
25
+ - **CI 知識の構築** — CI/CD パイプラインの結果とパターンをインポートする
26
+ - **ユーザーが明示的にインポートを要求した場合** — 「Obsidian からノートを読み込んで」
27
+
28
+ ## 使用しないタイミング
29
+
30
+ - 当セッション内でそのソースがすでに完全にインジェスト済みの場合(カーソル状態を確認)
31
+ - 必要な認証情報(例: GITHUB_TOKEN)をユーザーが設定していない場合
32
+
33
+ ## インジェスト方法(CLI)
34
+
35
+ \`\`\`bash
36
+ # 特定のプラグインを実行
37
+ knowledgine ingest --source <plugin-id> --path <knowledge-base-path>
38
+
39
+ # 登録済みプラグインをすべて実行
40
+ knowledgine ingest --all --path <knowledge-base-path>
41
+
42
+ # 完全な再インジェストを強制(保存済みカーソルを無視)
43
+ knowledgine ingest --source <plugin-id> --full --path <knowledge-base-path>
44
+
45
+ # GitHub 専用(GITHUB_TOKEN 環境変数が必要)
46
+ knowledgine ingest --source github --repo owner/repo --path <path>
47
+ \`\`\`
48
+
49
+ ## 利用可能なソースプラグイン
50
+
51
+ | Plugin ID | ソース | 備考 |
52
+ |-----------|--------|-------|
53
+ | \`markdown\` | ローカルの Markdown ファイル | デフォルト;\`knowledgine init\` で使用 |
54
+ | \`git-history\` | Git コミットメッセージと差分 | コミット履歴から意思決定を抽出 |
55
+ | \`github\` | GitHub の PR と Issue | \`GITHUB_TOKEN\` 環境変数が必要 |
56
+ | \`obsidian\` | Obsidian Vault のノート | 設定済み Vault パスから読み込む |
57
+ | \`claude-sessions\` | Claude Code セッションログ | 過去の AI セッションコンテキストをインポート |
58
+ | \`cursor-sessions\` | Cursor IDE セッション履歴 | Cursor セッションコンテキストをインポート |
59
+ | \`cicd\` | CI/CD パイプラインの結果 | GitHub Actions、ビルド結果 |
60
+
61
+ ## 手順
62
+
63
+ 1. **ソースを特定する** — どの外部システムにインポートすべき知識があるか?
64
+ 2. **前提条件を確認する** — プラグインに認証情報や設定が必要か?(plugin-guide.md を参照)
65
+ 3. **インジェストコマンドを実行する** — 適切なプラグイン ID とオプションを使用する
66
+ 4. **結果を確認する** — \`knowledgine status\` を実行するか、検索してノートがインポートされたことを確認する
67
+ 5. **必要に応じて再インジェストする** — \`--full\` フラグで処理済みコンテンツを再処理する
68
+
69
+ ## ベストプラクティス
70
+
71
+ - 新しいリポジトリで作業を開始する際は \`git-history\` インジェストを実行する
72
+ - レート制限を避けるため、GitHub コンテンツのインジェスト前に \`GITHUB_TOKEN\` を設定する
73
+ - インジェスト設定を変更した後は \`--full\` フラグを使用する
74
+ - \`knowledgine plugins status\` で各プラグインの最終インジェストカーソルを確認する
75
+
76
+ ## 参照ファイル
77
+
78
+ - 各プラグインの詳細ドキュメントは \`plugin-guide.md\` を参照
79
+ - 各ソースタイプの設定要件は \`source-types.md\` を参照
80
+ `;
81
+ //# sourceMappingURL=skill-md.ja.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+EvB,CAAC"}
@@ -1,5 +1,7 @@
1
1
  export const SKILL_MD = `---
2
2
  name: knowledgine-ingest
3
+ version: "1.0.0"
4
+ lang: en
3
5
  description: >
4
6
  Import knowledge from external sources into the local knowledge base. Invoke when
5
7
  the user wants to import from Git commit history, GitHub PRs and issues, Obsidian
@@ -1 +1 @@
1
- {"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EvB,CAAC"}
1
+ {"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFvB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-recall/references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8M7C,CAAC"}
1
+ {"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-memory/references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2L7C,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare const REFERENCES: Record<string, string>;
2
+ //# sourceMappingURL=references.ja.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-memory/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2L7C,CAAC"}
@@ -0,0 +1,188 @@
1
+ export const REFERENCES = {
2
+ "layer-guide.md": `# メモリレイヤーガイド
3
+
4
+ 3 つのメモリレイヤーの選択、使用、昇格に関する詳細ガイダンス。
5
+
6
+ ---
7
+
8
+ ## episodic — 短期的なセッションコンテキスト
9
+
10
+ **核心となる問い**: 「今、何をしているか?」
11
+
12
+ **有効期間**: 数時間〜数日。セッションまたはタスクの終了時に自然に期限切れになる。
13
+
14
+ **例**:
15
+ - 「現在 auth モジュールをリファクタリング中 — トークン検証の抽出の途中。次のステップ: routes/protected.ts の呼び出し元を更新する。」
16
+ - 「ジョブキューの競合状態をデバッグ中。仮説: DB の書き込みがコミットされる前にワーカーがアイテムを処理している。まだ調査中。」
17
+ - 「セッション目標: 1 日の終わりまでに失敗した統合テストをグリーンにする。フィクスチャのセットアップでブロックされている。」
18
+ - 「このセッションで 3 つの PR を作成: #42(auth)、#43(cache)、#44(types)。すべてレビュー待ち。」
19
+
20
+ **推奨 TTL 値**:
21
+ | 期間 | 秒 | ユースケース |
22
+ |----------|---------|----------|
23
+ | 1 時間 | 3600 | セッション内のスクラッチパッド |
24
+ | 1 日 | 86400 | 翌日に再開 |
25
+ | 1 週間 | 604800 | 数日にまたがる進行中のタスク |
26
+ | なし | — | 手動クリーンアップが必要な場合のみ |
27
+
28
+ **semantic への昇格タイミング**:
29
+ 以下の場合に episodic メモリを semantic に昇格させる:
30
+ - 同じコンテキストが 2 回以上の別セッションで再作成された
31
+ - 情報が単なる現在の状態ではなく、事実や決定を表している
32
+ - TTL がコンテキストが不要になる前に期限切れになる
33
+
34
+ **タグ戦略**:
35
+ ステータスタグと時間識別子を使用する: \`in-progress\`、\`blocked\`、\`session-goal\`、プロジェクト/タスク識別子。例: \`["auth-refactor", "in-progress", "session-2024-01-20"]\`
36
+
37
+ ---
38
+
39
+ ## semantic — 中期的な事実と決定
40
+
41
+ **核心となる問い**: 「今週、何を学んだか?」
42
+
43
+ **有効期間**: 数日〜数週間。単一セッションを超えて続く安定した事実、決定、コンテキストを表す。
44
+
45
+ **例**:
46
+ - 「ペイメントチームは Stripe の移行を Q3 に延期することを決定した。それまでは、すべての支払い関連作業が既存の Braintree 統合を対象にすべき。」
47
+ - 「ステージングデータベースはテスト実行間で自動リセットされない。統合テストの前に常にシードスクリプトを手動で実行する。」
48
+ - 「\`user_sessions\` テーブルには \`expires_at\` のインデックスがない。ステージングデータセット(80 万行)で有効期限によるフィルタリングクエリが遅い。チケット発行済み: INFRA-1042。」
49
+ - 「チームの慣例: フィーチャーフラグは \`config/flags.ts\` で管理される — フィーチャーゲーティングに環境変数を直接使用しない。」
50
+
51
+ **procedural への昇格タイミング**:
52
+ 以下の場合に semantic メモリを procedural に昇格させる:
53
+ - 同じパターンまたはワークフローが 3 回以上の異なる状況で正常に適用された
54
+ - 知識がプロジェクト固有の事実ではなく、汎用化可能なスキルを表している
55
+ - あらゆる新しいプロジェクトコンテキストでデフォルトの出発点として利用できるようにしたい
56
+
57
+ **タグ戦略**:
58
+ ドメインとステータスタグを使用する: \`decision\`、\`constraint\`、\`team-convention\`、\`project-fact\`、関連する技術領域。例: \`["payments", "decision", "q3-deferral"]\`
59
+
60
+ ---
61
+
62
+ ## procedural — 長期的なパターンとスキル
63
+
64
+ **核心となる問い**: 「この種の問題をどう解決するか?」
65
+
66
+ **有効期間**: 数週間〜無期限。安定した、汎用化可能なスキルとワークフローを表す。
67
+
68
+ **例**:
69
+ - 「非同期ジョブキューの競合状態のデバッグ: (1) 操作ごとのトレース ID を追加、(2) デキュー前後のキュー状態をログ、(3) DB 書き込みの await 漏れを確認、(4) シングルワーカーテストモードで並行性を排除。」
70
+ - 「auth 変更のコードレビューチェックリスト: トークン有効期限の処理を確認、CSRF 保護がバイパスされていないことを確認、ログインエンドポイントのレート制限の欠如を確認、シークレットがログに記録されていないことを確認。」
71
+ - 「データベースマイグレーションのデプロイ手順: (1) ステージングに対してドライランモードでマイグレーションを実行、(2) 行数とインデックス作成を確認、(3) スナップショットを取得、(4) トラフィックの少ない時間帯に本番環境へ適用、(5) 30 分間エラーレートを監視。」
72
+ - 「TypeScript が呼び出しチェーンで 'object is possibly undefined' を報告する場合、非 null アサーションの使用よりも関数の入り口でガード節を追加することを優先する。非 null アサーションはエラーを修正せずに抑制する。」
73
+
74
+ **タグ戦略**:
75
+ スキルカテゴリとドメインタグを使用する: \`workflow\`、\`checklist\`、\`pattern\`、\`debugging\`、\`deployment\`、\`code-review\`、技術領域。例: \`["debugging", "async", "workflow"]\`
76
+
77
+ ---
78
+
79
+ ## レイヤー昇格ワークフロー
80
+
81
+ \`\`\`
82
+ episodic
83
+
84
+ │ 同じコンテキストを 2 回以上のセッションで再作成した後
85
+ │ またはコンテキストが安定した事実/決定を表している場合
86
+
87
+ semantic
88
+
89
+ │ 異なる状況で 3 回以上正常に適用した後
90
+ │ または知識がこのプロジェクトを超えて明確に汎用化できる場合
91
+
92
+ procedural
93
+ \`\`\`
94
+
95
+ **昇格手順**:
96
+ 1. ID またはタグフィルターで既存エントリを取得する
97
+ 2. 昇格したレイヤーと精製されたコンテンツで \`store_memory\` を呼び出す(本質的なパターンに蒸留する)
98
+ 3. 理由「Promoted to [layer]」で元のエントリに \`forget_memory\` を呼び出す
99
+ 4. 新しいレイヤーの慣例に合わせてタグを更新する
100
+
101
+ ---
102
+
103
+ ## タグ戦略サマリー
104
+
105
+ | レイヤー | 推奨タグパターン | 例 |
106
+ |-------|--------------------------|---------|
107
+ | episodic | ステータス + タスク識別子 | \`in-progress\`、\`blocked\`、\`session-goal\` |
108
+ | semantic | ドメイン + 事実タイプ | \`decision\`、\`constraint\`、\`team-convention\` |
109
+ | procedural | スキルカテゴリ + ドメイン | \`workflow\`、\`checklist\`、\`pattern\`、\`debugging\` |
110
+
111
+ タグは意味のあるフィルターとして機能するほど具体的にしつつ、
112
+ 単一エントリに固有になるほど具体的にしすぎない。1 エントリあたり 2〜4 個のタグを目安にする。
113
+ `,
114
+ "memory-vs-knowledge.md": `# メモリ vs ナレッジ: 判断マトリクス
115
+
116
+ \`store_memory\`(メモリツール)と \`capture_knowledge\`(knowledgine-capture スキル)の
117
+ どちらを呼び出すか判断するためのガイド。
118
+
119
+ ---
120
+
121
+ ## 判断マトリクス
122
+
123
+ | 基準 | メモリ(\`store_memory\`) | ナレッジ(\`capture_knowledge\`) |
124
+ |-----------|--------------------------|----------------------------------|
125
+ | **有効期間** | 一時的〜中期的 | 永続的 |
126
+ | **対象者** | 同じユーザーまたはエージェントインスタンス | チーム全体 |
127
+ | **コンテンツタイプ** | 状態、コンテキスト、進行中の作業 | 解決策、決定、再利用可能なパターン |
128
+ | **検索方法** | レイヤー、タグ、日付範囲 | 全文、セマンティック、グラフ |
129
+ | **例** | 「auth リファクタリング作業中、トークンリフレッシュでブロック」 | 「有効期限チェック前にトークンリフレッシュを追加して auth バグを修正」 |
130
+ | **バージョニング** | オプション(\`createVersion\` フラグ) | 自動(ノート履歴は常に保持) |
131
+ | **有効期限** | TTL サポートあり | 有効期限なし |
132
+ | **トリガー** | セッション中いつでも | 転用可能な洞察を伴う作業完了後 |
133
+
134
+ ---
135
+
136
+ ## クイック判断ツリー
137
+
138
+ \`\`\`
139
+ この情報は現在/近い将来の作業のために自分(または現在のエージェント)のみに有用か?
140
+ ├── YES → 近いうちに、またはタスクの終了時に期限切れになりそうか?
141
+ │ ├── YES → store_memory (episodic、TTL を設定)
142
+ │ └── NO → store_memory (semantic または procedural)
143
+ └── NO → 他者が学べる事実、決定、パターン、または解決策か?
144
+ ├── YES → capture_knowledge (knowledgine-capture)
145
+ └── NO → 保存不要
146
+ \`\`\`
147
+
148
+ ---
149
+
150
+ ## シナリオ別の例
151
+
152
+ ### store_memory を使用する場合
153
+
154
+ - 「ユーザーサービスを新しい API に移行する途中。次のセッションは routes/users.ts の 142 行目から開始する。」
155
+ → episodic、TTL: 86400
156
+
157
+ - 「ステージング環境は現在、マイグレーションの失敗により壊れている。INFRA-204 が解決されるまでステージングに対して統合テストを実行しない。」
158
+ → semantic、TTL なし(解決時に手動で削除)
159
+
160
+ - 「不安定なテストをデバッグするときに常に使用するパターン: --runInBand で分離、詳細ログを追加、beforeEach での共有状態を確認する。」
161
+ → procedural、TTL なし
162
+
163
+ ### capture_knowledge を使用する場合
164
+
165
+ - 「不安定なテストを修正: 根本原因はテスト間でリセットされないメモリ内共有キャッシュ。修正: afterEach で cache.clear() を呼び出す。」
166
+ → 転用可能な根本原因を持つ解決済みの問題 — capture_knowledge を使用
167
+
168
+ - 「決定: 在庫更新エンドポイントに楽観的ロックを使用して過剰販売を防止する。代替案(悲観的ロック)はレイテンシの理由で却下された。」
169
+ → チーム全体に利益をもたらす理由付きの設計決定 — capture_knowledge を使用
170
+
171
+ - 「パターン: 循環的複雑度を下げるため、ネストされた if/else ではなく関数の入り口でガード節を使用する。」
172
+ → 再利用可能なコードパターン — capture_knowledge を使用
173
+
174
+ ---
175
+
176
+ ## 両方が適用される場合
177
+
178
+ 同じセッションがメモリエントリとナレッジキャプチャの両方を生成することがある:
179
+
180
+ 1. **作業中**: 進捗と未解決の疑問を追跡する episodic メモリを保存する
181
+ 2. **作業完了後**: 洞察(バグ修正、決定、パターン)を knowledgine-capture でキャプチャする
182
+ 3. **クリーンアップ**: \`forget_memory\` で episodic メモリを削除する(理由: 「Task complete — captured in knowledge base」)
183
+
184
+ この分離により、メモリストアは実行可能な状態に集中し、
185
+ ナレッジベースは永続的な洞察を蓄積し続ける。
186
+ `,
187
+ };
188
+ //# sourceMappingURL=references.ja.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-memory/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GnB;IAEC,wBAAwB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE3B;CACA,CAAC"}