paperclip-wiki-manage

Paperclip Wiki 管理

確認済みの paperclipai.plugin-llm-wiki プラグインブリッジの書き込みルートのみを通じて、Paperclip llm-wiki のコンテンツを管理します。

読み取り専用のページコンテンツ、ページ一覧、ソース一覧、SPA URL パス変換には paperclip-wiki-fetch を使用します。このスキルは Wiki の変更にのみ使用してください。

パス形式と MCP の注意点

• アクションブリッジ（書き込み）：/api/plugins/paperclipai.plugin-llm-wiki/actions/<key>、本文は { "companyId": "...", "params": { ... } }。
• スコープ付き REST（書き込み）：/api/plugins/paperclipai.plugin-llm-wiki/api/<route>（/api セグメントが追加されます）、フラットな JSON 本文。

MCP paperclipApiRequest 経由で呼び出す場合は、先頭の /api を省略してください。MCP がこれを付加するため、/api/plugins/... は /api/api/... となり、404 が返されます。REST を直接呼び出す場合や curl では、ベアラートークンを使用して完全な /api/plugins/... パスを指定します。

確認済みルートの要件

Wiki の書き込みルートを推測してはいけません。確認済みのルート（特記がない限り、それぞれが操作／タスクを作成しないことを確認済み）：

POST /api/plugins/paperclipai.plugin-llm-wiki/actions/write-page   # write/replace a page directly — NO task ✅
POST /api/plugins/paperclipai.plugin-llm-wiki/api/sources          # capture a raw source into raw/ — NO task ✅
POST /api/plugins/paperclipai.plugin-llm-wiki/api/spaces           # create a space (board)

…/api/file-as-page は使用しないでください。ページを書き込みますが、（自動完了する）file-as-page 操作の課題も作成され、タスクの痕跡が残ります。ページに直接書き込む場合は、クリーンな方法として actions/write-page を使用してください。

Markdown ページを書き込むには actions/write-page を使用します。確認済みの本文形式：

{
  "companyId": "<company-id>",
  "params": {
    "wikiId": "default",
    "spaceSlug": "<space-slug>",
    "path": "wiki/sources/example.md",
    "contents": "# Example\n",
    "expectedHash": "<optional-current-hash>",
    "summary": "<optional-change-summary>"
  }
}

生のソースを登録するには api/sources を使用します（wiki-contribute スキルと同じプリミティブです）。フラットな本文 {companyId, wikiId, spaceSlug, sourceType:"text", title, contents, url?, metadata?} を指定すると、{sourceId, rawPath, hash} が返されます。これはスペースの raw/ に保存され、ステータスは captured になり、Wiki Maintainer は起動しません。

スペース： 書き込み先は spaceSlug で指定します（デフォルトは default。creator-jane など、作成者／チームごとのスペースもあります）。fetch スキルの api/spaces ルートで一覧を取得できます。スペース内のパスは相対パスです（wiki/...、raw/...）。

別の Wiki 変更ルートを使用する場合は、次のいずれかに基づいて、確認済みのプラグインブリッジ書き込みルートとスキーマを特定してください。

• Paperclip／プラグインの公式ドキュメント
• Paperclip／プラグインのソースコードを調査した結果
• オペレーターから提供された動作確認済みの例
• ルートの契約を証明する、変更を伴わないスキーマ／オプション／読み取りプローブの成功結果

ルートは次のいずれかの配下でなければなりません。

/api/plugins/paperclipai.plugin-llm-wiki/data/...
/api/plugins/paperclipai.plugin-llm-wiki/actions/...

/api/wiki/... は決して使用せず、読み取りルートの名前を変更して書き込みルートを推測してはいけません。

変更のワークフロー

1. 要求された変更を分類します。
   • ページの作成
   • ページ本文またはタイトルの更新
   • ページパスの移動または名前変更
   • ページのアーカイブまたは削除
   • 取得済みソースの作成、更新、アーカイブ、または削除
   • その他のプラグインがサポートする Wiki の変更
2. Paperclip のコンテキストと認証情報を、秘密情報を表示せずに確認します。
3. paperclip-wiki-fetch で現在の Wiki の状態を取得します。
   • 対象を選ぶ場合は、ページまたはソースの一覧を取得します。
   • 既存のページを編集する前に、そのページのコンテンツを取得します。
   • 取得可能な場合は、タイトル、パス、更新時刻、ハッシュを記録します。
4. 正確な書き込みルート、HTTP メソッド、リクエストスキーマを確認します。ページの書き込みには POST /api/plugins/paperclipai.plugin-llm-wiki/actions/write-page を使用します。
5. 実行する変更内容を正確に作成します。
   • 対象の会社、Wiki、スペース、ルート、パス
   • 秘密情報を省いたリクエスト JSON
   • ページ本文を変更する場合は Markdown の差分、新規作成の場合は本文全体
   • 予想されるタイトル、パス、ページタイプ、ソースのメタデータ、ハッシュ／更新時刻の動作
6. 書き込み前に、オペレーターの明示的な承認を求めます。
7. 書き込みの直前に、対象がすでに存在する場合はページまたはソースを再取得します。
8. 承認後に更新時刻またはハッシュが変わっていた場合は停止し、編集内容をリベースするか確認します。
9. 確認済みのプラグインブリッジルートを通じて、承認された変更のみを適用します。
10. ページまたはソースを再取得し、次の項目を検証します。
    • タイトル
    • パス
    • 本文またはソースのメタデータ
    • ページタイプ（取得可能な場合）
    • 更新時刻
    • ハッシュ
11. 使用したルート、レコード識別子、検証結果、未解決の不確実性があれば報告します。

承認ルール

• 作成、更新、移動、名前変更、アーカイブ、削除、ソースの取得、またはソースの変更を行う前に、毎回確認してください。
• 破壊的な操作では、対象のパス／ソースと操作を明示した、特に明確な承認を得てください。
• オペレーターが具体的な一括操作を承認していない限り、複数の Wiki の変更をまとめて1つの承認で行わないでください。
• 別のスキルで承認済みのワークフローとして明示的に求められている場合を除き、このスキルから Paperclip の課題、目標、プロジェクト、エージェント、または承認を変更しないでください。

失敗時の対応

• 書き込み可能なルートが確認できない場合は、Wiki の管理はルート／スキーマの調査が完了するまで行えない旨を報告して中止してください。
• 認証情報、company id、wiki id、space slug、ページパス、または対象のソース ID が不足しており、推測できない場合は、不足している情報を尋ねてください。
• 読み戻した内容が意図した変更と一致しない場合は、不一致を報告し、新たな承認を得ずに修正を続けないでください。
• 要求された操作によって、機密情報、秘密情報、または未承認の外部コンテンツが公開される場合は、中止してオペレーターに確認を求めてください。

安全な既定値

• 既存の Wiki のコンテキストまたはユーザーのプロンプトが裏付けている場合に限り、wikiId の既定値を default にしてください。
• 既存の Wiki のコンテキストまたはユーザーのプロンプトが裏付けている場合に限り、spaceSlug の既定値を default にしてください。
• オペレーターが名前変更または移動を明示的に要求していない限り、既存のページパスとタイトルを維持してください。
• ページ全体を置き換えるより、対象を絞った小規模な編集を優先してください。
• オペレーターが Wiki への公開または同期を明示的に要求していない限り、Paperclip の計画ドキュメントを信頼できる唯一の情報源として扱ってください。