mcpField
T
twg-space-creation

twg-space-creation

github.com/atlassian生産性2463 回インストール7 週間前に更新
リポジトリ

twg-space-creation について

twg-space-creationは、twgを使ってConfluenceのスペースを作成するスキルです。資料から承認済みの情報設計を組み立て、対象読者と書き込み範囲に配慮しながら段階的に作成・検証します。

主な機能

  1. 01資料を基にスペース構成を設計
  2. 02重要事項を確認して承認を得る
  3. 03ページや構造化コンテンツを段階的に作成
  4. 04階層、本文、成果物を確認
  5. 05リンク、件数、未対応事項を報告

活用シーン

  1. 01コードリポジトリをConfluenceスペースに整理
  2. 02既存スペースを基に新しい構成を設計
  3. 03データベースやホワイトボードを含む作業スペースを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/atlassian/twg-cli --skill twg-space-creation

インストール後、Claude Code で/twg-space-creationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
references/
blueprints.md
page-archetypes.md
proposal-flow.md
repo-discovery.md
twg-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 の問題として扱わないでください。

基本方針

オブジェクト数を満たすのではなく、ナビゲーションしやすいスペースを構築します。役立つハブを優先し、重要な質問だけを行い、大規模な作業の前にはコストを示します。

ワークフロー

  1. 特定します。 対象、ソース、目的、対象者、ワークフローを推測します。既存のスペースは同一サイト内に限ります。ソースを読み取ったり書き込んだりする前に、サイトが一致しない場合は拒否します。
  2. 設定します。 references/proposal-flow.md を読み込みます。アイデンティティ/アクセス、規模/詳細度、真実の境界、計画/構築の選択肢に不足がある場合に限り、簡潔な質問を一度にまとめて行います。
  3. 証拠を収集します。 リポジトリの場合は references/repo-discovery.md を読み込みます。既存のスペースの場合は、ツリー、手順、範囲を限定した本文サンプルを確認します。
  4. 設計します。 references/blueprints.md と references/page-archetypes.md を読み込みます。ツリー、各ノードの役割、関連ページ、種類別の件数、本文の形式/ソース、手順、除外事項、代表的な縦割りのサンプルを提示します。
  5. 承認を得ます。 表示した範囲の実行をすでに許可している明確な依頼であれば、進めてもかまいません。それ以外の場合は、作成/修正/キャンセルの確認を求めます。大規模、曖昧、非公開、または合成的な構築は、必ず確認を得てください。承認によって構築の範囲は定まりますが、アーカイブ、削除、上書き、公開リンクは許可されません。
  6. 段階的に作成します。 references/twg-confluence-space.md を読み込みます。構築内容を台帳に記録し、対応している場合は手順を設定/取得します。1 つのブランチと、選択した各種類から 1 つずつ検証します。承認された意味付けに合致するファミリーのみ展開します。
  7. 検証して引き継ぎます。 階層、本文、構造化/視覚化されたすべての成果物、対応している手順を照合します。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 ガイダンスのみを参照します。

コメント