SuperAPI AI 工具集

agile-development

编程与开发

查看项目

更新于 10-16 06:13

技能介绍

这是 ServiceNow 的 Agile Development 2.0 模块(插件 com.snc.sdlc.agile.2.0)工具集,不是通用任务跟踪器。表与状态值均为该插件自有的。

用途与校验:所有表都来自该插件,未激活时调用返回“Invalid table”,可先用 await snow_agile_sprint_query({ limit: 1 }) 做无 id 探测,无插件时重试无效。

数据模型:rm_team(含默认 velocity)→ rm_team_member;rm_sprint(时间盒,可归属团队);rm_epic → rm_story(工作单元,含点数、状态、负责人)→ rm_scrum_task;rm_release 汇总冲刺与史诗。pm_project/pm_project_task 属 PPM,是另一套表,不要与 rm_* 混用。

操作顺序为团队 → 冲刺 → 故事,引用不存在即失败。示例:snow_agile_team_manage 创建团队与成员;snow_agile_sprint_manage 创建冲刺(team 按名称或 sys_id 解析);snow_agile_story_manage 创建故事并挂接冲刺或史诗。注意冲刺名称写入 short_description,team 存入 assignment_group。

取值:故事状态为标签对应数字(Draft -6、Ready -5、Work In Progress 2、Testing -2、Closed Complete 3、Closed Incomplete 4),传原始数字不会被翻译,非法值被静默丢弃。冲刺状态仅由 action: "start"(2)与 "close"(3)写入,无重开。故事点用近似斐波那契序列 1、2、3、5、8、13、21;优先级为 1–4。

批量整理用 snow_agile_backlog_groom,支持 reprioritize、estimate、assign_sprint、move_epic,stories 必须是含 sys_id 的对象数组,每项独立更新并返回逐项状态。看板用 snow_agile_sprint_board 与 snow_agile_backlog_query(默认 25 条,需分页)。

报告类只读工具包括:snow_agile_sprint_burndown、snow_agile_velocity_report、snow_agile_capacity_plan、snow_agile_standup_report、snow_agile_retrospective,分别需要冲刺或团队。capacity_plan 默认取 3 个冲刺速度均值;retrospective 未指定冲刺时默认上一个已关闭冲刺。阻塞由 rm_story 的 blocked/blocked_reason 提供。

发布:snow_agile_release_manage 的 readiness 报告关联冲刺与史诗的完成度;状态支持 Draft、Planning、In Progress、Released、Cancelled。故事与冲刺属数据,不会随 update set 迁移。