mcpField
P
planning-summarization

planning-summarization

github.com/happy-technologies-llc生産性4141 回インストール2 日前に更新
リポジトリ

planning-summarization について

ServiceNow SPMの計画活動を構造化して要約するスキルです。ポートフォリオ、プログラム、プロダクトの担当者向けに、需要、投資、スプリント、リリース、プログラム状況をまとめます。

主な機能

  1. 01需要の状態と優先度の要約
  2. 02ポートフォリオ予算配分の確認
  3. 03スプリント容量とコミット内容の集約
  4. 04リリース準備状況の評価
  5. 05プログラムとプロジェクト状況の集約
  6. 06契約期間の依存関係の確認

活用シーン

  1. 01ポートフォリオガバナンス会議の資料作成
  2. 02スプリント計画サマリーの作成
  3. 03リリース準備状況のレビュー
  4. 04プログラム運営委員会への報告

MCP 対応

ServiceNow MCPツールで需要、プロジェクト、スプリント、ストーリー、リリース、契約を検索し、サマリーを作成する方法を示します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/happy-technologies-llc/happy-platform-skills --skill planning-summarization

インストール後、Claude Code で/planning-summarizationを入力して読み込まれたか確認します。

詳細

計画の要約

概要

このスキルでは、ServiceNow の Strategic Portfolio Management モジュール全体にわたる計画活動を要約するための体系的なアプローチを提供します。次の内容を扱います。

  • ステータス、優先度、事業部門別に需要レコードを集計する
  • ポートフォリオの投資判断と資金配分を要約する
  • キャパシティとコミットメントのデータを含むスプリント計画の要約を作成する
  • フィーチャーの準備状況を示すステータスとともにリリース計画の概要を作成する
  • 主要な指標と推奨事項を含む経営層向け会議の要約を作成する
  • ステアリングコミッティーのレビュー向けにプログラムレベルのステータスを集約する

使用する場面: ServiceNow SPM で、ポートフォリオマネージャー、プログラムマネージャー、またはプロダクトオーナーが、ガバナンス会議、スプリント計画、リリース準備状況のレビュー、経営層への報告に向けて計画データの簡潔な要約を必要とする場合です。

前提条件

  • プラグイン: com.snc.project(Project Portfolio Management)、com.snc.sdlc.agile.2.0(Agile Development 2.0)
  • ロール: demand_manager、portfolio_manager、project_manager、scrum_master、またはprogram_manager
  • アクセス権: dm_demand、pm_portfolio、pm_program、pm_project、rm_sprint、rm_story、rm_release、planned_task テーブルへの読み取りアクセス
  • 知識: 需要管理のライフサイクル、ポートフォリオガバナンスプロセス、アジャイルセレモニーに関する理解

手順

ステップ 1:需要パイプラインを要約する

需要レコードをクエリして、受付パイプラインと保留中の判断を把握します。

MCP を使用する場合(Claude Code/Desktop):

Tool: SN-Query-Table
Parameters:
  table_name: dm_demand
  query: stateNOT IN-5,4,7^ORDERBYpriority
  fields: sys_id,number,short_description,state,priority,type,business_unit,requested_by,requested_for,estimated_cost,estimated_effort,strategic_alignment,score,due_date,assignment_group
  limit: 50

REST API を使用する場合:

GET /api/now/table/dm_demand?sysparm_query=stateNOT IN-5,4,7^ORDERBYpriority&sysparm_fields=sys_id,number,short_description,state,priority,type,business_unit,requested_by,estimated_cost,estimated_effort,strategic_alignment,score,due_date,assignment_group&sysparm_limit=50&sysparm_display_value=true

パイプラインの概要を把握するため、需要を状態別にグループ化します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: dm_demand
  query: state=1
  fields: sys_id,number,short_description,priority,type,business_unit,estimated_cost,score
  limit: 30

REST API を使用する場合:

GET /api/now/table/dm_demand?sysparm_query=state=1&sysparm_fields=sys_id,number,short_description,priority,type,business_unit,estimated_cost,score&sysparm_limit=30&sysparm_display_value=true

需要状態のリファレンス:

状態の値ラベル説明
-5下書き初期作成段階、未完了
1新規提出済み、審査待ち
2審査中初期評価中
3適格詳細分析に進むことを承認済み
10評価詳細なビジネスケースのレビュー
15承認済み資金提供/実行を承認済み
4クローズ完了または却下
7キャンセルパイプラインから取り下げ
ステップ 2:ポートフォリオの配分を評価する

ポートフォリオをクエリして、投資の配分と残りの予算を把握します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: pm_portfolio
  query: state=2
  fields: sys_id,number,short_description,state,total_budget,allocated_budget,remaining_budget,portfolio_manager,fiscal_year,strategic_theme
  limit: 10

