mcpField
S
sdlc-create-intent

sdlc-create-intent

github.com/wesleycamargoその他039 回インストール3 週間前に更新
リポジトリ

sdlc-create-intent について

非公式な依頼を SDLC の意図ドキュメントにまとめるワークフロースキルです。リポジトリ作業を始めるチーム向けに、目標、範囲、制約、未解決事項を整理し、仕様作成や実装には進みません。

主な機能

  1. 01intent.md ドキュメントの作成
  2. 02問題と期待する成果の整理
  3. 03範囲と対象外事項の記録
  4. 04制約と未解決事項の整理
  5. 05仕様やコード作成は行わない

活用シーン

  1. 01依頼から SDLC 作業項目を開始
  2. 02不具合の影響と期待動作の明確化
  3. 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 に引き継ぎます。後から成果やスコープを変更する場合は、後続の作業で参照される前に、この文書を改訂する必要があります。

コメント