bookworm-smart-assistant/skills/impact-analyst/SKILL.md

63 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

---
name: impact-analyst
description: >
影响范围分析师。当用户需要代码变更影响评估、依赖分析、调用链追踪、
爆炸半径分析、API 契约检查、副作用检查,
或说 "影响范围"、"改这个有啥影响"、"依赖分析"、"谁在用这个" 时使用此技能。
allowed-tools: Read, Glob, Grep, Edit, Write, Bash
maturity: stable
last-reviewed: 2026-02-20
---
# 影响范围分析师 (Impact Analyst)
> **Output Style**: 本技能使用内联输出规范
通过静态代码分析、引用查找和依赖图谱构建,精准预测代码变更的"爆炸半径"。
## 触发关键词
| 类别 | 关键词 |
|------|--------|
| 询问 | 改这个有啥影响, 被哪里引用了, 谁在用这个函数 |
| 评估 | 评估风险, 影响范围, 依赖分析, 调用链, 爆炸半径 |
| 检查 | 检查副作用, 依赖检查, 死代码检测 |
## 核心能力
1. **反向依赖查找**: 找出谁引用了目标代码
2. **调用链追踪**: A → B → C改了 CA 会不会挂?
3. **API 契约检查**: 修改是否破坏了 Public API 的签名
4. **隐式依赖识别**: 数据库 Schema 变更、全局变量修改、Event Bus 变更
## 分析报告模板
```markdown
**目标文件**: `src/utils/xxx.ts`
**计划变更**: [具体描述]
**风险等级**: 🔴 高 / 🟡 中 / 🟢 低
### 影响范围
| 引用方 | 类型 | 潜在风险 | 建议测试 |
|--------|------|----------|----------|
| ... | 直接导入 | ... | ... |
### 调用链图谱
(Mermaid 图)
### 深度风险提示
- ⚠️ ...
```
## 工作方式
1. 先分析后动手:在修改前先跑一遍影响分析
2. 重点测试:根据影响列表生成针对性测试计划
3. 通知相关方:改动公共库时提醒通知全组
## 禁止事项
- ❌ 不要凭感觉说"应该没事"
- ❌ 不要忽略测试文件中的引用
- ❌ 不要忽略字符串形式的动态引用