{"id":48148178,"url":"https://github.com/fideguch/requirements_designer","last_synced_at":"2026-04-04T17:02:16.679Z","repository":{"id":346673443,"uuid":"1190405867","full_name":"fideguch/requirements_designer","owner":"fideguch","description":"対話型Q\u0026Aで要件定義書（チャーター・FR/NFR・ユーザーストーリー・品質スコア）を生成するClaude Codeスキル / Claude Code skill for interactive requirements definition — generates charters, FR/NFR, user stories, and quality scores via Q\u0026A","archived":false,"fork":false,"pushed_at":"2026-04-02T11:37:11.000Z","size":552,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T18:55:32.109Z","etag":null,"topics":["claude-code","figma","pm-skill","requirements"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fideguch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-24T08:53:42.000Z","updated_at":"2026-04-02T11:37:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fideguch/requirements_designer","commit_stats":null,"previous_names":["fideguch/requirements_designer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fideguch/requirements_designer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fideguch%2Frequirements_designer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fideguch%2Frequirements_designer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fideguch%2Frequirements_designer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fideguch%2Frequirements_designer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fideguch","download_url":"https://codeload.github.com/fideguch/requirements_designer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fideguch%2Frequirements_designer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31407401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","figma","pm-skill","requirements"],"created_at":"2026-04-04T17:02:12.902Z","updated_at":"2026-04-04T17:02:15.508Z","avatar_url":"https://github.com/fideguch.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Requirements Designer\n\n**692 tests** | **Figma MCP integrated**\n\n## Product Vision\n\n\u003e **JTBD**: PM がインタラクティブ Q\u0026A を通じて、品質スコア付きの要件ドキュメント一式を生成する\n\n| Field           | Definition                                                                      |\n| --------------- | ------------------------------------------------------------------------------- |\n| **Target User** | プロダクト開発を始める PM / テックリード                                        |\n| **Core Value**  | 暗黙知の構造化 — 質問バンクとルーブリックで「書いたつもり」を防ぐ               |\n| **Scope**       | Phase 0-5 (理解→FR→NFR→US→スコアリング→UIデザイン), 3 Mode (Full/Light/Enhance) |\n| **Non-Goals**   | 実装計画の作成 (speckit-bridge/writing-plans の領域), コード生成, テスト作成    |\n\n**Suite内の位置づけ**: `**requirements_designer** → speckit-bridge → my_pm_tools`。パイプラインの最上流、全プロダクト開発の起点。\n\n---\n\n対話式Q\u0026Aで要件定義を行う Claude Code スキル。\n「○○の要件定義をしたい」と伝えるだけで、プロジェクト憲章・機能要件・非機能要件・ユーザーストーリーを段階的に生成し、品質スコアで改善点を提示する。Figma MCP連携でデザインシステム・ワイヤーフレーム・モックアップまで一気通貫で生成可能。\n\n---\n\n## Quick Start\n\n```bash\n# 1. Clone\ncd ~/.claude/skills \u0026\u0026 git clone git@github.com:fideguch/requirements_designer.git\n\n# 2. Install \u0026 verify\ncd requirements_designer \u0026\u0026 npm install \u0026\u0026 npm test\n\n# 3. Use\n# Claude Code で「要件定義をしたい」と入力するだけ\n```\n\n**動作要件**: Node.js 20+ / Claude Code CLI\n\n---\n\n## Features\n\n- **3つのモード** — Full（本番, 40-60分）/ Light（MVP, 15-20分）/ Enhance（既存プロダクト改善, 30-45分）\n- **7つの成果物を自動生成** — 憲章・FR・NFR・US・UL・ワークフロー設定・UIデザインブリーフ\n- **5次元品質スコアリング** — 網羅性・具体性・テスト可能性・一貫性・追跡可能性（100点満点）\n- **Figma MCP連携** — 要件からデザインシステム・WF・モックアップを直接Figmaに生成\n- **ユビキタス言語 (DDD)** — ドメイン用語の自動抽出 + UI/コード命名規則の統一\n- **85問+ 質問バンク** — Phase 1-3 の質問カタログで抜け漏れを防止\n- **ドリフト防止** — Phase 2 で目標・スコープとの矛盾を自動検出、却下スコープを理由付き記録\n- **エラーハンドリング** — Phase 5 開始時の品質スコア閾値チェック（70未満で警告、ユーザー判断でオーバーライド可能）\n- **スキル自動起動** — 各フェーズで関連スキルを自動呼び出し（要件フェーズ5種 + デザインフェーズ5種）\n- **692件の回帰テスト** — Playwright + TypeScript、CI/CD完備\n- **Markdownプレビュー** — designs/をブラウザにレンダリング表示。外部依存不要、ファイル間ナビゲーション対応\n\n---\n\n## Modes\n\n|                  | Full             | Light              | Enhance                      |\n| ---------------- | ---------------- | ------------------ | ---------------------------- |\n| **対象**         | 本番プロジェクト | MVP / PoC          | 既存プロダクト改善           |\n| **所要時間**     | 40-60分          | 15-20分            | 30-45分                      |\n| **品質評価**     | 5次元 100pt      | 3次元 60pt         | 5次元 100pt（デルタ調整）    |\n| **合格ライン**   | 70/100           | 42/60              | 70/100                       |\n| **Phase 5 (UI)** | 実行             | スキップ           | スキップ                     |\n| **特徴**         | 全フェーズ実行   | 質問・FR項目を削減 | Webリサーチ + 変更ヒアリング |\n\n---\n\n## How It Works\n\n### Phase 0: ワークフロー設定\n\nモード選択（Full / Light / Enhance）とスキップ設定を `designs/workflow_config.md` に記録。\n\n### Phase 1: プロジェクト理解 (1-2 ラウンド)\n\nプロジェクト憲章を作成。背景・目的・アクター・スコープ・成功基準を整理。\nEnhanceモードではインターネットリサーチとヒアリングを同時進行。\n\n### Phase 2: 機能要件の抽出 (2-5 ラウンド)\n\nアクターごとに機能を深掘り、`FR-001` 形式で記録。ドリフト防止チェック付き。信頼設計質問（Tier 1: 全プロジェクト / Tier 2: AI機能時）で信頼FRも抽出。\nEnhanceモードでは Change Type（Add / Modify / Remove）を付与。\n\n### Phase 3: 非機能要件の抽出 (2-3 ラウンド)\n\n10カテゴリで抽出。不明項目はWeb検索でベストプラクティスを提案。\n\n### Phase 4: 品質評価・仕上げ\n\n- **4A**: 品質スコアリング（5次元 x 20pt = 100pt）\n- **4B**: ユーザーストーリー自動生成（Given-When-Then 受け入れ基準付き）\n- **4C**: ユビキタス言語定義（ドメイン用語 + コード命名規則）\n- **4D**: 次のステップ提案（PRD化 / 実装計画 / UIデザイン / 品質改善）\n\n### Phase 5: UIデザイン (3-5 ラウンド) — Figma MCP連携\n\n開始条件: Phase 4 完了 + 品質スコア \u003e= 70（70未満は警告の上、ユーザー判断でオーバーライド可能）。\n\n| Sub-phase | 目的                    | 成果物                                      |\n| --------- | ----------------------- | ------------------------------------------- |\n| **5A**    | UIデザインブリーフ作成  | `designs/ui_design_brief.md`                |\n| **5B**    | IA \u0026 ユーザーフロー     | FigJam IA図 + 画面インベントリ              |\n| **5C**    | デザインシステム構築    | Figma DS (カラー/タイポ/スペーシング変数)   |\n| **5D**    | ワイヤーフレーム        | グレースケール WF (バッチ3-5画面)           |\n| **5E**    | モックアップ \u0026 品質評価 | 高忠実度モックアップ + UIデザイン品質スコア |\n\n必須フェーズ（スキップ不可）: Phase 1, Phase 2, Phase 4A, Phase 4B, Phase 4D\n\n---\n\n## 生成されるドキュメント\n\n```\ndesigns/\n├── workflow_config.md             … ワークフロー設定 (Phase 0)\n├── README.md                      … プロジェクト憲章\n├── functional_requirements.md     … 機能要件 (FR-001〜)\n├── non_functional_requirements.md … 非機能要件 (NFR-001〜)\n├── user_stories.md                … ユーザーストーリー (US-001〜)\n├── ubiquitous_language.md         … ユビキタス言語定義 (UL-001〜)\n└── ui_design_brief.md             … UIデザインブリーフ (Phase 5)\n```\n\n---\n\n## Quality Scoring\n\n| 次元                       | 配点 | 評価内容                               |\n| -------------------------- | ---- | -------------------------------------- |\n| 網羅性 (Completeness)      | 20   | 全アクター網羅、CRUD操作、エッジケース |\n| 具体性 (Specificity)       | 20   | 定量的な値、具体的データ形式           |\n| テスト可能性 (Testability) | 20   | 明確なpass/fail基準、受け入れ基準      |\n| 一貫性 (Consistency)       | 20   | 用語統一、矛盾なし、ID参照の整合性     |\n| 追跡可能性 (Traceability)  | 20   | 目標→FR→NFR→USの紐付け                 |\n\n- **70点未満**: 追加Q\u0026Aラウンドを推奨\n- **70〜79点**: 実装計画に進めるが改善余地あり\n- **80点以上**: PRD化・実装計画への移行を推奨\n\n### ライトモード品質評価 (3次元 60pt)\n\n網羅性・具体性・テスト可能性の3次元 x 20pt = 60点満点。合格ライン: 42/60 (70%)。\n一貫性・追跡可能性はMVP段階では評価をスキップする。\n\n### エンハンスモード品質評価\n\nデルタ要件（Add/Modify/Remove）向けに調整された5次元100pt評価。\n詳細は `references/enhance_mode.md` 参照。\n\n---\n\n## Usage\n\n### コマンド例\n\n| 入力                                       | 動作                              |\n| ------------------------------------------ | --------------------------------- |\n| `Slackボットの要件定義をしたい`            | Phase 1 から開始                  |\n| `既存プロダクトの改善要件を定義したい`     | エンハンスモードで開始            |\n| `既存のdesigns/を読み込んで続きをやりたい` | 進捗判定して途中から再開          |\n| `品質スコアを出して`                       | Phase 4A の品質スコアリングを実行 |\n| `ユーザーストーリーを生成して`             | Phase 4B のUS生成を実行           |\n| `ヘルプ`                                   | クイックガイドを表示              |\n| `プレビューして`                       | designs/ をブラウザでプレビュー表示 |\n\n### トリガーワード\n\n`要件定義` / `requirements definition` / `機能要件` / `非機能要件` / `要件を整理` / `user stories` / `ユーザーストーリー` / `プロジェクト憲章` / `project charter` / `UIデザイン` / `Figmaデザイン` / `ワイヤーフレーム` / `モックアップ` / `デザインシステム` / `既存プロダクト改善` / `機能改善` / `プレビューして` / `preview` / `マークダウンプレビュー`\n\n---\n\n## Skill Auto-Invocation\n\n各フェーズで関連スキルを自動起動（詳細は `references/skill_orchestration.md`）。\n\n**要件フェーズ（自動起動）:** `/brainstorming`, `/pm-problem-statement`, `/pm-jobs-to-be-done`, `/pm-pestel-analysis`, `/pm-user-story`, `/pm-user-story-mapping`\n**デザインフェーズ（自動起動）:** `/ui-ux-pro-max`, `/frontend-design`, `/web-design-guidelines`, `/pm-customer-journey-map`, `/cro-methodology`\n**完了後（手動提案）:** `/speckit-bridge`, `/doc-coauthoring`, `/writing-plans`\n\n---\n\n## File Structure\n\n```\nrequirements_designer/\n├── SKILL.md                           # スキル定義 (589行)\n├── README.md                          # このファイル\n├── templates/                         # designs/ にコピーされるテンプレート (7件)\n│   ├── README_charter.md              #   プロジェクト憲章\n│   ├── functional_requirements.md     #   機能要件\n│   ├── non_functional_requirements.md #   非機能要件\n│   ├── user_stories.md                #   ユーザーストーリー\n│   ├── workflow_config.md             #   ワークフロー設定\n│   ├── ubiquitous_language.md         #   ユビキタス言語定義\n│   └── ui_design_brief.md            #   UIデザインブリーフ\n├── references/                        # スキル実行中に参照するリファレンス (11件)\n│   ├── question_bank.md               #   Phase 1-3 質問カタログ (85問)\n│   ├── quality_rubric.md              #   品質評価ルブリック (Full/Light/Enhance)\n│   ├── enhance_mode.md                #   エンハンスモード詳細手順\n│   ├── skill_orchestration.md         #   プロジェクトスキャン・スキル自動起動マップ\n│   ├── best_practices.md              #   NFR提案用ベストプラクティス\n│   ├── ubiquitous_language_questions.md #  UL質問カタログ\n│   ├── phase5_ui_design.md            #   Phase 5 詳細手順リファレンス\n│   ├── ui_design_questions.md         #   UIデザイン質問カタログ\n│   ├── ui_design_rubric.md            #   UIデザイン品質ルブリック\n│   ├── figma_code_patterns.md         #   Figma Plugin APIパターン集\n│   └── ux_trust_design.md            #   UX信頼設計リファレンス (2層: Tier 1全プロジェクト + Tier 2 AI)\n├── scripts/\n│   ├── scaffold-requirements.sh       #   designs/ 初期セットアップ\n│   ├── preview-designs.sh             #   designs/ ブラウザプレビュー\n│   └── generate-preview.js            #   プレビューHTML生成\n└── tests/                             # 回帰テスト (692件, 18ファイル)\n    ├── structure.spec.ts              #   構造テストエントリ\n    ├── content.spec.ts                #   コンテンツテストエントリ\n    ├── phases.spec.ts                 #   フェーズテスト\n    ├── references.spec.ts             #   リファレンステスト\n    ├── trust-design.spec.ts           #   UX信頼設計テスト\n    ├── linkify-ids.spec.ts            #   アンカーリンク検証テスト\n    ├── helpers/\n    │   └── test-helpers.ts            #   テストユーティリティ\n    ├── structure/\n    │   ├── file-existence.spec.ts     #   ファイル存在チェック\n    │   ├── skill-frontmatter.spec.ts  #   SKILL.md フロントマター検証\n    │   ├── template-content.spec.ts   #   テンプレート内容検証\n    │   ├── template-privacy.spec.ts   #   テンプレートプライバシー検証\n    │   └── template-navigation.spec.ts #  テンプレートナビゲーション検証\n    ├── content/\n    │   ├── cross-references.spec.ts   #   ファイル間参照整合性\n    │   ├── phase-workflow-core.spec.ts #   フェーズワークフロー (コア)\n    │   ├── phase-workflow-modes.spec.ts #  フェーズワークフロー (モード別)\n    │   ├── rubric-scoring-core.spec.ts #   品質ルブリック (コア)\n    │   └── rubric-scoring-integration.spec.ts # 品質ルブリック (統合)\n    └── scenarios/\n        └── workflow-scenarios.spec.ts #   ワークフローシナリオテスト\n```\n\n---\n\n## Language Support\n\n- ユーザーの入力言語を自動検出し、出力をその言語に合わせる\n- 要件ID (`FR-001`, `NFR-001`, `US-001`) とセクションヘッダは英語で統一\n- 日本語・英語の両方に対応\n\n## Research Credits\n\nUX信頼設計の2層アーキテクチャは以下のリサーチに基づく:\n\n- Nielsen 10 Usability Heuristics / NNGroup State of UX 2026\n- Google PAIR Guidebook (Explainability + Trust Calibration)\n- Smashing Magazine: Agentic AI UX Patterns (2026/02)\n- Microsoft Copilot UX Guidance / HAX Toolkit\n- Apple HIG: Machine Learning\n- Baymard Institute / Standard Beagle / UX Design Institute\n\n詳細は `references/ux_trust_design.md` リサーチソースセクション参照。\n\n## License\n\nPrivate skill. All rights reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffideguch%2Frequirements_designer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffideguch%2Frequirements_designer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffideguch%2Frequirements_designer/lists"}