mcpField
D
design

design

github.com/boshu2開発45050 回インストール1 日前に更新
リポジトリ

design について

Discovery の本格着手前に、提案目標が製品方針に合うかを評価するスキルです。PRODUCT.md を基に採点し、product council による審査も追加できます。クイックモードと厳格モードに対応します。

主な機能

  1. 015つの製品整合性評価軸
  2. 02PRODUCT.md に基づく目標確認
  3. 03product council による審査
  4. 04クイックなインライン評価
  5. 05厳格な合格基準
  6. 06設計ドキュメントの作成

活用シーン

  1. 01Discovery 前の機能提案の選別
  2. 02目標とペルソナや課題との整合性確認
  3. 03高リスク変更の厳格な審査

インストール

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

$npx skills add https://github.com/boshu2/agentops --skill design

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

同梱ファイル

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

references/
alignment-matrix.md
design.feature
product-council-preset.md
project-reality-check.md
scripts/
validate.sh

詳細

/design -- プロダクト検証ゲート

クイックリファレンス： 探索で本格的な作業を始める前に、提案された目標がプロダクトの戦略的な方向性と一致しているかを検証します。--preset=product を指定した Council による判定が必要です。

クイックスタート

/design "add caching layer for CLI"           # validate goal against PRODUCT.md
/design --quick "add caching layer"           # inline check, no council spawning
/design --strict "redesign hook system"       # higher threshold (avg >= 2.5)
/design                                       # infers goal from recent context

実行手順

Step 0: PRODUCT.md を確認する

リポジトリのルートにある PRODUCT.md を探します。

ls PRODUCT.md 2>/dev/null

存在しない場合： 警告を出力し、次の注記を添えて PASS を返します：「PRODUCT.md が見つからないため、プロダクト検証ゲートをスキップします。/product を実行して生成してください。」

存在する場合： Step 1 に進みます。

Step 1: プロダクトのコンテキストを読み込む

PRODUCT.md を読み込み、以下を抽出します。

  • ミッション -- プロダクトの中核となる目的
  • ペルソナ -- 定義済みのユーザータイプとそのニーズ
  • ギャップ -- 既知のプロダクト上のギャップやロードマップ項目
  • 競合環境 -- プロダクトの差別化要因

セクションが欠けている場合は、利用できない旨を記録し、該当する評価項目を控えめに採点します（1）。

Step 2: 整合性マトリクスを採点する

5つの評価項目について、提案された目標を評価します。references/alignment-matrix.md の採点基準を使用してください。

評価項目スコア（0～3）根拠
ギャップとの整合性この目標は既知のプロダクト上のギャップに対応していますか？
ペルソナとの適合性定義済みのペルソナに役立ちますか？
競争力の差別化競争上の優位性を強化しますか？
先例類似の作業が過去に行われていますか？そこから何を学べますか？
スコープの適合性現在のフェーズに適したスコープですか？

5つの評価項目すべての平均スコアを算出します。

Step 3: Council を実行する

プロダクトプリセットを使用して Council を呼び出します。判定者の設定については、references/product-council-preset.md を参照してください。

Skill(skill="council", args="--preset=product validate design alignment for: <goal>")

Step 2 の整合性マトリクスを、Council の判定者にコンテキストとして渡します。

--quick フラグが設定されている場合、Council の起動をスキップし、代わりにインライン評価を行います。

Step 4: 設計成果物を書き込む

設計成果物を .agents/design/ に書き込みます。

mkdir -p .agents/design

ファイル名：<date>-design-<goal-slug>.md（例：2026-03-30-design-add-caching-layer.md）

成果物の内容：

  • 目標の説明
  • スコアと根拠を含む整合性マトリクス
  • Council の判定（--quick の場合はインライン評価）
  • 最終判定と推奨事項
Step 5: 判定を出力する

スコアに基づいて最終判定を決定します。

条件判定
平均スコア >= 2.0 かつ、スコアが 0 の評価項目がないPASS -- 目標はプロダクトの方向性と一致しています
平均スコア >= 1.5、または他の評価項目のスコアが高く、1 項目だけが 0WARN -- 目標には整合性上の懸念があるため、先に進む前に確認してください
平均スコア < 1.5、またはスコアが 0 の評価項目が複数あるFAIL -- 目標はプロダクトの方向性と一致していません

--strict が設定されている場合、PASS のしきい値を平均 >= 2.5 に引き上げます。

次の形式で判定を出力します。

DESIGN VERDICT: <PASS|WARN|FAIL>
  Gap Alignment:     <score>/3 -- <one-line rationale>
  Persona Fit:       <score>/3 -- <one-line rationale>
  Competitive Diff:  <score>/3 -- <one-line rationale>
  Precedent:         <score>/3 -- <one-line rationale>
  Scope Fit:         <score>/3 -- <one-line rationale>
  Average:           <avg>/3.0
  Artifact:          .agents/design/<filename>.md

フラグ

フラグ効果
--quickCouncil を起動せずにインラインでチェックします。高速ですが、詳細度は下がります。
--strictPASS のしきい値を平均 >= 2.0 から平均 >= 2.5 に引き上げます。重要度の高い変更に使用します。

参考ドキュメント

See Also

コメント

Markdown 対応