REST API を使用する場合:

GET /api/now/table/pm_portfolio?sysparm_query=state=2&sysparm_fields=sys_id,number,short_description,state,total_budget,allocated_budget,remaining_budget,portfolio_manager,fiscal_year,strategic_theme&sysparm_limit=10&sysparm_display_value=true

配分の内訳を把握するため、ポートフォリオ内のプロジェクトをクエリします。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: pm_project
  query: portfolio=[portfolio_sys_id]^stateNOT IN-5,4
  fields: sys_id,number,short_description,state,phase,budget_cost,actual_cost,percent_complete,health,priority,end_date,project_manager
  limit: 30

REST API を使用する場合:

GET /api/now/table/pm_project?sysparm_query=portfolio=[portfolio_sys_id]^stateNOT IN-5,4&sysparm_fields=sys_id,number,short_description,state,phase,budget_cost,actual_cost,percent_complete,health,priority,end_date,project_manager&sysparm_limit=30&sysparm_display_value=true
ステップ 3:スプリント計画の要約を作成する

アジャイルチームでは、キャパシティとコミット済みストーリーを含むスプリント計画データを要約します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: rm_sprint
  query: release.product.sys_id=[product_sys_id]^state=1
  fields: sys_id,number,short_description,start_date,end_date,capacity,story_points,state
  limit: 3

次のスプリントにコミットされたストーリーをクエリします。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: rm_story
  query: sprint=[sprint_sys_id]^ORDERBYpriority
  fields: sys_id,number,short_description,story_points,state,priority,epic,assigned_to,acceptance_criteria,blocked
  limit: 50

REST API を使用する場合:

GET /api/now/table/rm_story?sysparm_query=sprint=[sprint_sys_id]^ORDERBYpriority&sysparm_fields=sys_id,number,short_description,story_points,state,priority,epic,assigned_to,acceptance_criteria,blocked&sysparm_limit=50&sysparm_display_value=true
ステップ 4:リリース準備状況をまとめる

リリースと関連するフィーチャーをクエリして、準備状況を評価します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: rm_release
  query: product.sys_id=[product_sys_id]^state!=3^ORDERBYstart_date
  fields: sys_id,number,short_description,start_date,end_date,state,description
  limit: 5

完了状況別にグループ化して、リリース内のストーリーをクエリします。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: rm_story
  query: sprint.release=[release_sys_id]
  fields: sys_id,number,short_description,story_points,state,epic,sprint,blocked
  limit: 100

REST API を使用する場合:

GET /api/now/table/rm_story?sysparm_query=sprint.release=[release_sys_id]&sysparm_fields=sys_id,number,short_description,story_points,state,epic,sprint,blocked&sysparm_limit=100&sysparm_display_value=true
ステップ 5:プログラムのステータスを確認する

プログラムレベルの計画では、構成プロジェクト全体を集約します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: pm_project
  query: program=[program_sys_id]^stateNOT IN-5,4
  fields: sys_id,number,short_description,state,phase,health,percent_complete,schedule_variance,budget_cost,actual_cost,end_date,project_manager,risk
  limit: 20

REST API を使用する場合:

GET /api/now/table/pm_project?sysparm_query=program=[program_sys_id]^stateNOT IN-5,4&sysparm_fields=sys_id,number,short_description,state,phase,health,percent_complete,schedule_variance,budget_cost,actual_cost,end_date,project_manager,risk&sysparm_limit=20&sysparm_display_value=true
ステップ 6:契約の依存関係を確認する

計画のタイムラインやリソースの確保に影響する有効な契約を確認します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: ast_contract
  query: stateNOT IN-5,3,4^end_date>=javascript:gs.nowDateTime()^ORDERBYend_date
  fields: sys_id,number,short_description,state,vendor,start_date,end_date,contract_value,renewal_date,contract_type
  limit: 15

REST API を使用する場合:

GET /api/now/table/ast_contract?sysparm_query=stateNOT IN-5,3,4^end_date>=javascript:gs.nowDateTime()^ORDERBYend_date&sysparm_fields=sys_id,number,short_description,state,vendor,start_date,end_date,contract_value,renewal_date,contract_type&sysparm_limit=15&sysparm_display_value=true
ステップ 7:経営層向け計画要約をまとめる

すべてのデータを、構成された会議要約にまとめます。

=== PLANNING MEETING SUMMARY ===
Date: 2026-03-19 | Prepared for: Portfolio Governance Board

