cwm-doc-generation

CWM ドキュメントの生成

概要

このスキルでは、ServiceNow のプロジェクトデータから包括的な Collaborative Work Management（CWM）ドキュメントを生成します。

• マイルストーンの進捗、予算、スケジュールの健全性を含むプロジェクト状況レポートを自動生成します
• 影響評価と軽減計画を含むリスク概要を生成します
• 対象者（経営幹部、スポンサー、チーム）に合わせたステークホルダー向けの連絡文を作成します
• 複数のプロジェクト健全性指標をまとめたポートフォリオレベルのダッシュボードを作成します
• タスクデータ、リソース配分、アクティビティ履歴からプロジェクトのインサイトを抽出します
• 会議ですぐに使えるプロジェクト更新プレゼンテーションを生成します

使用する場面： 週次／月次の状況レポートを準備するとき、ステークホルダーにプロジェクトの健全性を伝えるとき、経営陣向けにポートフォリオの状況を要約するとき、またはリスクと問題のダイジェストを生成するときに使用します。

前提条件

• ロール： project_manager、program_manager、portfolio_manager、または admin
• プラグイン： com.snc.project_management（Project Portfolio Management）または CWM ワークスペース
• アクセス権： pm_project、pm_project_task、planned_task、risk、issue、pm_resource_plan テーブルへの読み取りアクセス
• データ： タスク、マイルストーン、ステータスデータが入力されたアクティブなプロジェクト
• 関連スキル： タスク分解には spm/cwm-tasks-generation、分析には spm/project-insights

手順

ステップ 1：プロジェクト概要データを取得する

主要な健全性指標を含むプロジェクトの基本レコードを取得します。

MCP の方法：

Tool: SN-Get-Record
Parameters:
  table_name: pm_project
  sys_id: [PROJECT_SYS_ID]
  fields: sys_id,number,short_description,description,state,phase,priority,percent_complete,planned_start_date,planned_end_date,actual_start_date,actual_end_date,budget_cost,actual_cost,project_manager,sponsor,portfolio,program,health,schedule_health,cost_health,scope_health,resource_health

REST の方法：

GET /api/now/table/pm_project/[PROJECT_SYS_ID]
  ?sysparm_fields=sys_id,number,short_description,description,state,phase,priority,percent_complete,planned_start_date,planned_end_date,actual_start_date,actual_end_date,budget_cost,actual_cost,project_manager,sponsor,portfolio,program,health,schedule_health,cost_health,scope_health,resource_health
  &sysparm_display_value=true

ステップ 2：マイルストーンとタスクの進捗を取得する

マイルストーンの完了状況とタスクの進捗指標を取得します。

MCP の方法：

Tool: SN-Query-Table
Parameters:
  table_name: pm_project_task
  query: project=[PROJECT_SYS_ID]^milestone=true^ORDERBYplanned_start_date
  fields: sys_id,number,short_description,state,percent_complete,planned_start_date,planned_end_date,actual_start_date,actual_end_date,assigned_to
  limit: 50

Tool: SN-Query-Table
Parameters:
  table_name: pm_project_task
  query: project=[PROJECT_SYS_ID]
  fields: sys_id,state,percent_complete,priority
  limit: 500

REST の方法：

GET /api/now/table/pm_project_task
  ?sysparm_query=project=[PROJECT_SYS_ID]^milestone=true^ORDERBYplanned_start_date
  &sysparm_fields=sys_id,number,short_description,state,percent_complete,planned_start_date,planned_end_date,actual_start_date,actual_end_date,assigned_to
  &sysparm_display_value=true

ステップ 3：リスクと問題を取得する

プロジェクトに関連付けられたアクティブなリスクと問題を取得します。

MCP の方法：

Tool: SN-Query-Table
Parameters:
  table_name: risk
  query: task=[PROJECT_SYS_ID]^state!=closed
  fields: sys_id,number,short_description,category,probability,impact,risk_score,response,state,assigned_to,mitigation_plan
  limit: 30

Tool: SN-Query-Table
Parameters:
  table_name: issue
  query: task=[PROJECT_SYS_ID]^state!=closed
  fields: sys_id,number,short_description,priority,state,assigned_to,resolution,sys_created_on
  limit: 30

REST の方法：

GET /api/now/table/risk
  ?sysparm_query=task=[PROJECT_SYS_ID]^state!=closed
  &sysparm_fields=sys_id,number,short_description,category,probability,impact,risk_score,response,state,assigned_to,mitigation_plan
  &sysparm_display_value=true

GET /api/now/table/issue
  ?sysparm_query=task=[PROJECT_SYS_ID]^state!=closed
  &sysparm_fields=sys_id,number,short_description,priority,state,assigned_to,resolution,sys_created_on
  &sysparm_display_value=true

ステップ 4：リソース配分データを取得する

キャパシティと稼働率に関するインサイトを得るために、リソース計画の情報を取得します。

MCP の方法：

