twg-confluence

twg-confluence

Confluence が主な情報源または変更対象の場合は、ルートの twg と併用してください。 このスキルでは、コンテンツの種類、階層、形式、並行処理のセマンティクスを扱います。 正確なコマンド構文はライブヘルプを参照してください。

CLI ランチャーのフォールバック

twg <command> を実行してください。シェルで command not found が発生した場合は、 $HOME/.local/bin/twg（macOS/Linux）または $env:LOCALAPPDATA\Programs\twg\bin\twg.exe（PowerShell）を使用し、 そのディレクトリを PATH に追加するようユーザーに伝えてください。認証エラーやコマンドエラーを PATH の問題として扱わないでください。

使用する場面

• Confluence を基点としたコンテンツやスペースの読み取り、変更に使用します。対象には CQL、 本文、階層、バージョン、権限、エクスポートが含まれます。
• より広範なワークフローで補足情報として Confluence のリンクを使う場合は、読み込まないでください。

最初のルーティング

意図	ルート
既知のコンテンツ ID または URL	confluence content get
既知の複数ページ	対象全体に対して docs get <id-or-url…> を 1 回実行
Confluence の厳密な絞り込み	CQL を使った Confluence 検索
日付で絞り込んだページ／ブログ投稿一覧	lastmodified を指定した confluence search query --cql。content list に日付フィルターはありません
あいまいなページ／トピックの検索	プロダクト横断検索を行い、その後ネイティブの get を使用
コンテンツの作成または更新	統合された confluence content インターフェース
スペースのメタデータ／ライフサイクル	confluence space
階層	confluence tree
エクスポート	Word はダウンロードを直接返します。PDF ではエクスポート状態のポーリングが必要です

不慣れな変更や影響の大きい変更を行う前に、twg help describe "<exact path>" を使用してください。

Confluence のセマンティクス

ページネーション。

• ライブヘルプで案内されているコンテンツ操作には統合コンテンツインターフェースを使用し、 スペースには confluence space、階層には confluence tree を使用してください。
• 検索スニペットは候補の発見に使います。要約や編集の前に、選択したコンテンツを読んでください。
• confluence content get と content versions list --id は単一ページ用です。 複数ページの場合は、1 回の confluence search query --cql でメタデータ（タイトル、 スペース、lastmodified、作成者）を取得し、回答に影響するコンテンツを持つページの本文だけを読み込みます。 これは多くの ID を一度に受け取る docs get <id-or-url…> を使い、--agent-fields @compact を指定してまとめて行います。 ページ一覧に対して単一ページ用のルートを繰り返し実行してはいけません。また、ページごとに CQL クエリを再実行してはいけません。
• ページタイトルは本文とは別に指定します。本文の最初の見出しとしてタイトルを繰り返さないでください。
• Remix の作成処理はページ埋め込みではなくアセットを返します。読み込んだ HTML ガイドに従って埋め込み、 ページを読み戻してください。ID／URL は埋め込みの証明にはなりません。
• Maui の作成処理で --content-id を使うのは、所有権／埋め込みのためだけであり、ページの読み取りには使いません。 先にソースを読み、値、ラベル、説明文、視覚化の指示をプロンプトに含めてください。「このページ」だけでは不十分です。

安全な作成と編集

• アーカイブ、ゴミ箱への移動、完全削除では、ユーザーの承認と CLI での確認を別々のチェックとして扱います。--yes の指定は実行前の確認であり、ユーザーが変更を承認した証拠ではありません。--yes は、ユーザーが変更内容と正確な対象、または事前に表示された範囲の明確な対象リストを指定した後にのみ使用してください。
• 「ページ XYZ をアーカイブして」や、具体的なリストを示した後の「その 15 ページをアーカイブして」のような明確な指示があれば、追加の確認なしで実行できます。「整理して」「片付けて」「対応して」のような曖昧な表現は、アーカイブ、ゴミ箱への移動、完全削除を承認するものではありません。
• 変更内容や対象を推測した場合は、対象候補を特定し、具体的な操作と範囲を限定した対象リストを提示して、ユーザーが承認するまで待ってください。類似する過去の操作に対する承認を一般化しないでください。trash の承認は、恒久的な完全削除を承認するものではありません。
• 作成する前に、セッション中、スペースごとに 1 回、そのスペースの指示を適用してください。references/spaces.md を参照してください。指示が空の場合は、デフォルト設定を使用します。
• サポートされている場合、共同編集する社内コンテンツには live_doc を優先してください。単に「ページ」や「ドキュメント」の作成を依頼された場合も、デフォルトでライブドキュメントを使用します。
• クラシック形式またはライブ形式ではないことが明示されている場合、ナレッジベース、顧客向けヘルプ、従来からクラシックページを使っているスペース、またはページのみを対象とする操作には page を使用してください。既存の対象の種類は維持してください。親がクラシック形式でも、子の種類は決まりません。
• 重要な編集では、現在の内容を読み取り、本文をローカルに保存してからファイルを編集し、スナップショットトークンを使って更新してください。
• マクロやストレージ形式の厳密な保持が必要な場合は、情報を失わない HTML の往復処理を使用してください。
• --dry-run は、明示的にプレビューを依頼された場合、または直接実行が依頼されていない、通常よりリスクの高い編集にのみ使用してください。
• 変更後に内容またはスペースを読み返し、その URL を報告してください。

引き継ぎ

• 関連する Jira の作業、プロジェクト、目標、依存関係については twg-context-discovery を読み込みます。担当者、所有権、権限、エスカレーションについては twg-responsibility-routing を読み込みます。
• ページがより広範なステータスレポートに含まれる場合は、twg-status-rollups を読み込みます。
• ランブック、インシデント、または PIR については、twg-operational-health を読み込みます。
• スペース全体を作成または複製する場合は、twg-space-creation を読み込みます。

参考資料

• references/content.md - コンテンツの種類、読み取り、書き込み、エクスポート
• references/editing.md - 競合を安全に回避する本文編集
• references/spaces.md - スペースのライフサイクルと階層
• references/querying.md - CQL とあいまい検索
• references/body-formats.md - HTML、Markdown、メンション、特殊な形式