mcpField
D
detect-stack

detect-stack

github.com/jordancoin開発1167 回インストール35 週間前に更新
リポジトリ

detect-stack について

detect-stackは、プロジェクトを調査して簡潔な`.agents/stack-context.md`を生成するコーディングスキルです。コーディングエージェントが言語、フレームワーク、テスト、CIチェック、規約を把握でき、情報が古くなった際の再実行にも対応します。

主な機能

  1. 01言語とフレームワークの検出
  2. 02テストとCIチェックの確認
  3. 03規約とディレクトリ構成の調査
  4. 04スタックコンテキストファイルの生成
  5. 05古いコンテキストの再実行条件

活用シーン

  1. 01未知のプロジェクトで作業を始めるとき
  2. 02依存関係の変更後に情報を更新するとき
  3. 03プロジェクトのチェック項目や規約を確認するとき

MCP 対応

フレームワークのAPI詳細が必要な場合、context7 MCPでドキュメントを参照し、対応情報がなければウェブ検索を使うよう案内します。

インストール

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

$npx skills add https://github.com/jordancoin/codingskills --skill detect-stack

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

詳細

スタックの検出

現在のコードベースを分析し、.agents/stack-context.md を生成します。プロジェクトで初めて使用するとき、またはスタックコンテキストが存在しないか古くなっているときに実行します。

検出する内容

プロジェクトのルートをスキャンして、次の手がかりを探します。

言語 — ファイル拡張子（.rs、.py、.ts、.go、.swift、.java、.rb、.cs、.ex など）の数を数えます。最多のものを主要言語とします。ほかの言語も記録します。

フレームワーク — パッケージマニフェストを読み取ります。

  • Cargo.toml → [dependencies] で axum、actix、rocket、sqlx、diesel、tokio を確認します
  • package.json → react、next、svelte、express、fastify、prisma を確認します
  • go.mod → gin、echo、fiber、chi、sqlc を確認します
  • pyproject.toml / requirements.txt → django、flask、fastapi、sqlalchemy を確認します
  • Gemfile → rails、sinatra を確認します
  • Package.swift → Vapor を確認し、SwiftUI のインポートをスキャンします
  • mix.exs → phoenix、ecto を確認します

テスト — テスト用ディレクトリ、テストファイルの命名パターン、テスト設定ファイルを探します。

CI ゲート — .github/workflows/、.gitlab-ci.yml などをスキャンして、ブロッキングチェック（フォーマット、リント、型チェック、テスト）を確認します。

規約 — CLAUDE.md、AGENTS.md、CONTRIBUTING.md を確認します。ディレクトリ構成と命名パターンを記録します。

出力

.agents/stack-context.md に書き込みます。40 行未満に収めてください。

# Stack Context

Generated: YYYY-MM-DD

## Stack
- **Language**: [primary] [version if pinned]
- **Framework**: [web framework], [db layer]
- **Build**: [build tool]
- **Test**: [test command + framework]
- **Lint**: [linter] [CI gate: yes/no]
- **Format**: [formatter] [CI gate: yes/no]

## Secondary Languages
- [language] ([what it's used for])

## Conventions
- Error handling: [pattern]
- Module structure: [pattern]
- Naming: [pattern]
- Tests: [where they live, how they're organized]

## CI Gates
- [list of blocking checks]

スタック固有の原則の適用

スタックコンテキストを書き込んだ後は、静的なリファレンスファイルを生成しないでください。代わりに、次の手順に従います。

  1. 検出した言語／フレームワークに関する組み込み知識を使い、各コーディング原則を慣用的な方法で適用します
  2. 特定のフレームワーク API の詳細が必要な場合は、context7 MCP（resolve-library-id の後に query-docs）を使って最新のドキュメントを取得します
  3. context7 で対応できない場合は、フォールバックとしてウェブ検索を使います

コーディング原則のスキルは、設計上、言語に依存しません。原則とスタックをつなぐのがあなたの役割です。

再実行するタイミング

  • .agents/stack-context.md が存在しない
  • 主要な依存関係に変更があった（新しいフレームワークの導入、言語バージョンの更新）
  • プロジェクト構成が大幅に変わった
  • コンテキストファイルが 30 日以上前のものである

コメント

Markdown 対応