github-spec-kit

Github Spec Kit

概要

このスキルでは、GitHub Spec Kit を使用した仕様駆動開発（SDD）のプロセスを説明します。コード優先から仕様優先の開発へ移行し、製品シナリオと予測可能な成果に重点を置くことで、高品質なソフトウェアの開発を支援します。

ワークフロー

Github Spec Kit のワークフローは、次の主要な段階で構成されています。新しい機能やプロジェクトでは、順番に進めてください。

1. 初期化: プロジェクトの構成をセットアップします。
2. 憲章: プロジェクトの原則を定義します。
3. 仕様作成: 機能仕様を作成します。
4. 計画: 技術的な実装を設計します。
5. タスク: 計画を実行可能なタスクに分解します。
6. 実装: タスクを実行します。

各ステップの詳しい手順については、WORKFLOW.md を参照してください。

使用ガイド

1. 初期化

• 目標: 新しいプロジェクトを立ち上げます。
• 操作: uvx --from specify-cli specify init . --here --ai [MODEL] を使用します。
• Git の確認: 実行前に、ディレクトリがすでに git リポジトリになっているか確認します（例: git rev-parse --is-inside-work-tree）。競合を避けるため、--no-git フラグは git リポジトリがすでに初期化されている場合に限り使用します。
• 確認: specify-cli を利用できることを確認します。一貫性を保つため、uvx の使用を推奨します。

2. 原則（憲章）

• 目標: プロジェクトを統制する原則を確立します。
• トリガー: /speckit.constitution に応答します。
• 操作: .specify/memory/constitution.md を作成または更新します。
• 重点項目: コード品質、テスト基準、パフォーマンスなどの基本方針を定義します。

3. 仕様作成

• 目標: 「何を」「なぜ」行うのかを説明します。
• トリガー: /speckit.specify に応答します。
• 操作: .specify/templates/spec-template.md のテンプレートを使用して、specs/<feature>/spec.md を作成します。
• 重点項目: ユーザーシナリオ、成果、機能要件を記述します。実装の詳細は避けてください。

4. 計画

• 目標: 「どのように」行うのかを定義します。
• トリガー: /speckit.plan に応答します。
• 操作: specs/<feature>/plan.md（および任意で data-model.md、research.md）を作成します。
• 重点項目: アーキテクチャ、技術スタック、データ構造、アルゴリズムを定義します。

5. タスク

• 目標: チェックリストを作成します。
• トリガー: /speckit.tasks に応答します。
• 操作: 計画と仕様に基づいて、specs/<feature>/tasks.md を作成します。
• 重点項目: ユーザーストーリーごとにまとめた、小さく検証可能なステップを定義します。

6. 実装

• 目標: コードを記述します。
• トリガー: /speckit.implement に応答します。
• 操作: tasks.md のタスクを順番に実行します。
• 動作: 現在のタスクを読み取り、実装して検証した後、完了としてマークします。

リソース

• ワークフローの詳細: WORKFLOW.md