wecomcli-manage-smartsheet-schema は何をしますか？
企業微信 スマートシート スキーマ管理スキル。サブテーブル（シート）およびフィールド（列/カラム）に対するCRUD操作（作成、読み取り、更新、削除）を提供します。
ユースケース
- スマートシートのサブテーブル一覧の取得
- サブテーブルの追加、更新、削除
- サブテーブル内のフィールド（列）情報の取得
- フィールド（列）の追加、更新、削除
本スキルは、ユーザーがスマートシートのテーブル構造、列定義、サブテーブル設定を管理する必要がある場合に発動します。ドキュメントの指定は、docid またはドキュメントURLのいずれかで行います。
対応プラットフォーム
- 企业微信（WeCom）プラットフォーム
- 対応クライアント：デスクトップ、モバイル
使用方法
以下の例は、スキルを呼び出すための一般的なパターンを示しています。
wecomcli manage-smartsheet-schema get-sheets --docid <ドキュメントID>
wecomcli manage-smartsheet-schema add-sheet --docid <ドキュメントID> --sheet-name "新しいシート名"
wecomcli manage-smartsheet-schema update-sheet --docid <ドキュメントID> --sheet-id <シートID> --new-name "更新されたシート名"
wecomcli manage-smartsheet-schema delete-sheet --docid <ドキュメントID> --sheet-id <シートID>
フィールド操作：
wecomcli manage-smartsheet-schema get-fields --docid <ドキュメントID> --sheet-id <シートID>
wecomcli manage-smartsheet-schema add-field --docid <ドキュメントID> --sheet-id <シートID> --field-type "text" --field-name "新しいフィールド"
wecomcli manage-smartsheet-schema update-field --docid <ドキュメントID> --sheet-id <シートID> --field-id <フィールドID> --new-name "更新されたフィールド名" --new-type "number"
wecomcli manage-smartsheet-schema delete-field --docid <ドキュメントID> --sheet-id <シートID> --field-id <フィールドID>
注：
docidはドキュメントURLのクエリパラメータから抽出するか、直接指定します。
設計意図
- シンプルかつ直感的: CLIインターフェースは学習コストを低減し、スクリプト化や自動化を容易にします。
- エラーハンドリング: 操作が失敗した場合、明確なエラーメッセージが返却されます。
- 冪等性: 可能な限り、同じ操作を複数回実行しても副作用が発生しないように設計されています。
よくある質問
Q: ドキュメントIDがわからない場合はどうすればよいですか？
A: スマートシートのURLを入力してください。スキルが自動的に docid を抽出します。
Q: フィールドタイプにはどのようなものがありますか？
A: text, number, datetime, select（ドロップダウン）、multi-select, link, formula などがサポートされています。
ライセンス
本スキルは、対応プラットフォームの利用規約に従います。