twg-space-creation について
twg-space-creationは、twgを使ってConfluenceのスペースを作成するスキルです。資料から承認済みの情報設計を組み立て、対象読者と書き込み範囲に配慮しながら段階的に作成・検証します。
主な機能
- 01資料を基にスペース構成を設計
- 02重要事項を確認して承認を得る
- 03ページや構造化コンテンツを段階的に作成
- 04階層、本文、成果物を確認
- 05リンク、件数、未対応事項を報告
活用シーン
- 01コードリポジトリをConfluenceスペースに整理
- 02既存スペースを基に新しい構成を設計
- 03データベースやホワイトボードを含む作業スペースを作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ atlassian/ twg-cli --skill twg-space-creationインストール後、Claude Code で/twg-space-creationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSE.txtreferences/blueprints.mdpage-archetypes.mdproposal-flow.mdrepo-discovery.mdtwg-confluence-space.md詳細
twg-space-creation
ルート twg と併用します。ソースを、承認済みの情報アーキテクチャと Confluence の構成に変換してから作成し、検証します。コンテンツの意味付けと書き込みの安全性は twg-confluence が担い、変更コマンドの文法はライブヘルプが担います。
CLI ランチャーのフォールバック
twg <command> を実行します。シェルで command not found が発生した場合は、$HOME/.local/bin/twg(macOS/Linux)/$env:LOCALAPPDATA\Programs\twg\bin\twg.exe(PowerShell)を使用し、そのディレクトリを PATH に追加するようユーザーに伝えます。認証エラーやコマンドエラーを PATH の問題として扱わないでください。
基本方針
オブジェクト数を満たすのではなく、ナビゲーションしやすいスペースを構築します。役立つハブを優先し、重要な質問だけを行い、大規模な作業の前にはコストを示します。
ワークフロー
- 特定します。 対象、ソース、目的、対象者、ワークフローを推測します。既存のスペースは同一サイト内に限ります。ソースを読み取ったり書き込んだりする前に、サイトが一致しない場合は拒否します。
- 設定します。
references/proposal-flow.mdを読み込みます。アイデンティティ/アクセス、規模/詳細度、真実の境界、計画/構築の選択肢に不足がある場合に限り、簡潔な質問を一度にまとめて行います。 - 証拠を収集します。 リポジトリの場合は
references/repo-discovery.mdを読み込みます。既存のスペースの場合は、ツリー、手順、範囲を限定した本文サンプルを確認します。 - 設計します。
references/blueprints.mdとreferences/page-archetypes.mdを読み込みます。ツリー、各ノードの役割、関連ページ、種類別の件数、本文の形式/ソース、手順、除外事項、代表的な縦割りのサンプルを提示します。 - 承認を得ます。 表示した範囲の実行をすでに許可している明確な依頼であれば、進めてもかまいません。それ以外の場合は、作成/修正/キャンセルの確認を求めます。大規模、曖昧、非公開、または合成的な構築は、必ず確認を得てください。承認によって構築の範囲は定まりますが、アーカイブ、削除、上書き、公開リンクは許可されません。
- 段階的に作成します。
references/twg-confluence-space.mdを読み込みます。構築内容を台帳に記録し、対応している場合は手順を設定/取得します。1 つのブランチと、選択した各種類から 1 つずつ検証します。承認された意味付けに合致するファミリーのみ展開します。 - 検証して引き継ぎます。 階層、本文、構造化/視覚化されたすべての成果物、対応している手順を照合します。URL、件数、不足事項、省略した手順、検証の切り詰めについて報告します。
構成ルール
- ナビゲーションにはフォルダーのみを使用し、説明や意思決定にはページ/ライブドキュメントを使用し、繰り返し行う構造化作業にはデータベースを使用し、空間的な理解にはホワイトボードを使用します。時間に基づく公開はスペース作成の対象外とします。
- 各データベースまたはホワイトボードには、それを管理するページを設けます。明確な役割がある場合に限り、種類を追加します。
- 骨組みにはプロンプト、レイアウト、表、テンプレートを使用できますが、担当者、決定事項、日付、指標、顧客の証拠、システムの挙動を捏造してはいけません。
- 対象者に合わせてソース資料を調整します。リポジトリをそのまま流し込むのではなく、正規リンク、要約、忠実なインポート、添付ファイルのいずれかを選びます。
- 選択した作成形式ごとに、その都度
twg confluence content body-formatsを読み込みます。このスキルでは、生の HTML、CSV、SVG、ADF のルールを再掲しません。
停止条件
サイト/ソースが未解決、サイトをまたぐ調整が必要、範囲に重要な曖昧さがある、または提案のみを求められている場合は、書き込みの前に停止します。手順のサポートがない場合でも作成は停止しません。サンプルとの不一致があれば展開を停止します。未解決の親をスペースルートに置き換えてはいけません。
参考資料
references/proposal-flow.md— ヒアリング、スペースの契約、承認、手順。毎回読み込みます。references/blueprints.md— ワークフローを優先した出発点の形と規模の選択肢。references/page-archetypes.md— ページの目的に応じた詳細な構成。references/repo-discovery.md— リポジトリの形に引きずられない情報アーキテクチャのためのリポジトリ証拠。references/twg-confluence-space.md— 安定した作成と検証のフロー。
本文形式の構文については、ライブの body-formats ガイダンスのみを参照します。