mcpField
S
spec-driven-init

spec-driven-init

github.com/kw12121212開発137 回インストール26 週間前に更新
リポジトリ

spec-driven-init について

spec-driven-initは、プロジェクトに仕様駆動ワークフローを導入するスキルです。プロジェクトの構成を初期化または修復し、背景情報の草案作成や既存動作の仕様化を支援します。

主な機能

  1. 01構成を初期化または修復
  2. 02プロジェクト背景を下書き
  3. 03既存動作を記録
  4. 04仕様インデックスを更新

活用シーン

  1. 01仕様駆動ワークフローの導入
  2. 02不完全な構成の修復
  3. 03既存プロジェクト動作の記録

インストール

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

$npx skills add https://github.com/kw12121212/auto-spec-driven --skill spec-driven-init

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

詳細

プロジェクトで仕様駆動型ワークフローを初期化できるよう、ユーザーを支援します。

このスキルのコマンド

このスキルで使う正確なコマンドを思い出せない場合は、実行する前にここで確認してください。 推測で実行してはいけません。

init: node {{SKILL_DIR}}/scripts/spec-driven.js init [path]

前提条件

対象のプロジェクトディレクトリに、現在の環境からアクセスできる必要があります。 初期化するパスが存在し、意図したプロジェクトのルートであることを、先に確認してください。

手順

  1. 対象プロジェクトを確認する — 初期化するプロジェクトを尋ねます。ユーザーがすでにプロジェクトのルートにいる場合は、現在のディレクトリを使用します。. または明示的なパスを受け付けます。

  2. init を実行する — 次を実行します：

    node {{SKILL_DIR}}/scripts/spec-driven.js init [path]

    パスが現在のディレクトリと異なる場合にのみ、そのパスを渡します。

    • .spec-driven/ が存在しない場合は、roadmap/、specs/、changes/ を含めて一から作成します。
    • .spec-driven/ がすでに存在する場合は、不足しているスキャフォールドファイルを修復し、既存のファイルを上書きせずに specs/INDEX.md を再生成します。

  3. コンテキストを作成する — プロジェクトについて説明している既存ファイル（README.md、AGENTS.md、CLAUDE.md、package.json、pom.xml など）を読みます。次の内容を含む、3～5文の context 値の草案を作成します：

    • プロジェクトの機能
    • 技術スタックと言語
    • 注目すべき主要な規約や制約

    .spec-driven/config.yaml の context フィールドに草案を書き込み、ユーザーに提示して、調整したい点があるか尋ねます。

  4. 既存の動作を記録する — 「このプロジェクトには、文書化する価値のある既存の動作がありますか？」と尋ねます。ある場合は、標準形式を使って .spec-driven/specs/<category>/ の下に初期仕様ファイルを作成するよう支援します：

    • ドメイン領域ごとに分類します（例：auth/、api/、core/）
    • RFC 2119 のキーワードを使い、### Requirement: <name> の見出しを使用します。
    • システムがどうあるべきかではなく、現在の動作を記述します。
    • 新しいファイルごとに .spec-driven/specs/INDEX.md にエントリを追加します。

    既存のプロジェクトでは、この手順が重要です。初期仕様がないと、propose は参照するものがなく、競合を検出できません。

  5. 確認する — 作成した内容をユーザーに示し、ロードマップを作成するには /roadmap-plan を、最初の変更を作成するには /spec-driven-propose を実行するよう提案します。

ルール

  • 変更は作成せず、初期化のみを行います。
  • context フィールドは簡潔にします。AI が作業するには3～5文で十分です。
  • .spec-driven/ がすでに存在する場合、既存のファイルを上書きせず、不足しているスキャフォールドファイルのみを修復します。

コメント

Markdown 対応