mcpField
C
constraint-specification

constraint-specification

github.com/owl-listenerエージェントワークフロー191376 回インストール20 週間前に更新
リポジトリ

constraint-specification について

AI出力の制約を定めるチーム向けのエージェントスキルです。形式、長さ、内容、トーン、品質を扱い、優先順位や競合の解決、境界テストも整理して出力のばらつきを抑えます。

主な機能

  1. 01形式、長さ、内容の制約分類
  2. 02トーンと品質要件の指定
  3. 03制約の優先順位設定
  4. 04制約間の競合解決
  5. 05境界テストケースの設計

活用シーン

  1. 01構造化出力の要件作成
  2. 02プロンプト要件間の優先順位の明確化
  3. 03出力制約の境界ケースのテスト

インストール

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

$npx skills add https://github.com/owl-listener/ai-design-skills --skill constraint-specification

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

詳細

制約仕様

制約とは、AI の出力を形作るルールです。使用する形式、長さ、含める内容、除外する内容などを定めます。適切に定義された制約は、予測可能で有用な出力を生みます。曖昧な制約では、一貫性のない結果になります。

制約の種類

形式に関する制約:

  • 出力構造(JSON、Markdown、プレーンテキスト、箇条書き、文章)
  • セクションの見出しと構成
  • 必須フィールドと任意フィールド
  • データ型とスキーマ 長さに関する制約:
  • 単語数の範囲(正確な数ではなく、モデルは数えるのが苦手です)
  • セクションの長さの割合(「分析に60%、提案に40%を割く」)
  • 最小値と最大値
  • 簡潔さに関する指示(「簡潔に」対「詳しく」) 内容に関する制約:
  • 含めるトピックと除外するトピック
  • 必須の情報要素
  • 禁止されている内容
  • 情報源の制限(提供されたコンテキストのみを使用し、外部知識は使わない) トーンに関する制約:
  • 丁寧さのレベル
  • 感情的なトーン
  • 対象読者に適した言葉遣い
  • 文体とスタイルのガイドライン 品質に関する制約:
  • 正確性の要件(「情報源を引用する」「不確実性を明示する」)
  • 完全性の要件(「質問のすべての側面に対応する」)
  • 独自性の要件(「質問をそのまま繰り返さない」)
  • 実行可能性の要件(「すべての提案を実行可能にする」)

効果的な制約の書き方

  • 具体的にする:「簡潔に」より「回答を200語以内にする」のほうが明確です
  • 優先順位を付ける:制約が競合する場合、どちらを優先するかを示します。「簡潔さより正確性を優先する」
  • 例を示す:制約された出力がどのようなものかを示します
  • 境界をテストする:各制約の境界では何が起きるかを確認します
  • 厳格な制約と柔軟な制約を分ける:厳格な制約は必ず満たす必要があります。柔軟な制約は好みを示します

制約の相互作用

制約は相互に作用し、競合することがあります。

  • 「詳しく」対「100語以内にする」
  • 「創造的に」対「この形式に厳密に従う」
  • 「役に立つ」対「医療に関する助言はしない」 プロンプトで競合を明示的に解決してください。どの制約を優先すべきかモデルに推測させないでください。

設計成果物

  • 出力の種類ごとの制約仕様書
  • 制約の優先順位
  • 制約のテストケース(各制約に負荷をかけるよう設計された入力)
  • 制約違反の例(悪い例の内容)
  • 制約の変更履歴(制約がいつ、なぜ変更されたか)

コメント