ub-authoring

UB Authoring

ミッション

このスキルは、スキルや関連するエージェント動作の領域に向けた、移植可能でインストール可能な作成ガイダンスを整えるために使用します。

このスキルが担うのは、リポジトリ内だけのドキュメントや、特定のカスタマイズ専用スキルに置くのではなく、スキルカタログ自体とともに引き継がれる、再利用可能な作成規約です。

使用しない場合

• エンドツーエンドのカスタマイズ生成にはこのスキルを使用しないでください。その場合は ub-customizations に委ねてください。
• 共有の作成規約を変更しない通常のコード実装やフレームワーク作業には、このスキルを使用しないでください。
• 開発リポジトリに属し、配布するスキルのペイロードには含まれない、リポジトリ固有のメンテナンスドキュメントやパッケージングメタデータの代わりとして、このスキルを使用しないでください。

組み込みの契約

以下のルールは、このスキルの基本契約です。正しく適用するために、別のドキュメントに依存してはなりません。

1. 説明はマーケティング文ではなく、振り分け用メタデータとして扱います。
2. 誤ったスキルの起動が現実的に高コスト、または頻繁に発生する場合は、明確な使用対象外の境界を設けます。
3. 曖昧な注意書きよりも、具体例と受け入れ基準を優先します。
4. メインのスキルの内容は簡潔に保ち、詳細は目的に応じたリファレンスに移します。
5. 共有の作成ガイダンスは、インストール済みのスキルペイロード間で移植可能な状態に保ち、再利用可能な契約にリポジトリ固有の最新情報を持ち込まないようにします。
6. 再利用可能な選択式質問の UX 契約は、各スキルで同じ複数選択ルールを再定義するのではなく、共有の作成ガイダンスに含めます。

必要に応じてリファレンスを読み込む

• 共有スキルの構成、スキル間で共通する表現、振り分けの品質、再利用可能な選択式質問の UX、またはその他の再利用可能な作成パターンを整える場合は、references/authoring-conventions.md を読みます。

コアワークフロー

1. タスクが再利用可能な作成規約の変更か、単一スキルのローカルコンテンツの変更かを判断します。
2. 移植可能な共有ガイダンスはこのスキルに、ドメイン固有のガイダンスはそれを所有するスキルに配置します。
3. 変更する箇所に実際に必要な場合にのみ、説明、例、使用対象外の境界、共有の選択式質問の動作を標準化します。
4. 再利用可能なリファレンスはインストール可能な状態に保ち、リポジトリ内だけのドキュメントへの無効なリンクを避けます。

出力要件

重要な作成更新を行う場合は、次の項目を含めます。

1. routing_note
2. boundary_note
3. reference_note
4. validation_note

完了チェックリスト

• 共有ガイダンスは .agents/skills/ 内で移植可能な状態に保たれています。
• 説明は、一覧の説明文ではなく、振り分けのロジックとして読めます。
• 誤振り分けが現実的に起こり得る場合は、使用対象外の境界が明確です。
• 抽象的なガイダンスを誤用しやすい場合は、具体例が示されています。
• 共有リファレンスは、明示的にその旨を示す場合を除き、リポジトリ固有の前提に依存していません。