Back to skills
extension
Category: Development & EngineeringNo API key required

requirements-spec-kit

Use Spec Kit to create or append to existing specifications for requirements definition and specification creation (including specification formulation, writing of specification documents, and specification design), generating or updating up to spec.md/plan.md/tasks.md. It is used when there is a need for requirements definition, adding/changing requirements, organizing requirements based on TDD, making specifications explicit, and executing the specify/clarify/plan/tasks flow of Spec Kit.

personAuthor: jakexiaohubgithub

Requirements Spec Kit

Overview

Spec Kit のリポジトリ内テンプレートとスクリプトを使い、要件定義を作成・更新して spec.md → plan.md → tasks.md を完成させる。新規作成か既存追記かを判断し、対象 SPEC を確定してから作業する。

決定フロー: 新規作成 or 既存追記

  • ユーザー入力で即決する: SPEC-ID、spec.md パス、または「追記/既存」指示があれば追記する。
  • 迷う場合は既存 SPEC を検索する: rg -n "# 機能仕様:" specs/SPEC-*/spec.md と主要キーワードで一致確認する。
  • 一致が1件なら追記する。複数一致なら候補(SPEC-IDとタイトル)を提示して選択を求める。
  • 一致が無ければ新規作成する。
  • 追記時は対象 SPEC の worktree/feature ブランチで作業する(.specify/scripts/bash/check-prerequisites.sh は最新 SPEC を選ぶため)。

ワークフロー(specify → clarify → plan → tasks)

1) specify

  • .specify/templates/commands/specify.md を読み、記載のスクリプトを1回実行する。
  • .specify/templates/spec-template.md を用いて spec.md を日本語で埋める。
  • 新規作成時はスクリプト出力の WORKTREE_PATH に移動して以降の作業を行う。
  • 既存追記時は該当セクションのみ更新し、見出し順・FR番号などの連番を維持する。
  • TDD/テスト要求がある場合は、要件または成功基準に「自動テストが必須」である旨を明記する。

2) clarify

  • .specify/templates/commands/clarify.md に従う。
  • 質問は最大5つに抑え、推奨回答を提示する。
  • 回答は spec.md の該当セクションへ即時反映する。

3) plan

  • .specify/templates/commands/plan.md に従う。
  • .specify/memory/constitution.md を参照し、ゲート評価を満たす。
  • 出力(plan.md / research.md / data-model.md / quickstart.md / contracts/)を生成する。

4) tasks

  • .specify/templates/commands/tasks.md に従う。
  • TDD/テスト要求がある場合はテストタスクを必ず含める。
  • tasks.md のチェックリスト形式(ID/Story/ファイルパス)を厳守する。

出力の報告

  • 生成/更新した spec.md、plan.md、tasks.md のパスを報告する。
  • 未解決の明確化が残る場合は、ユーザー回答を得てから次へ進む。