$npx -y skills add arch-team/devpace --skill pace-guardUse when user wants to assess risks before development, check current risk status, analyze risk trends, or says "风险/预检/预分析/guard/risk/隐患/安全检查". Also auto-invoked during advance mode intent checkpoint for L/XL CRs. NOT for /pace-dev (implementation), NOT for /pace-review (quality
| 1 | # /pace-guard — 风险预判与管理 |
| 2 | |
| 3 | 统一管理开发全生命周期的风险:从编码前的 Pre-flight 扫描,到开发中的实时监控,再到跨迭代的趋势分析——让风险可见、可追踪、可解决。风险评估覆盖 Epic 级别(Epic 范围风险影响其下所有 BR/PF/CR)。 |
| 4 | |
| 5 | ## 推荐使用流程 |
| 6 | |
| 7 | ``` |
| 8 | 编码前预检: scan(L/XL CR 意图检查点自动触发) |
| 9 | 开发中监控: monitor(pace-pulse 周期性触发) |
| 10 | 问题解决: resolve RISK-xxx mitigated |
| 11 | 迭代回顾: trends → report |
| 12 | ``` |
| 13 | |
| 14 | ## 子命令 |
| 15 | |
| 16 | | 子命令 | 用途 | 输入 | 自动触发 | |
| 17 | |--------|------|------|---------| |
| 18 | | `scan` | Pre-flight 风险扫描 | CR 编号或当前 CR | L/XL 意图检查点 | |
| 19 | | `monitor` | 实时风险汇总 | 当前 CR | pace-pulse 第 8 信号 | |
| 20 | | `trends` | 跨 CR 趋势分析 | 迭代 ID(可选) | pace-retro 报告 | |
| 21 | | `report` | 风险全局视图 | — | 用户显式调用 | |
| 22 | | `resolve` | 更新风险状态 | RISK 编号 + 目标状态 | Gate 通过后自动提议 | |
| 23 | |
| 24 | ## 输入 |
| 25 | |
| 26 | $ARGUMENTS: |
| 27 | |
| 28 | - `scan [CR编号] [--full|--detail]` → 对指定 CR(或当前活跃 CR)执行 Pre-flight 风险扫描。`--full` 强制完整 5 维扫描,`--detail` 展示全维度矩阵 |
| 29 | - `monitor [CR编号] [--detail|--brief]` → 汇总当前 CR 的实时风险状态。默认简要输出,`--detail` 展开完整表格 |
| 30 | - `trends [迭代ID] [--detail]` → 分析跨 CR 的风险趋势(默认当前迭代)。默认摘要,`--detail` 展示完整趋势报告 |
| 31 | - `report [--brief|--detail]` → 生成项目级风险全局视图 |
| 32 | - `resolve <RISK编号> <目标状态>` → 更新指定风险的状态(mitigated / accepted / resolved) |
| 33 | - `resolve --batch [严重度]` → 批量处理同等级的 open 风险 |
| 34 | - (空)→ 等同于 `scan`,对当前 CR 执行风险扫描 |
| 35 | |
| 36 | ## 流程 |
| 37 | |
| 38 | ### Step 1:上下文加载 |
| 39 | |
| 40 | 1. 检查 `.devpace/` 是否存在: |
| 41 | - **存在** → 读取 `state.md` 确定当前 CR 和项目状态,继续 Step 2 |
| 42 | - **不存在(降级模式)** → 基于代码库直接分析(无 CR 级风险追踪,仅提供即时风险评估) |
| 43 | 2. 如果指定了 CR 编号 → 定位对应 CR 文件 |
| 44 | 3. 如果未指定 → 读取 state.md 当前活跃 CR |
| 45 | |
| 46 | ### Step 2:路由到子命令 |
| 47 | |
| 48 | 根据 $ARGUMENTS 第一个参数路由(**仅读取匹配子命令的规程文件**): |
| 49 | |
| 50 | | 参数 | 流程 | 加载文件 | |
| 51 | |------|------|---------| |
| 52 | | (空)/ `scan` | Pre-flight 风险扫描 | `skills/pace-guard/guard-procedures-common.md` + `skills/pace-guard/guard-procedures-scan.md` | |
| 53 | | `monitor` | 实时风险汇总 | `skills/pace-guard/guard-procedures-common.md` + `skills/pace-guard/guard-procedures-monitor.md` | |
| 54 | | `trends` | 跨 CR 趋势分析 | `skills/pace-guard/guard-procedures-trends.md`(自包含) | |
| 55 | | `report` | 风险全局视图 | `skills/pace-guard/guard-procedures-report.md`(自包含) | |
| 56 | | `resolve` | 更新风险状态 | `skills/pace-guard/guard-procedures-common.md` + `skills/pace-guard/guard-procedures-resolve.md` | |
| 57 | |
| 58 | ### Step 3:执行并报告 |
| 59 | |
| 60 | 1. 按子命令流程执行 |
| 61 | 2. 将风险发现写入 CR 文件"风险预评估"section(scan/monitor 产出) |
| 62 | 3. 更新 state.md(如有状态变化) |
| 63 | 4. **智能推荐**:风险评估类报告末尾根据风险等级推荐下一步操作(详见各子命令规程文件) |
| 64 | |
| 65 | ## 输出 |
| 66 | |
| 67 | 各子命令均支持 `--brief`/`--detail` 分层输出,具体格式和降级模式见对应 procedures 文件。 |