sdlc-create-intent について
非公式な依頼を SDLC の意図ドキュメントにまとめるワークフロースキルです。リポジトリ作業を始めるチーム向けに、目標、範囲、制約、未解決事項を整理し、仕様作成や実装には進みません。
主な機能
- 01intent.md ドキュメントの作成
- 02問題と期待する成果の整理
- 03範囲と対象外事項の記録
- 04制約と未解決事項の整理
- 05仕様やコード作成は行わない
活用シーン
- 01依頼から SDLC 作業項目を開始
- 02不具合の影響と期待動作の明確化
- 03計画前にリファクタリングの維持動作を記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wesleycamargo/ devcontainer-template --skill sdlc-create-intentインストール後、Claude Code で/sdlc-create-intentを入力して読み込まれたか確認します。
詳細
インテントの作成
位置づけ
これは最初の SDLC ステージです。非形式的な依頼を受けて、sdlc//intent.md を作成します。spec.md、plan.md、タスク、コードは作成しないでください。
入力と出力
- 必須の入力:依頼。スコープや制約に影響する場合は、リポジトリの指示と関連する規約を確認します。
- 出力:短い小文字のケバブケースの作業項目ディレクトリに、単独で内容が完結するインテント文書を作成します。外部の作業項目 ID が提供された場合は含めますが、必須にはしません。
責務
根本的な問題や機会、望ましい成果、対象範囲、対象外事項、影響を受けるユーザー、システムまたは機能、重要な制約、該当する場合は測定可能な成功指標を明らかにします。依頼された成果と提案された解決策を分けて記載します。重要な曖昧さ、前提、未解決の質問を記録し、ビジネス上の判断を捏造したり、スコープを拡大したりしないでください。
バグの場合は、実際の動作、期待される動作、影響を説明します。技術的負債の場合は、現在のリスクやコストを説明します。機能の場合は、実現する機能と可能になる成果を説明します。リファクタリングの場合は、必要な理由と、変更せず維持すべき動作を説明します。
関連するセクションのみを使用します。通常は以下のとおりです。
`markdown
インテント:<タイトル>
問題
望ましい成果
スコープ
対象外事項
制約
成功基準
未解決の質問
`
回答によってインテントが大きく変わる場合にのみ質問します。エージェントの対話型質問ツール(Claude Code の場合:AskUserQuestion)を使い、関連する質問を1回にまとめ、提案する選択肢を2~4個提示します。推奨する選択肢を最初に置き、「(推奨)」と表示して、ユーザーがボタンで回答できるようにします。そのようなツールがない場合に限り、プレーンテキストで質問します。重要でない前提は、作業を止めずに妥当なものを記録します。確認済みの制約でない限り、技術やアーキテクチャを選択しないでください。
引き継ぎ
適切な場合は、人によるレビューを依頼します。インテントの承認後、作業項目のパスを添えて sdlc-create-spec に引き継ぎます。後から成果やスコープを変更する場合は、後続の作業で参照される前に、この文書を改訂する必要があります。