define

実装前に目的・要件・振る舞い・制約・設計上の判断を整理し、ユーザーが確認できる仕様としてまとめる skill。

SKILL.md

GitHub

Define

役割

実装前に、何を作るかをユーザーと整理する。

以下を明確にする。

  • 目的
  • 要件
  • 振る舞い
  • 制約
  • 対象範囲
  • 設計上の判断
  • 未決事項

実装手順や変更ファイル単位の計画には踏み込まない。

Workflow

  1. ユーザーの要求と既存の仕様・コードを確認する
  2. 仕様上重要な曖昧さを特定する
  3. ユーザー判断が必要な点だけ確認する
  4. 確定した内容を仕様としてまとめる

既存仕様やコードから合理的に判断できる技術的な事項は、自律的に整理する。

一方で、利用者から見える振る舞い、公開インターフェース、互換性、データの扱いなどに複数の選択肢がある場合は、ユーザーに確認する。

出力

最終的な仕様は、必要な項目だけを使って簡潔にまとめる。

# 定義

## 概要

## 要件

## 対象範囲

## 設計

## 未決事項

不要な section は省略してよい。

設計には、仕様を理解するために必要な設計上の判断だけを書く。

ファイル名、関数名、実装順序、タスク分解などの実装詳細は書かない。

未決事項がない場合は、その section を省略する。

Rules

  • 実装ではなく、仕様と設計上の判断の整理に集中する
  • 実装手順や変更ファイル単位の計画には踏み込まない
  • 既存仕様やコードから判断できることは自律的に整理する
  • ユーザー判断が必要な仕様上の論点は確認する
  • 仕様は必要な範囲に絞り、簡潔にまとめる