Tool: SN-Query-Table
Parameters:
  table_name: pm_resource_plan
  query: project=[PROJECT_SYS_ID]^state=active
  fields: sys_id,resource,role,planned_hours,actual_hours,remaining_hours,start_date,end_date,utilization
  limit: 50

REST の方法：

GET /api/now/table/pm_resource_plan
  ?sysparm_query=project=[PROJECT_SYS_ID]^state=active
  &sysparm_fields=sys_id,resource,role,planned_hours,actual_hours,remaining_hours,start_date,end_date,utilization
  &sysparm_display_value=true

ステップ 5：プロジェクト状況レポートを生成する

すべてのデータをまとめ、構造化された状況レポートを作成します。

=== PROJECT STATUS REPORT ===
Report Date: [current_date]
Project: [number] - [short_description]
Project Manager: [project_manager]
Phase: [phase] | State: [state]

OVERALL HEALTH: [health_indicator]
  Schedule: [schedule_health] | Cost: [cost_health]
  Scope: [scope_health] | Resources: [resource_health]

PROGRESS SUMMARY:
Percent Complete: [percent_complete]%
Planned Timeline: [planned_start] - [planned_end]
Actual Timeline: [actual_start] - [projected_end]
Schedule Variance: [days ahead/behind]

BUDGET STATUS:
Budget: $[budget_cost]
Actual Spend: $[actual_cost]
Remaining: $[budget - actual]
Cost Variance: [percentage]% [over/under]

MILESTONE STATUS:
| Milestone | Planned Date | Status | Variance |
|-----------|-------------|--------|----------|
| [name] | [date] | [on-track/at-risk/complete/late] | [days] |
| [name] | [date] | [status] | [days] |

TASK METRICS:
Total Tasks: [count] | Complete: [count] | In Progress: [count]
Overdue Tasks: [count] | Blocked: [count]

RISKS ([count] active):
| Risk | Probability | Impact | Score | Response |
|------|------------|--------|-------|----------|
| [description] | [H/M/L] | [H/M/L] | [score] | [mitigate/accept/transfer] |

ISSUES ([count] open):
| Issue | Priority | Owner | Status |
|-------|----------|-------|--------|
| [description] | [P1-P4] | [name] | [investigating/resolving] |

KEY ACCOMPLISHMENTS (This Period):
- [Accomplishment 1]
- [Accomplishment 2]

PLANNED ACTIVITIES (Next Period):
- [Activity 1]
- [Activity 2]

DECISIONS NEEDED:
- [Decision 1 with context]

ステップ 6：エグゼクティブサマリーを生成する

経営幹部向けの簡潔な連絡文を作成します。

=== EXECUTIVE SUMMARY ===
Project: [name]
Status: [GREEN/YELLOW/RED]

HEADLINE: [One-sentence project status]

KEY METRICS:
- Progress: [%] complete ([ahead/behind] schedule by [days])
- Budget: $[actual] of $[budget] spent ([%] utilized)
- Next Milestone: [name] due [date] - [status]

TOP RISKS:
1. [Risk description] - Mitigation: [action]
2. [Risk description] - Mitigation: [action]

DECISIONS REQUIRED:
1. [Decision needed with recommendation]

FORECAST: [Project on track for [date] completion / Recommend [action] to recover schedule]

ステップ 7：ステークホルダー向けの連絡文を生成する

対象者に合わせて連絡内容を調整します。

スポンサー向けの更新：

Subject: [Project Name] - Status Update [Date]

Dear [Sponsor Name],

[One paragraph summary of project health and progress]

Key highlights this period:
- [Highlight 1]
- [Highlight 2]

Items requiring your attention:
- [Decision or escalation needed]

Next milestone: [name] targeted for [date].

Full status report attached for reference.

チーム向けの更新：

Subject: [Project Name] - Weekly Update [Date]

Team,

Progress this week:
- [Completed item 1]
- [Completed item 2]

Focus for next week:
- [Priority 1] - Owner: [name]
- [Priority 2] - Owner: [name]

Blockers:
- [Blocker description] - Need: [what is needed]

Reminders:
- [Upcoming deadline or meeting]

ステップ 8：ポートフォリオの概要を生成する

複数のプロジェクトを横断するポートフォリオレベルのレポートを作成します。

MCP の方法：

Tool: SN-Query-Table
Parameters:
  table_name: pm_project
  query: portfolio=[PORTFOLIO_SYS_ID]^state=active
  fields: sys_id,number,short_description,health,percent_complete,schedule_health,cost_health,budget_cost,actual_cost,planned_end_date,project_manager
  limit: 50

=== PORTFOLIO STATUS SUMMARY ===
Portfolio: [name]
Report Date: [date]
Active Projects: [count]

HEALTH OVERVIEW:
Green: [count] | Yellow: [count] | Red: [count]

