planning-summarization

规划摘要

概述

此技能提供了一种结构化方法，用于汇总 ServiceNow 战略组合管理模块中的规划活动。内容包括：

• 按状态、优先级和业务部门汇总需求记录
• 汇总组合投资决策和资金分配
• 生成包含产能和承诺数据的迭代规划摘要
• 创建包含功能就绪状态的发布规划概览
• 生成包含关键指标和建议的高管会议摘要
• 汇总计划层级的状态，供指导委员会审查

适用场景： 当组合经理、计划经理或产品负责人需要为 ServiceNow SPM 中的治理会议、迭代规划、发布就绪情况审查或高管简报，生成简明的规划数据摘要时。

先决条件

• 插件： com.snc.project（项目组合管理）、com.snc.sdlc.agile.2.0（敏捷开发 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_demand	GET	查询需求管道和需求收集记录
/api/now/table/pm_portfolio	GET	项目组合预算和投资数据
/api/now/table/pm_program	GET	汇总计划级状态
/api/now/table/pm_project	GET	项目状态和财务数据
/api/now/table/rm_sprint	GET	Sprint 规划和容量数据
/api/now/table/rm_story	GET	故事承诺和完成状态
/api/now/table/rm_release	GET	版本规划和就绪情况数据
/api/now/table/ast_contract	GET	合同时间线和依赖关系
/api/now/table/planned_task	GET	用于进度分析的计划任务数据

最佳实践

• 会前准备： 至少提前 1 小时生成摘要，以便预留审阅时间
• 包含决策事项： 每份摘要都应清楚说明需要与会者作出哪些决策
• 展示趋势： 将当前指标与上一周期进行比较，以突出改善或恶化情况
• 使用战略契合度评分： 展示需求时，务必包含战略契合度，以指导优先级排序
• 区分事实与建议： 清楚区分数据驱动的观察结果与主观建议
• 限制每份摘要的范围： 每份摘要聚焦于一个规划场景（项目组合、计划、Sprint 或版本），以避免信息过载
• 跟踪决策： 将会议结果记录为需求或项目记录的更新，以留存审计轨迹
• 验证预算数据： 向高管汇报前，将项目组合预算数字与财务系统进行交叉核对

故障排除

“需求记录未显示预期字段”

原因： 自定义需求表单可能使用不同的字段名称，或包含其他字段
解决方案： 使用 name=dm_demand 查询 sys_dictionary，以查明实例中的实际字段名称。检查是否存在以 u_ 为前缀的自定义字段。

“项目组合预算与项目总和不符”

原因： 并非所有项目都关联到了该项目组合，或者有些项目跨越多个项目组合
解决方案： 检查每个项目的 portfolio 字段。还要检查是否存在已批准但尚未转换为项目的需求。

“Sprint 容量显示为零”

原因： 可能需要手动设置容量，或根据团队成员的可用时间进行计算
解决方案： 检查 Sprint 记录的 capacity 字段。如果为空，请根据团队可用情况计算：团队成员人数乘以每人的平均速度。

“版本中的故事数量不完整”

原因： 故事可能关联到了版本中的 Sprint，但未直接关联到版本本身
解决方案： 使用 sprint.release=[release_sys_id] 查询故事，而不是查询故事上的直接版本字段。

示例

示例 1：季度项目组合评审摘要

场景： 为 Q2 项目组合治理委员会会议准备摘要。

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：Sprint 规划会前阅读材料

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 - 构建高管仪表板