mcpField
C
creation-feasibility-gate

creation-feasibility-gate

github.com/oimiragieoエージェントワークフロー4457 回インストール17 週間前に更新
リポジトリ

creation-feasibility-gate について

新しいエージェント、スキル、ワークフロー、フック、テンプレート、スキーマの作成可否を事前評価するスキルです。重複確認とファイル単位の根拠に基づき、PASS、WARN、BLOCK と次の手順を返します。

主な機能

  1. 01重複と既存項目の確認
  2. 02スタックと連携の事前確認
  3. 03セキュリティ境界の確認
  4. 04PASS、WARN、BLOCK の判定
  5. 05根拠と解決手順

活用シーン

  1. 01新しいスキル案の確認
  2. 02ワークフロー作成準備の評価
  3. 03作成前の阻害要因の特定

インストール

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

$npx skills add https://github.com/oimiragieo/agent-studio --skill creation-feasibility-gate

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

同梱ファイル

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

commands/
creation-feasibility-gate.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
rules/
creation-feasibility-gate.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

詳細

作成実行可能性ゲート

概要

新しいエージェント／スキル／ワークフロー／フック／テンプレート／スキーマを作成する前に、迅速な事前実行可能性チェックを行います。これにより、価値の低い作成処理や実行不可能な作成処理を防ぎます。

使用するタイミング

  • フェーズ 0.5 の動的作成フロー
  • ユーザーが新しい機能を求めている場合
  • 振り返り／進化によってアーティファクトの作成が推奨された場合

絶対遵守事項

  1. 絶対にこのスキル内でアーティファクトを作成してはいけません。証拠を添えて PASS／WARN／BLOCK のみを返してください。実際の作成はすべて、後続の適切な作成スキルで行います。
  2. 必ず最初に存在確認／重複チェックを実行してください。いずれかのカタログまたはレジストリに機能的に同一のアーティファクトがすでに存在する場合、PASS に進んではいけません。
  3. 必ずすべての判断に、ファイル単位の具体的な証拠を含めてください。特定のパスまたはカタログ項目を参照せずに PASS または BLOCK のみを返すことは、仕様違反です。
  4. 絶対にWARN を暗黙のうちに PASS にしてはいけません。すべての WARN で、作成を進める前に呼び出し元エージェントが了承しなければならない、具体的な注意事項を列挙してください。
  5. 必ず実行可能な次の手順と推奨する対象エージェントを示して、BLOCK を解消してください。解決タスクがない BLOCK は、不完全なゲート判断です。

アンチパターン

アンチパターン失敗する理由正しいアプローチ
重複チェックを実行せずに PASS を返すアーティファクトが重複し、エージェントへのトラフィックが分散してカタログが肥大化しますPASS の前に、必ずカタログ＋レジストリ＋ファイルシステムを確認します
解決タスクを含めずに BLOCK を返す呼び出し元エージェントが、次に進む手段を得られず停止しますブロックを解消するための具体的なエージェント／スキルを nextActions に含めます
セキュリティ／作成者境界チェックを省略する作成経路がガバナンスフックによってブロックされる場合があります。それを暗黙に回避すると、実行時に失敗しますPASS の前に、作成スキルの連鎖が実行可能であることを必ず確認します
WARN を単なる情報として扱うWARN の注意事項がユーザーに伝わらず、リスクが未解決のまま作成が進みます呼び出し元は、タスクメタデータ内で WARN を明示的に了承する必要があります
ゲートスキル内で作成手順を実行する関心の分離に違反します。ゲートの出力を独立して検証できなくなりますゲートは判断 JSON のみを出力し、作成は作成スキルに委任します

ワークフロー

ステップ 1：対象の特定
  • 提案されたアーティファクトの種類と名前を特定します
  • 想定されるランタイム／ツールの依存関係を特定します
  • 想定される所有者エージェントを特定します
ステップ 2：存在確認／重複チェック（絶対遵守事項 #2）

共有の重複検出ライブラリを使用します。

const { checkDuplicate } = require('.claude/lib/creation/duplicate-detector.cjs');
const result = checkDuplicate({
  artifactType: artifactType, // from Step 1 classification
  name: proposedName,
  description: proposedDescription,
});

if (result.decision === 'EXACT_MATCH') {
  return {
    gate: 'BLOCK',
    reason: `Artifact exists at ${result.matchedPath}. Use the ${artifactType}-updater skill instead.`,
  };
}
if (result.decision === 'REGISTRY_MATCH') {
  return {
    gate: 'WARN',
    reason: `"${proposedName}" found in ${result.message} but file may be missing. Investigate.`,
  };
}
if (result.decision === 'SIMILAR_FOUND') {
  return {
    gate: 'WARN',
    reason: `Similar artifacts found: ${result.candidates.map(c => `${c.name} (${(c.score * 100).toFixed(0)}%)`).join(', ')}. Confirm creation is intentional.`,
  };
}
return { gate: 'PASS' };

検出レイヤーは 3 つ（ファイルシステム、レジストリ／カタログ、ファジー／セマンティック）あり、ライブラリ内部で処理されます。詳細は .claude/lib/creation/duplicate-detector.cjs を参照してください。

ステップ 2.5：追加の事前チェック

具体的な証拠を添えて、以下のチェックを実行します。

  1. スタック互換性チェック
    • 必要なツール／ランタイムが、現在のプロジェクトの規約で利用可能であること
  2. 統合準備状況チェック
    • 作成後にルーティング／検出／割り当てが可能であること
  3. セキュリティ／作成者境界チェック
    • 作成経路とガバナンスの要件を満たせることを確認します
ステップ 3：判断

次のいずれかのステータスを返します。

  • PASS：現時点で作成可能です
  • WARN：明確な注意事項があれば作成可能です
  • BLOCK：作成できません。まずブロッカーを解消する必要があります

次の出力形式を使用します。

{
  "status": "PASS|WARN|BLOCK",
  "artifactType": "agent|skill|workflow|hook|template|schema",
  "artifactName": "example-name",
  "evidence": ["..."],
  "blockers": [],
  "nextActions": ["..."]
}

出力プロトコル

BLOCK の場合は、具体的な解決タスクと推奨する対象エージェントを含めてください。 PASS または WARN の場合は、次に実行する作成スキルの連鎖を正確に含めてください。

メモリプロトコル

実現可能性のパターンと繰り返し発生する阻害要因を .claude/context/memory/learnings.md に記録します。

コメント

Markdown 対応