DEMAND PIPELINE:
  Total Active Demands: 24
  New (Awaiting Screening): 8
  In Screening: 5
  Qualified: 6
  In Assessment: 3
  Approved (Awaiting Funding): 2

  Top Demands by Strategic Score:
  1. DMD0045001 - AI-Powered Customer Analytics (Score: 92, Cost: $380K)
  2. DMD0045002 - Mobile Self-Service Portal (Score: 88, Cost: $220K)
  3. DMD0045003 - Data Center Consolidation (Score: 85, Cost: $1.2M)

  Demands by Business Unit:
  - Engineering: 9 demands ($2.1M estimated)
  - Sales: 7 demands ($890K estimated)
  - Operations: 5 demands ($1.4M estimated)
  - HR: 3 demands ($340K estimated)

PORTFOLIO STATUS:
  Portfolio: FY2026 Technology Investments
  Total Budget: $12,000,000
  Allocated: $9,400,000 (78.3%)
  Remaining: $2,600,000
  Active Projects: 14
  Health: Green (9) | Yellow (3) | Red (2)

SPRINT PLANNING SUMMARY (Team Alpha):
  Sprint: Sprint 2026-04-A (Apr 1-14)
  Capacity: 40 story points
  Committed: 37 story points (92.5% utilization)
  Stories: 12 committed (8 Enhancement, 3 Defect, 1 Spike)
  Blocked Stories: 1 (STY0014523 - awaiting API access)
  Acceptance Criteria Coverage: 11 of 12 stories (91.7%)

RELEASE READINESS - Release 2.4:
  Target Date: 2026-04-30
  Total Stories: 48
  Complete: 31 (64.6%)
  In Progress: 10 (20.8%)
  Not Started: 7 (14.6%)
  Story Points: 189 total, 121 completed
  Risk: MEDIUM - 7 stories unstarted with 6 weeks remaining

KEY DECISIONS NEEDED:
  1. Approve DMD0045001 (AI Analytics) - $380K, aligns with Strategy Theme A
  2. Determine go/no-go for Release 2.4 on April 30
  3. Reallocate $150K from completed PRJ0010038 to underfunded PRJ0010055

RECOMMENDATIONS:
  1. [APPROVE] DMD0045001 - Highest strategic score, budget available
  2. [DEFER] DMD0045003 - $1.2M exceeds remaining budget, defer to Q3
  3. [ESCALATE] 2 Red projects require executive intervention
  4. [PLAN] Schedule Release 2.4 go/no-go review for April 15

ツールの使用方法

MCP ツールのリファレンス
ツール使用する場面
SN-Query-Table需要、プロジェクト、スプリント、ストーリー、リリース、契約の対象範囲を絞ったフィールドをクエリし、要約をローカルで計算する
SN-Get-Record単一のポートフォリオ、プログラム、またはプロジェクトのレコードを取得する
SN-Natural-Language-Search計画項目を自然言語で検索する(例:「エンジニアリング部門で承認された需要を検索する」)
REST API リファレンス
エンドポイントメソッド目的
/api/now/table/dm_demandGET需要パイプラインと受付レコードを照会します
/api/now/table/pm_portfolioGETポートフォリオの予算と投資データ
/api/now/table/pm_programGETプログラムレベルのステータス集計
/api/now/table/pm_projectGETプロジェクトのステータスと財務データ
/api/now/table/rm_sprintGETスプリント計画とキャパシティデータ
/api/now/table/rm_storyGETストーリーのコミットメントと完了状況
/api/now/table/rm_releaseGETリリース計画と準備状況データ
/api/now/table/ast_contractGET契約のスケジュールと依存関係
/api/now/table/planned_taskGETスケジュール分析用の計画タスクデータ

ベストプラクティス

  • 会議前に準備する: レビューの時間を確保できるよう、ガバナンス会議の少なくとも1時間前に要約を作成します
  • 意思決定事項を含める: すべての要約で、参加者に求める意思決定を明確に示します
  • 傾向を示す: 改善や悪化を明らかにするため、現在の指標を前の期間と比較します
  • 戦略的整合性スコアを使用する: 需要を提示する際は、優先順位付けの指針として必ず戦略的整合性を含めます
  • 事実と推奨事項を分ける: データに基づく所見と主観的な推奨事項を明確に区別します
  • 要約ごとの範囲を限定する: 情報過多を避けるため、1つの要約では計画のコンテキスト(ポートフォリオ、プログラム、スプリント、リリース)のいずれか1つに焦点を当てます
  • 意思決定を記録する: 監査証跡として、会議の結果を需要レコードまたはプロジェクトレコードの更新として記録します
  • 予算データを検証する: 経営幹部に提示する前に、ポートフォリオの予算額を財務システムと照合します

トラブルシューティング

「需要レコードに想定したフィールドが表示されない」

