AI PM 版本任务进度风险分析
目的
为指定版本执行标准化任务进度风险扫描，输出风险清单、问题归因、解决建议和结构化 Markdown 报告。
本文件描述技能的触发方式、执行顺序和关键约束；详细业务口径统一收敛到 references/spec.md。执行过程中如发现两处描述不一致，以 references/spec.md 为唯一规则源，避免双处维护导致的口径漂移。
资源
references/spec.md：唯一业务规范来源，包含术语、数据结构、接口调用口径、风险判断规则、归因规则、建议生成规则、异常处理、限制条件和标准输出模板。
适用场景
- 分析某个版本的任务进度风险，例如“帮我分析 CB_week6 的进度风险”。
- 扫描当前版本的存在进度问题或进度风险的任务。
- 输出版本级任务风险巡检报告。
- 对任务、依赖项、工单节点进行归因分析并生成跟进建议。
执行原则
- 先读取
references/spec.md，再开始分析。 - 将
references/spec.md视为唯一事实来源，不在本文件重复维护规则表、模板和示例。 - 严格按规范执行；若接口、字段、映射关系或版本范围缺失，明确提示缺失项。
主流程
接口名称、参数口径、字段约束、异常处理和标准输出模板均以 references/spec.md 为准，不在本文件重复展开。
-
校验前提
- 先确认版本识别、基础任务查询、统一时间判断和基础异常处理能力可用。
- 依赖项查询、工单详情、工单依赖、workitem_id映射等按需能力在对应步骤再校验；不满足时按references/spec.md降级或中止。 -
识别版本
- 按references/spec.md的“版本识别与异常处理”确定version_id。
- 版本缺失、未命中或匹配多个候选时，直接返回规范要求的提示或候选列表。 -
扫描四类风险任务
- 分四次独立查询：已出现进度问题的进行中任务、已出现进度问题的待启动任务、存在进度风险的任务、待排期任务。
- 禁止混查后自行重分类；即使分类为空，也保留该分类输出结构。 -
归因分析
- 对前三类任务按task_id查询依赖项并依规范归因；待排期任务直接归因为待排期。
- 仅对符合条件的进行中任务，在存在当前节点且可获取或映射workitem_id时，按节点粒度补充工单卡点分析。
- 若节点、映射或工单能力不足，仅输出证据支持的归因粒度，不虚构工单明细；多归因、多节点和多条内容格式统一按references/spec.md执行。 -
生成建议
- 按归因类型套用建议模板并填充任务、依赖项、工单字段。
- 保持一因一策；字段缺失或人员异常时按规范标注数据不完整或补充交接提示。 -
输出报告
- 严格按references/spec.md的标准输出模板生成报告。
- 固定输出异常与数据完整性说明、风险概览和四类风险清单；空分类保留标题和表头。
输出要求
- 先基于事实完成判断，再在同一输出结构中附上归因和建议。
- 统一使用
references/spec.md中定义的字段命名、分类口径和描述方式。 - 若存在接口失败、字段缺失、版本不匹配、超时、网络异常等情况，必须优先写入固定的
异常与数据完整性说明区块，并说明影响范围、降级处理或中止原因。 - 即使无异常，也保留
异常与数据完整性说明区块，并填写规范定义的默认语句。 - 除非上游规范变更，不擅自修改风险判断标准、归因规则和输出模板。
禁止事项
- 禁止脱离
references/spec.md自行扩展或改写业务规则。 - 禁止在本文件重复维护规则表、建议模板、异常处理表和完整输出模板。
- 禁止在缺少证据时将普通状态直接定性为阻塞。
- 禁止遗漏
问题归因与解决建议的对应关系。
