studio について
Arch Studio のワークスペース設定、プロジェクト登録、ステータス、タスク、コネクター境界を管理するスキルです。建築・プロジェクト用ワークスペースを対象とし、変更には明確な範囲指定と読み戻し確認が必要です。
主な機能
- 01スタジオワークスペースの初期化
- 02プロジェクトの登録と確認
- 03プロジェクトのステータス・アーカイブ状態の更新
- 04命名ポリシーとタスクモードの設定
- 05スタジオ単位の MCP コネクターマニフェスト管理
活用シーン
- 01新しいスタジオワークスペースの設定
- 02既存プロジェクトの登録
- 03プロジェクトのステータスやアーカイブ状態の変更
- 04スタジオの MCP サーバー項目の設定
MCP 対応
スタジオ単位の `.mcp.json` を管理します。初期設定では空の `mcpServers` オブジェクトを作成し、その後のコネクター変更には明示的な許可と確認済みドキュメントが必要です。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ alpacalabsllc/ skills-for-architects --skill studioインストール後、Claude Code で/studioを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
host-contract.jsonREADME.mdscripts/update_preference.py詳細
/as:studio
実行する前に、ホスト契約、このコンポーネントの宣言(skill:studio)、該当するワークスペースのセマンティクスを読みます。共有カタログから必要なモードのみを読み込みます。
ネイティブ呼び出しにはホストアダプターを使用します。ネイティブなワークスペース操作は、ホスト固有のツールと通常のタスク固有コードで実行します。操作名は意味上の範囲を示すものであり、関数呼び出しやディスパッチャーではありません。Arch Studio のランナー、実行可能ファイルのダウンロード、再構築したヘルパーは必要ありません。既存のワークスペースを編集する前に正規のコンテキストを解決します。新規セットアップでは、明示された対象と祖先の境界を検証します。既存の明示的な許可は引き続き有効です。不足している重要な情報や許可がある場合にのみ確認します。
STUDIO.md、プロジェクト登録、同期対象の登録済み Status、Studio 専用のコネクター境界を管理します。状態に応じた歓迎とフォルダーがない場合の動作については、モーメントを読みます。辞退されたセットアップの案内を繰り返してはいけません。タスクが提示されている場合は、そのまま作業に進みます。歓迎やメニューを再表示してはいけません。ツールのみの利用と、有効なスタンドアロンプロジェクトの利用には、Studio の足場は必要ありません。
レコードを変更する前に
永続的な変更を加える前に、ネイティブな変更手順に従います:確認 → 準備 → 準備の検証 → 適用 → 結果の検証 → 完了。まず保留中の作業を確認します。最初の正規書き込みを行う前に準備を完了して検証します。保存済みの元ファイルと準備済みのファイルをそれぞれ再読み込みし、実際の全バイトを確認し、永続的な保存を確立したうえで、実際のアクセス許可、所有権、ACL を調べます。復旧用ファイルを書き込むだけでは、検証は完了しません。検証済みの対象だけを適用します。新たに読み戻して、影響を受ける結果全体とその関連性が検証できた場合にのみ完了とします。読み取り専用の依頼とインラインの下書きには、公開手順は必要ありません。
新規セットアップでは、宣言された Studio ツリー全体と ID を準備します。プロジェクトモードでの登録では、既存プロジェクトの ID を保護しながら STUDIO.md を変更します。ポートフォリオ登録では、許可されている場合に限り、ヘッダーのみのローカル TASKS.csv の削除とプロジェクトのタスクポインターの更新も、同じ準備済みセットに含めます。Status/アーカイブの変更では、いずれかの書き込み処理を実行する前に STUDIO.md と PROJECT.md の両方を準備します。タスクモードの変更では、影響を受けるすべてのレジスターと所有権の参照を含めます。単一設定の編集は、宣言されたファイル/フィールドの範囲内に留めます。任意の設定やコネクターの編集には、それぞれ別個の明示的な許可が必要です。
セットアップ
新規セットアップ、または明示的に要求されたポリシー設定については、スタジオポリシー契約を確認してください。ユーザーに AI 利用ポリシーがあるか、提示されたデフォルトを希望するかを一度だけ尋ね、採用前にデフォルトを提示し、辞退できるようにしてください。既存の参照はそのまま維持し、デフォルトを作成するのは、解決された Standards ルートの governance/ai-policy.md に限ります。参照と採用の選択を STUDIO.md のデータガバナンスセクションに記録してください。既存のセットアッププレビューと読み戻しには、その正確なファイル一式を含めてください。無関係な編集では、すでに設定された選択を維持してください。Skill Maker はそれらを使用するだけです。ポリシーを暗黙に採用または移行してはなりません。
確認済みの正確な新規ターゲットには studio.init を使用してください。不足しているスタジオ名、作業単位、管轄区域(デフォルトなしも有効)、命名ポリシー(as、firm、none)、フォルダ分類体系/管理対象ルート、ドキュメントパステンプレート、およびプロジェクト Kind ごとに対応付けた事務所のステージ用語のみを収集してください。命名と分類体系は、別々の助言項目です。確認済みの正式名称と大文字・小文字表記を維持してください。提供されている建築/ソフトウェア/イニシアチブのステージは Arch Studio が所有するデフォルトであり、外部標準であるとは主張していません。
正確なターゲット、ファイル、管理対象ルート、データ境界を提示してください。記録はユーザーのワークスペースにとどまります。設定済みモデルに提供されたコンテンツには、そのプロバイダーの規約が適用されます。セットアップによって ALPA アカウント、クラウドストレージ、Git リポジトリが作成されることはありません。これらの選択をまとめて確認する具体的なセットアップ承認ゲートを設けてください。フォーマットバージョンは 3 のままです。Document model 1 は新規レコードの形式を示します。既存のワークスペースの変換や後方互換性を考慮したセットアップは提供されません。
セットアップの設定を終える際は、次のように尋ねてください:“Would you like this assistant to use Arch Studio by default for architecture and project work?” 設定プロトコルに従ってください。対象を限定した正確な設定編集をプレビューした後であれば、同じセットアップ承認でその編集も承認できます。一般的な肯定だけでは、未確認のファイル編集は承認されません。それ以外の場合は、セッション内のガイダンスを維持し、具体的な許可のうち不足しているものだけを取得してください。グローバル設定を暗黙に永続化してはなりません。
MCP による指示の配信では、ライフサイクルフックはインストールされません。バックグラウンド更新の設定は、インストール済みパッケージで利用できる機能であり、この MCP ワークフローの対象外です。パッケージの状態を確認または作成せずに、ここでは利用できないことを伝えてください。接続や一般的なセットアップ承認から、有効化されていると推測してはなりません。
確認済みの studio.init 準備をネイティブツールで適用してください。STUDIO.md、アイデンティティ、コネクターマニフェスト(mcpServers は空)、管理対象ルート、ホストのスキルルートを再度開いて確認してください。インストールや接続の確認だけでは、ワークスペースが作成されたことの証明にはなりません。
プロジェクトと設定
studio.statusは、有効な登録と無効な登録、ID の不整合、タスクモードの読み取り専用状態を一覧表示します。不明またはアーカイブ済みのステータスでも、プロジェクトは非表示になりません。認証やネットワークの確認が行われるわけではありません。- プロジェクトの作成では、
project.initに続いてstudio.registerを実行します。それぞれで、すでに承認された同一の ID/対象を使用します。一部のみ完了したプロジェクトはその状態を報告し、再作成せずに登録を再開します。 studio.registerには、不変かつ一意の Project ID と Folder ID を持つ、既存の新モデルの子孫が必要です。パスは相対パスのキャッシュ済みロケーションです。人が付けたフォルダー名から ID を推測しないでください。studio.set-statusとstudio.archiveは、選択したレジストリの Status セルと、対応する PROJECT.md の Status Value セルのみを変更します。ユーザーから該当する特定のプロベナンス変更について別途許可されていない限り、既存の Source セルと Date セルをそのまま保持してください。Source を操作名に置き換えないでください。公開前および実際の読み戻し時に、両ファイルのフィールド単位の差分を比較し、ほかのセルに変更があれば拒否してください。アクティビティだけでは、完了や承認を証明できません。studio.set-namingは、既存の ID やフォルダーの名前を変更せずに、助言的なポリシー/規約を変更します。studio.task-modeは、空の現在モデルのタスクレジスターのみを、1 ライターのトポロジーを維持したまま、プロジェクト所有からスタジオのポートフォリオ所有へ、またはその逆へ切り替えます。データが入力済みのレジスターには、別途指定された現在データの操作が必要です。自動的なマージ/分割や履歴コンバーターは使用しません。
一般的なドメイン作業は、スコープ、完了した成果物、既存の承認内容を添えて、Norma に一度だけ引き継ぐことができます。明示的なスタジオ管理タスクはここで行います。メインハーネスでのエージェント作成は、承認済みのロール/担当と実際の機能に従います。指示やウェルカムメッセージによってワークフローが実行されたと主張しないでください。
オプションの設定とコネクター
studio.preference は、オプションのデフォルトアシスタントの選択にのみ使用し、検証済みのネイティブ指示メカニズムと具体的に承認された差分を用いて、設定プロトコルを適用してください。接続やファイルの保存だけを根拠に、永続化されたと主張することはできません。MCP のバックグラウンドのライフサイクル更新チェックは利用できません。このワークフローを通じて、インストール済みパッケージの更新操作を実行しないでください。
studio.connectors は、スタジオの .mcp.json 境界を管理します。新規セットアップでは、空の mcpServers オブジェクトのみを作成します。後から明示的に設定を求められた場合は、検証済みのコネクター/ホストのドキュメントを使用し、レビュー済みの正確な変更を加え、ほかのエントリーを保持してください。設定するのは、承認済みであることが確認できているサーバーのみです。認証、外部へのメッセージ送信、アカウントのプロビジョニングには、それぞれ実際に利用可能な機能と承認が必要です。ワークスペースのセットアップから、任意のコネクターエンドポイントやシークレットを推測しないでください。
管理後は、共通の完了報告の規約に従ってください。実際に変更した内容と読み戻し結果を報告します。接続やウェルカムメッセージは、ワークスペースの作成ではありません。