原因: カスタム需要フォームでは、フィールド名が異なる場合や、追加のフィールドがある場合があります 解決策: sys_dictionary を name=dm_demand で照会し、インスタンス内の実際のフィールド名を確認します。u_ が接頭辞として付いたカスタムフィールドがないか確認してください。

「ポートフォリオの予算がプロジェクト合計と一致しない」

原因: すべてのプロジェクトがポートフォリオにリンクされているとは限らず、複数のポートフォリオにまたがるプロジェクトもあります 解決策: 各プロジェクトの portfolio フィールドを確認します。また、承認済みでまだプロジェクトに変換されていない需要も確認してください。

「スプリントのキャパシティがゼロと表示される」

原因: キャパシティを手動で設定するか、チームメンバーの稼働状況から算出する必要がある場合があります 解決策: スプリントレコードの capacity フィールドを確認します。空欄の場合は、チームの稼働状況から算出します。チームメンバーの人数に、1人あたりの平均ベロシティを掛けてください。

「リリースのストーリー数が不完全」

原因: ストーリーがリリース内のスプリントにリンクされていても、リリース自体に直接リンクされていない場合があります 解決策: ストーリーの直接のリリースフィールドではなく、sprint.release=[release_sys_id] を指定してストーリーを照会します。

例

例1:四半期ポートフォリオレビューの要約

シナリオ: 第2四半期のポートフォリオガバナンス委員会の会議用に要約を作成します。

Tool: SN-Query-Table
Parameters:
  table_name: pm_portfolio
  query: short_descriptionLIKEFY2026^state=2
  fields: sys_id,number,short_description,total_budget,allocated_budget,remaining_budget,portfolio_manager
  limit: 5

出力:

Q2 2026 PORTFOLIO REVIEW
Portfolio: FY2026 Technology Investments

INVESTMENT SUMMARY:
  Total Budget: $12.0M | Allocated: $9.4M | Available: $2.6M
  Projects Active: 14 | Completing This Quarter: 3 | Starting: 2

QUARTER HIGHLIGHTS:
  - 3 projects on track for Q2 completion (PRJ0010038, PRJ0010041, PRJ0010044)
  - 2 new projects approved from demand pipeline (DMD0045005, DMD0045008)
  - Net budget savings of $340K from completed projects

DEMAND BACKLOG:
  - 5 qualified demands awaiting funding ($1.8M total estimated cost)
  - 2 high-priority demands can be funded from remaining budget

PROPOSED Q2 ACTIONS:
  1. Fund DMD0045001 AI Analytics ($380K from available budget)
  2. Defer DMD0045003 Data Center Consolidation to FY2027 planning
  3. Reallocate $340K savings to PRJ0010055 API Gateway (currently underfunded)
例2:スプリント計画の事前資料
Tool: SN-Query-Table
Parameters:
  table_name: rm_story
  query: sprint.short_description=Sprint 2026-04-A^product.sys_id=[product_sys_id]
  fields: number,short_description,story_points,state,priority,assigned_to,blocked,acceptance_criteria
  limit: 30

出力:

SPRINT PLANNING PRE-READ
Sprint: 2026-04-A (Apr 1-14) | Team: Alpha
Velocity (3-sprint avg): 34 pts | Capacity: 40 pts

PROPOSED COMMITMENT (37 pts):
  P1 - Must Have:
    STY0014520 - Payment retry logic (8 pts, assigned: Dev A)
    STY0014521 - Invoice PDF generation (5 pts, assigned: Dev B)
    STY0014522 - Email notification templates (3 pts, assigned: Dev C)

  P2 - Should Have:
    STY0014523 - Third-party API integration (8 pts, BLOCKED - awaiting access)
    STY0014524 - Dashboard widget for sales (5 pts, assigned: Dev A)
    STY0014525 - Bulk export functionality (3 pts, assigned: Dev D)

  P3 - Nice to Have:
    STY0014526 - UI polish for settings page (2 pts, assigned: Dev C)
    STY0014527 - Logging improvements (3 pts, assigned: Dev B)

RISKS:
  - STY0014523 blocked on vendor API credentials (escalated Mar 15)
  - Dev D at 80% capacity due to support rotation

READINESS CHECKLIST:
  [YES] All P1 stories have acceptance criteria
  [YES] No unresolved dependencies for P1 stories
  [NO]  STY0014523 still blocked - may need to swap with backlog item
  [YES] Team capacity confirmed with all members

関連スキル

  • spm/agile-story-generation - 要件からユーザーストーリーを生成する
  • spm/acceptance-criteria - ストーリーの受け入れ条件を作成する
  • spm/project-insights - プロジェクトの健全性とパフォーマンス指標
  • spm/feedback-summarization - 振り返りとフィードバックの分析
  • reporting/executive-dashboard - 経営幹部向けダッシュボードを作成する

コメント