paput-mcp 2.2.2 → 2.2.4
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.
- package/README.md +3 -1
- package/dist/cli/setup-ai.js +39 -7
- package/dist/cli/setup-ai.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -111,7 +111,9 @@ pending に保存
|
|
|
111
111
|
確認後に PaPut へ本保存
|
|
112
112
|
```
|
|
113
113
|
|
|
114
|
-
通常は、`setup-ai` が追記するグローバルルールにより、AI が作業完了時や問題解決時に PaPut
|
|
114
|
+
通常は、`setup-ai` が追記するグローバルルールにより、AI が作業完了時や問題解決時に PaPut へ残す候補を自動で確認し、重複・機密・プロジェクト固有情報の混入がない候補を pending に追加します。追加後はタイトル、カテゴリ、候補 ID を簡潔に報告します。
|
|
115
|
+
|
|
116
|
+
重複の可能性、機密情報の混入、汎用性の低さ、判断に迷う内容がある場合だけ、pending 追加前に確認を求めます。
|
|
115
117
|
|
|
116
118
|
AI が候補提示を行わなかった場合は、`paput-capture` を使います。
|
|
117
119
|
|
package/dist/cli/setup-ai.js
CHANGED
|
@@ -15,14 +15,32 @@ PaPut の知見保存運用を始めるための初期設定を行う。
|
|
|
15
15
|
2. \`paput_sync_remote_memos\` で既存 PaPut メモをローカルキャッシュへ同期する。
|
|
16
16
|
3. \`paput_scan_sessions\` で Claude/Codex の未処理セッションを確認する。
|
|
17
17
|
4. 未処理セッションがある場合は、件数と概要をユーザーに提示する。
|
|
18
|
-
5. ユーザーが希望した場合のみ、\`paput_get_session_transcript\`
|
|
19
|
-
6. pending
|
|
18
|
+
5. ユーザーが希望した場合のみ、\`paput_get_session_transcript\` で本文を取得し、下記の抽出基準を満たす知見候補だけを作る。
|
|
19
|
+
6. \`paput_add_knowledge_candidates\` で pending に保存する前に、候補内にプロジェクト固有の仕様、実装詳細、運用ルール、コード、顧客情報が含まれていないか精査し、含まれる候補は追加しない。
|
|
20
|
+
7. pending 保存後、追加した件数、重複として除外された件数、基準外として追加しなかった件数を簡潔に報告する。
|
|
21
|
+
|
|
22
|
+
## 抽出基準
|
|
23
|
+
|
|
24
|
+
保存候補にするのは、第三者が別プロジェクトでも再利用できる技術知見、判断基準、手順だけに限定する。
|
|
25
|
+
|
|
26
|
+
以下は pending に追加しない。
|
|
27
|
+
|
|
28
|
+
- プロジェクト固有の仕様、画面名、ボタン名、業務フロー、運用ルール、ローカル事情。
|
|
29
|
+
- PR、GitHub、Codex、Claude、AI レビュー、エディタ、OS 操作など、個人運用や作業記録に近いもの。
|
|
30
|
+
- 「詳細画面」「集計値」など、タイトルや本文だけでは第三者が対象を理解できないもの。
|
|
31
|
+
- 採用しなかった設計、単なる体験談、作業ログ、感想、意思決定の経緯だけで終わるもの。
|
|
32
|
+
- 既存メモや pending と意味が近いもの。
|
|
33
|
+
- セキュリティ、権限制御、テナント分離などの一般論で、既に同種の知見があるもの。
|
|
34
|
+
- コード断片やプロジェクト内の命名に依存し、一般化できていないもの。
|
|
35
|
+
|
|
36
|
+
迷う候補は追加せず、「今回は保存対象なし」または「基準外として除外」と判断する。
|
|
20
37
|
|
|
21
38
|
## 注意
|
|
22
39
|
|
|
23
40
|
- PaPut への本保存は行わない。
|
|
24
41
|
- 候補はまず pending に保存する。
|
|
25
|
-
-
|
|
42
|
+
- 重複や類似メモがある場合は、その情報を提示する。
|
|
43
|
+
- pending を増やすことより、後で破棄が不要な候補だけに絞ることを優先する。`,
|
|
26
44
|
},
|
|
27
45
|
{
|
|
28
46
|
name: 'paput-sync',
|
|
@@ -84,9 +102,10 @@ pending に保存された知見候補を確認し、ユーザーが承認した
|
|
|
84
102
|
|
|
85
103
|
1. \`paput_list_pending_candidates\` で既存 pending 候補を確認する。
|
|
86
104
|
2. 現在の会話、またはユーザーが指定したテーマに関連する会話内容から、再利用可能な知見だけを抽出する。
|
|
87
|
-
3.
|
|
105
|
+
3. 候補は小さい単位に分け、タイトル、本文、カテゴリ、公開設定を整える。
|
|
88
106
|
4. 既存 pending と重複しそうな候補は追加せず、既存候補の利用を提案する。
|
|
89
|
-
5.
|
|
107
|
+
5. 重複・機密・プロジェクト固有情報の混入がなく、汎用的な知見だと判断できる候補は、ユーザー承認を待たずに \`paput_add_knowledge_candidates\` で pending に保存する。
|
|
108
|
+
6. pending 保存後、タイトル、カテゴリ、候補 ID を簡潔に報告する。
|
|
90
109
|
|
|
91
110
|
## メモ作成ルール
|
|
92
111
|
|
|
@@ -100,10 +119,23 @@ pending に保存された知見候補を確認し、ユーザーが承認した
|
|
|
100
119
|
- 基本的に非公開として扱う。
|
|
101
120
|
- 本文に Markdown の \`#\` で始まる見出し行を含めない。
|
|
102
121
|
|
|
122
|
+
## 除外する候補
|
|
123
|
+
|
|
124
|
+
以下は pending に追加しない。
|
|
125
|
+
|
|
126
|
+
- プロジェクト固有の仕様、画面名、ボタン名、業務フロー、運用ルール、ローカル事情。
|
|
127
|
+
- PR、GitHub、Codex、Claude、AI レビュー、エディタ、OS 操作など、個人運用や作業記録に近いもの。
|
|
128
|
+
- 「詳細画面」「集計値」など、タイトルや本文だけでは第三者が対象を理解できないもの。
|
|
129
|
+
- 採用しなかった設計、単なる体験談、作業ログ、感想、意思決定の経緯だけで終わるもの。
|
|
130
|
+
- 既存メモや pending と意味が近いもの。
|
|
131
|
+
- セキュリティ、権限制御、テナント分離などの一般論で、既に同種の知見があるもの。
|
|
132
|
+
- コード断片やプロジェクト内の命名に依存し、一般化できていないもの。
|
|
133
|
+
|
|
103
134
|
## 注意
|
|
104
135
|
|
|
105
136
|
- PaPut へ直接保存しない。
|
|
106
137
|
- 保存先は pending のみ。PaPut への本保存は \`paput-save\` で行う。
|
|
138
|
+
- pending への追加はユーザー承認を待たずに行う。ただし、重複の可能性、機密情報の混入、汎用性の低さ、判断に迷う内容がある場合は、追加前に懸念点を提示してユーザー確認を求める。
|
|
107
139
|
- 過去セッションから作成した候補は、PaPut 本保存時にそのセッションの更新日時が作成日時として使われる。
|
|
108
140
|
- 候補がない場合は、無理に作らず「保存すべき知見は見つからない」と伝える。`,
|
|
109
141
|
},
|
|
@@ -114,11 +146,11 @@ const RULES = `## PaPut 知見保存ルール
|
|
|
114
146
|
|
|
115
147
|
保存対象は、別プロジェクトでも再利用できる技術知見、判断基準、手順に限定する。プロジェクト固有の仕様、実装詳細、運用ルール、コード、秘密情報、顧客情報は保存候補にしない。
|
|
116
148
|
|
|
117
|
-
|
|
149
|
+
候補がある場合は、保存前にローカルキャッシュや類似メモ情報を使って重複の可能性を確認する。重複・機密・プロジェクト固有情報の混入がなく、汎用的な知見だと判断できる候補は、ユーザー承認を待たずに \`paput_add_knowledge_candidates\` で pending に保存する。保存後はタイトル・カテゴリ・候補 ID を簡潔に報告する。
|
|
118
150
|
|
|
119
151
|
PaPut への本保存は、ユーザーが明示的に保存を承認した場合のみ \`paput_save_pending_candidate\` を使う。
|
|
120
152
|
|
|
121
|
-
|
|
153
|
+
重複の可能性、機密情報の混入、汎用性の低さ、判断に迷う内容がある場合は、pending 追加前にタイトル・本文・カテゴリと懸念点を提示し、ユーザー確認を求める。
|
|
122
154
|
|
|
123
155
|
pending 候補の確認や PaPut への保存をユーザーが求めた場合は、\`paput-save\` の手順に従う。`;
|
|
124
156
|
const RULE_START = '<!-- paput-mcp:start -->';
|
package/dist/cli/setup-ai.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"setup-ai.js","sourceRoot":"","sources":["../../src/cli/setup-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,MAAM,EACN,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAe1C,MAAM,MAAM,GAAgB;IAC1B;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,yCAAyC;QAC3C,IAAI,EAAE
|
|
1
|
+
{"version":3,"file":"setup-ai.js","sourceRoot":"","sources":["../../src/cli/setup-ai.ts"],"names":[],"mappings":"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"}
|