🛠️ 開発・MCP コミュニティ

spec-discovery

Parse specs to extract IDs, titles, and traceability metadata (repo, path, hash).

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o spec-discovery.zip https://jpskill.com/download/18051.zip && unzip -o spec-discovery.zip && rm spec-discovery.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/18051.zip -OutFile "$d\spec-discovery.zip"; Expand-Archive "$d\spec-discovery.zip" -DestinationPath $d -Force; ri "$d\spec-discovery.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して spec-discovery.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → spec-discovery フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Spec Discovery Skill

スペックと外部リクエストヘッダーを特定し、ID（例：REQ-NOTIFY-001）を抽出し、ダウンストリームエージェントのために追跡可能なメタデータを返します。

変数

変数	デフォルト	説明
ROOT	.	主要なリポジトリルート
EXTRA_REPOS	[]	`specs/` を含む追加のリポジトリルート
INCLUDE_EXTERNAL_REQUESTS	true	`specs/external-requests/` をスキャンする
OUTPUT_FORMAT	json	json または toon マニフェスト出力

ワークフロー（必須）

リポジトリをロード: ROOT + EXTRA_REPOS
スペックを走査: specs/、specs/external-requests/、specs/templates/ はスキップ
見出しを解析: ^#+\s*(REQ-[A-Za-z0-9_-]+)\s*:?\s*(.*)$ にマッチ
正規化: リポジトリルートからの相対パス、ID + タイトルからのアンカー
トレーサビリティ: ファイルコンテンツの SHA-256 を計算。source_repo、path、hash を記録
マニフェストを発行: JSON/TOON でリポジトリ → パス → ID の順にソート（出力スキーマを参照）

レッドフラグ（停止して確認）

スペックファイルで ID が検出されない → スキップする前に見出しの形式を確認
リポジトリ間で重複するスペック ID → マニフェストの notes フィールドにフラグ
specs/ ディレクトリがない → 失敗するのではなく、空の結果を報告

出力スキーマ

{
  "format": "spec-manifest/v1",
  "generated_at": "<ISO-8601 UTC>",
  "sources": [
    {"repository": "<repo-name>", "root": "<abs-path>"}
  ],
  "specs": [
    {
      "id": "REQ-NOTIFY-001",
      "title": "Email Sending Endpoint",
      "source_repo": "ai-dev-kit",
      "path": "specs/external-requests/notify.md",
      "link": "specs/external-requests/notify.md#req-notify-001-email-sending-endpoint",
      "hash": "<sha256-of-file>"
    }
  ]
}

プロバイダーノート

他のコマンドが /ai-dev-kit:specs-find またはスペックのトレーサビリティを要求する場合、このスキルを使用してください。
マシンワークフローには JSON を優先し、コンパクトなプロンプト埋め込みには TOON を使用してください。
ID/タイトルの大文字/小文字を保持してください。アンカーは小文字 + ハイフンにする必要があります。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Spec Discovery Skill

Locate specs and external request headers, extract IDs (e.g., REQ-NOTIFY-001), and return traceable metadata for downstream agents.

Variables

Variable	Default	Description
ROOT	.	Primary repository root
EXTRA_REPOS	[]	Additional repo roots containing `specs/`
INCLUDE_EXTERNAL_REQUESTS	true	Scan `specs/external-requests/`
OUTPUT_FORMAT	json	json or toon manifest output

Workflow (Mandatory)

Load repositories: ROOT + EXTRA_REPOS
Walk specs: specs/, specs/external-requests/, skip specs/templates/
Parse headings: match ^#+\s*(REQ-[A-Za-z0-9_-]+)\s*:?\s*(.*)$
Normalize: path relative to repo root, anchor from ID + title
Traceability: compute SHA-256 of file content; record source_repo, path, hash
Emit manifest: sorted by repo → path → ID in JSON/TOON (see Output Schema)

Red Flags (Stop & Verify)

No IDs detected in a spec file → confirm heading format before skipping
Duplicate spec IDs across repos → flag in the manifest notes field
Missing specs/ directory → report empty result rather than failing

Output Schema

{
  "format": "spec-manifest/v1",
  "generated_at": "<ISO-8601 UTC>",
  "sources": [
    {"repository": "<repo-name>", "root": "<abs-path>"}
  ],
  "specs": [
    {
      "id": "REQ-NOTIFY-001",
      "title": "Email Sending Endpoint",
      "source_repo": "ai-dev-kit",
      "path": "specs/external-requests/notify.md",
      "link": "specs/external-requests/notify.md#req-notify-001-email-sending-endpoint",
      "hash": "<sha256-of-file>"
    }
  ]
}

Provider Notes

Use this skill when other commands request /ai-dev-kit:specs-find or spec traceability.
Prefer JSON for machine workflows; use TOON for compact prompt embedding.
Preserve ID/title casing; anchors should be lowercase + hyphenated.