| Project | Health | Progress | Schedule | Budget | PM |
|---------|--------|----------|----------|--------|-----|
| [name] | [G/Y/R] | [%] | [on-track/late] | [$actual/$budget] | [name] |

PORTFOLIO BUDGET:
Total Budget: $[sum]
Total Spend: $[sum]
Overall Variance: [%]

ATTENTION REQUIRED:
- [Project X]: [issue requiring attention]
- [Project Y]: [risk or escalation]

ツールの使用方法

ツール	目的	使用する場面
SN-Query-Table	プロジェクトのタスク、リスク、問題、リソースを取得する	レポート用のデータ収集
SN-Get-Record	詳細なプロジェクトレコードを取得する	プロジェクトの基本データを取得するとき
SN-Natural-Language-Search	自然言語による説明からプロジェクトを検索する	プロジェクトを探索的に検索するとき
SN-Create-Record	ServiceNow に状況レポートのレコードを作成する	生成したレポートを保存するとき

ベストプラクティス

1. レポート生成を自動化することで、週次の定期実行を通じて一貫性を保ちます
2. 健全性指標を最初に示します。ステークホルダーは状況をひと目で把握したいと考えています
3. 対象者に合わせて詳細度を調整します。経営幹部には概要を、チームには詳細を提示します
4. 差異を強調します。計画を繰り返すのではなく、計画からの逸脱に注目します
5. 実行可能な項目を含めます。すべてのレポートに、明確な次のステップまたは必要な判断を記載します
6. 一貫した書式を使用します。ポートフォリオ全体でレポートのテンプレートを統一します
7. レポートの履歴を追跡します。傾向分析のため、状況レポートのレコードを維持します
8. データの鮮度を確認します。レポートの生成前に、タスクとマイルストーンのデータが最新であることを確認します
9. 更新が滞っているプロジェクトにフラグを付けます。過去 2 週間にアクティビティがないプロジェクトを強調します
10. 予測を含めます。過去の報告だけでなく、必ず将来を見通した予測を示します

トラブルシューティング

問題	原因	解決方法
ヘルスインジケーターが空欄	ヘルス計算が設定されていない、または実行されていない	プロジェクトのヘルス再計算を実行し、ヘルスルールの設定を確認します
マイルストーンの日付がない	タスクにマイルストーンが設定されていない	プロジェクトの主要なタスクに milestone=true が設定されていることを確認します
予算データがゼロと表示される	プロジェクトレコードの予算フィールドに値が入力されていない	budget_cost フィールドと actual_cost フィールドを確認します。別の財務テーブルが使用されている場合があります
リソースデータが不完全	リソース計画が作成されていない、またはリンクされていない	プロジェクトに対する pm_resource_plan レコードが存在することを確認します
リスクスコアが計算されない	リスク評価が完了していない	リスクレコードに確率と影響のフィールドが入力されていることを確認します
ポートフォリオクエリでプロジェクトが返されない	プロジェクトがポートフォリオにリンクされていない	プロジェクトレコードの portfolio 参照フィールドを確認します

例

例 1：週次ステータスレポート

シナリオ： ERP 導入プロジェクトの週次ステータスレポートを生成します。

Tool: SN-Get-Record
Parameters:
  table_name: pm_project
  sys_id: abc123def456
  fields: number,short_description,health,percent_complete,schedule_health,cost_health,budget_cost,actual_cost,planned_end_date

生成されたレポート：

PROJECT STATUS - PRJ0010234: ERP Phase 2 Implementation
Week of March 15, 2026 | Health: YELLOW

Progress: 62% complete (target: 68%) - 6% behind plan
Budget: $1.2M of $2.0M spent (60%) - on track
Schedule: 8 business days behind due to vendor delay

MILESTONES:
- Data Migration Complete: Mar 10 - DONE
- UAT Start: Mar 22 - AT RISK (dependency on data validation)
- Go-Live: Apr 15 - AT RISK (cascading delay)

ACTION NEEDED: Approve additional vendor resources to recover schedule ($45K)

例 2：経営幹部向けポートフォリオ概要

シナリオ： CIO のレビュー用に月次ポートフォリオ概要を生成します。

PORTFOLIO: Digital Transformation 2026
12 Active Projects | Budget: $8.5M

Summary: 8 Green, 3 Yellow, 1 Red
Overall Portfolio Health: YELLOW

RED PROJECT: Cloud Migration Phase 3
- 3 weeks behind schedule
- Key risk: Legacy system dependencies
- Recommendation: Extend timeline by 2 weeks, add integration resources

BUDGET: $3.2M spent of $8.5M (38%) - on track for year

関連スキル

• spm/cwm-tasks-generation - 要件からタスクの内訳を生成します
• spm/project-insights - プロジェクトの分析と傾向分析
• spm/planning-summarization - プロジェクト計画データを要約します
• spm/agile-story-generation - プロジェクト作業用のアジャイルストーリーを生成します
• spm/acceptance-criteria - 成果物の受け入れ基準を定義します