.agents/skills/analyzing-usecases/SKILL.md
要件定義からユースケースとユーザーストーリーを体系的に作成。ビジネスユースケース→システムユースケース→ユーザーストーリーの順に導出し、トレーサビリティを維持する。「ユースケースを作成したい」「ユーザーストーリーを書きたい」「要件定義からストーリーを導出したい」「受け入れ基準を定義したい」といった場面で発動する。ユースケースとストーリーを構造的に紐づけることで、開発フェーズでの「なぜこの機能を作るのか」が常に追跡可能になる。
npx skillsauth add k2works/getting-started-algorithm analyzing-usecasesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
要件定義からユースケースを抽出し、ユーザーストーリーまで一貫したトレーサビリティを維持しながら作成する。
ビジネスユースケース→システムユースケース→ユーザーストーリーの 3 段階で具体化することで、「ビジネス要求」と「実装タスク」の間の論理的なつながりを保証する。
| 種類 | パス | 備考 |
|------|------|------|
| ガイド | @docs/reference/ユースケース作成ガイド.md | ユースケース作成の進め方詳細 |
| テンプレート | @docs/template/完全形式のユースケース.md | 編集禁止。参照のみ |
| 入力 | @docs/requirements/requirements_definition.md | 要件定義 |
| 成果物 | docs/requirements/business_usecase.md | ビジネスユースケース |
| 成果物 | docs/requirements/system_usecase.md | システムユースケース |
| 成果物 | docs/requirements/user_story.md | ユーザーストーリー |
要件定義からビジネスレベルのユースケースを抽出する。システムの詳細には踏み込まず、業務目標とアクターの関係を定義する。
ビジネスユースケースをシステム境界の視点で詳細化する。「システムが何を提供するか」を明確にする。
システムユースケースから開発可能な粒度のユーザーストーリーを導出する。
既存の成果物がある場合は、まず現在の状態を確認する。不足しているステップや更新が必要な部分のみを修正する。
Example:
ユーザー: 「ビジネスユースケースは作った。ユーザーストーリーを書きたい」
回答: ステップ 2(システムユースケース)の存在を確認する。
未作成ならステップ 2 から開始。作成済みならステップ 3 に進む。
既存のビジネスユースケースのアクターとユースケースを起点に、
システムユースケースを詳細化してからユーザーストーリーを導出する。
requirements_definition.md が存在しない場合は analyzing-requirements を先に実行するuser_story.md にはユーザーストーリーのみ記述する。リリース計画・イテレーション計画は planning-releases で別途作成するanalyzing-requirements — 前段の要件定義(RDRA 2.0)planning-releases — 後続のリリース・イテレーション計画orchestrating-analysis — 分析フェーズ全体のワークフロー案内tools
イテレーション計画と上流設計ドキュメント群(ユーザーストーリー、ドメインモデル、データモデル、UI 設計)との整合性を検証する。「イテレーション計画を検証したい」「計画の整合性をチェックして」「イテレーション計画を作成した」「計画と設計ドキュメントの不整合を確認したい」といった場面で発動する。planning-releases でイテレーション計画を作成した直後にも積極的に使用すること。計画作成後に必ず本検証を実施することで、開発着手前にドキュメント間の不整合を検知・修正できる。
tools
プロジェクトの開発進捗を多角的に分析しレポートを生成。イテレーション達成度、技術実装状況、品質メトリクスを確認し、計画ドキュメントを自動更新する。「進捗を確認したい」「プロジェクトの状態を知りたい」「イテレーションの達成度を分析したい」「進捗ドキュメントを更新したい」といった場面で発動する。定期的な進捗可視化により、遅延や品質低下を早期に発見しプロジェクトの透明性を確保する。
testing
リリース計画を GitHub Project・Issue・Milestone に反映し一元管理。初回の一括同期から差異検出・自動同期まで対応する。「GitHub Project に同期したい」「Issue を作成したい」「計画と GitHub の差異を確認したい」「Milestone を設定したい」といった場面で発動する。計画ドキュメントを Single Source of Truth とし GitHub に自動反映することで、二重管理の手間と不整合を排除する。
development
テスト駆動開発から始めるプログラミング入門」の対話式チュートリアル。FizzBuzz を題材に TDD の Red-Green-Refactor サイクルを 14 言語で体験する。「TDD を練習したい」「FizzBuzz で TDD を学びたい」「テスト駆動開発の入門をしたい」「Java で TDD を体験したい」「Python で TDD を始めたい」「プログラミング入門チュートリアルをやりたい」「getting-start-tdd をやりたい」「TDD のハンズオンがしたい」「Red-Green-Refactor を体験したい」といった場面で発動する。TDD チュートリアルやプログラミング入門の要望があれば積極的に使用すること。