mcpField
S
sdd-prompt-builder

sdd-prompt-builder

github.com/robertodiasduarteエージェントワークフロー1160 回インストール4 日前に更新
リポジトリ

sdd-prompt-builder について

sdd-prompt-builderは、タスクと与えられたコンテキストから実行時に使えるプロンプトを1つ作成するエージェントスキルです。簡潔な出力仕様、情報不足への対応、SDD連携ルールを重視します。

主な機能

  1. 01実行用プロンプトを1つ作成
  2. 02出力形式と制約を定義
  3. 03不足・曖昧なコンテキストに対応
  4. 04SDD連携ガイダンスを適用

活用シーン

  1. 01明確なタスク向けのプロンプト作成
  2. 02与えられた文脈を出力仕様に変換
  3. 03SDDワークフロー内でのプロンプト作成

インストール

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

$npx skills add https://github.com/robertodiasduarte/sdd-starter --skill sdd-prompt-builder

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

同梱ファイル

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

agents/
openai.yaml
references/
output-template.md
prompt-building-rules.md
sdd-integration.md

詳細

プロンプトビルダー

このスキルの最初の応答では、次の行を一度だけ先頭に記載します。 sdd-prompt-builder v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest

実行時にすぐ使える、単一の運用プロンプトを作成します。明確さ、出力制御、復旧可能性、提供されたコンテキストへの忠実さを保てる範囲で、プロンプトをできるだけ短くします。

クイックスタート

  1. 実際のタスクと、対象モデルが生成すべき成果物を特定します。
  2. references/prompt-building-rules.mdを読み、タスクに必要なセクションだけを適用します。
  3. 呼び出し元が SDD の場合は、プロンプトを生成する前にreferences/sdd-integration.mdも読みます。
  4. references/output-template.mdを柔軟なひな形として使用し、空または不要なセクションは省略します。
  5. 最終プロンプトを含む TXT BLOCK のみを返します。結果を TypeScript コード、エクスポートされた定数、または出力先ファイルで囲まないでください。

使用する場合／使用しない場合

肯定的なトリガーは frontmatter で定義されており、このスキルを見つけるための情報源として使用してください。

スキルが起動された後は、次の内容に適用しないでください。

  • ナラティブ形式のドキュメント、README、BRAINSTORM／DEFINE／DESIGN、または人間向けのその他のテキスト。
  • SDD フロー自体のオーケストレーションエージェント向けの内部プロンプト。
  • メール、通知、UI のトランザクション用コピー。
  • /build で、LLM Prompts のインベントリが登録されていない状態でドリフトが検出された場合は、直接生成を中断し、references/sdd-integration.mdに従って DESIGN の更新を求めてください。

必要なデータ

手動で使用する場合は、次の情報を受け取ります。

  • プロンプトの目的。
  • コンテキストまたは参考資料（ある場合）。
  • 希望する出力契約、またはそれを推測するために十分な情報。
  • すでに確定しており、再検討してはならない決定事項（ある場合）。

SDD 経由で使用する場合は、references/sdd-integration.mdに記載されているコンパイル済みの契約を受け取ります。呼び出し元がコンテキストのコンパイルを担当している場合は、DEFINE、DESIGN、BUILD_REPORT を独自に読まないでください。

手順

  1. 実際の目的、出力の利用者、期待される自律性のレベルを特定します。
  2. まず、出力の厳密な契約を定義します。種類、構造、必須内容、制限、許可されるフォールバックを明確にします。
  3. 注意事項と制約を、重複のない短い運用ルールに変換します。
  4. 計算、メトリクス、指標、比率、スコアがある場合は、必ず<formulas>を含め、オペランドと演算を明示します。
  5. コンテキストが不足している、曖昧、または検証できない場合の動作を定義します。データを決して捏造しないでください。
  6. 構造化、変換、抽出、または重要度の観点から必要な場合は、短い内部検証を含めます。
  7. バッチ、スロット、リスト、インベントリ、必須セクションについて、完全性の契約を含めます。
  8. 入力が不完全、ノイズを含む、または抽出に失敗する可能性がある場合は、空の結果からの復旧方法を含めます。
  9. スキーマ、テンプレート、ポリシー、例、正式な資料は、ルール内に散在させず<reference_material>内にまとめます。
  10. 装飾的、冗長、または運用に関係しないテキストを削除します。
  11. 以下の品質チェックリストに照らしてプロンプトを検証します。
  12. すぐに使えるプロンプトを含む TXT BLOCK を1つだけ出力します。

検証と品質チェックリスト

回答する前に、内部で次の項目を確認してください。

  • 目的が明確で、実行可能です。
  • 出力仕様が明示されています。
  • 必要に応じて、データが欠落している場合の動作が定義されています。
  • 重要なルールが異なるセクションに重複して記載されていません。
  • タスクが計算に依存する場合、<formulas> が含まれています。
  • 任意のセクションは、信頼性または制御の向上につながる場合にのみ含まれています。
  • 参照資料は、運用上の指示とは分けてあります。
  • ユーザーから明示的に求められていない限り、プロンプトに Reasoning Effort、Verbosity、Mode などのラベルが含まれていません。
  • 最終回答には TXT BLOCK がちょうど1つだけ含まれ、それ以外の成果物はありません。

いずれかの項目を満たしていない場合は、回答を出力する前に修正してください。

例外の処理

  • 自律実行でコンテキストが不足している場合は、承認済みのフォールバックを使用し、規定の形式で利用できないことを記録してください。確認を求めてはいけません。
  • タスクで対話が可能で、安全なフォールバックがないまま必須情報が不足している場合は、必要最小限の情報のみを尋ねてください。
  • 確定済みの決定と新しい資料が矛盾する場合は、確定済みの決定を優先し、契約で許可された範囲でその矛盾を示してください。
  • 有効なインベントリがない状態で SDD プロンプトを変更する場合は、契約を独自に補ってはいけません。references/sdd-integration.md のドリフトフローに従ってください。
  • 数値を推定したり、提供されていない事実を補完したりしてはいけません。

Examples

単純な依頼： Crie um system prompt que classifique tickets em billing, bug ou feature e devolva JSON válido.

期待される結果：

  • 通常は <goal>、<output_contract>、<workflow_rules>、<verification> で構成される簡潔な構成。
  • 装飾的なセクションは含めません。

計算を伴う依頼： Crie um prompt que calcule margem bruta por período a partir de receita e custo.

期待される結果：

  • margem bruta = (receita - custo) ÷ receita を含む <formulas> を追加します。
  • 収益が欠落している場合、またはゼロの場合のフォールバックを定義します。

SDD Open by RDD の一部 — https://github.com/robertodiasduarte/sdd-open

コメント

Markdown 対応