// After (Spec 建议)
public List getUserList(String role, Long departmentId) {
// TODO: 实现三级权限过滤逻辑
if ("dept_admin".equals(role)) {
return userRepository.findByRoleAndDepartment(role, departmentId);
}
return userRepository.findByRole(role);
}
CODEBLOCK2

Skill-3: 前端影响分析 (frontend-impact-analyzer)

功能:

• - [x] 前端框架识别：Vue/React/Angular (自动检测)
• [x] UI 组件定位：找出受影响的页面/组件
• [x] 样式影响分析：CSS/SCSS 变更识别
• [x] 用户流程分析：识别交互路径变化
• [x] 客户体验变化描述：视觉/交互/功能三维评估

输入: PRD-Spec.json + 前端源码目录
输出: Frontend-Change-Spec.md (含客户可见变化说明)

Spec 格式:

## 前端变更规约 (客户可见)

### CP-001: 用户角色权限细化

#### 直接影响 (用户可感知)
1. UserManagement.vue - 筛选器组件
   - 变更类型：UI_MODIFICATION
   - 客户可见度：HIGH
   - 视觉变化：筛选器选项从 2 个增加到 3 个
   - 交互变化：无
   
   变更伪代码:
   

CODEBLOCK4

性能影响评估

• - 页面加载时间：+0.5-1 秒 (因新增级联选择器)
• 首屏渲染：不受影响
• 移动端适配：需要额外测试小屏显示

Skill-4: 智能报告生成与 Spec 组装 (report-generator)

功能:

• - [x] 结构化影响报告：整合前后端变更规约
• [x] 代码标注与解释：自动生成变更说明注释
• [x] 变更建议生成：基于最佳实践的实施方案
• [x] 风险评分：量化评估实施风险 (1-10 分)
• [x] 实施清单生成：分阶段任务列表

输入: Backend-Change-Spec.md + Frontend-Change-Spec.md
输出: PRD-Impact-Analysis-Spec.md (最终可交付规约)

Workflow 编排支持

标准工作流：prd-to-spec-workflow

针对复杂 PRD 分析任务，本 Skill 支持通过 Workflow 进行编排，拆分为以下执行步骤：

CODEBLOCK5

简化工作流：快速分析模式

对于简单需求，可直接调用单个 Skill 进行快速分析：
CODEBLOCK6

WORKFLOW_INIT.md 模板

对于需要复杂上下文的场景，提供初始化模板：

CODEBLOCK7

渐进式上下文管理策略

上下文加载策略

为了避免一次性加载过多信息导致 AI 失焦，采用渐进式加载：

Level 1 - 初始上下文 (系统提示词中):
CODEBLOCK8

Level 2 - 任务触发加载 (执行时动态获取):
CODEBLOCK9

Level 3 - 深度分析加载 (按需检索):
CODEBLOCK10

完整输出示例 (Spec 格式)

PRD-Impact-Analysis-Spec.md

说明: 以下是 Spec Coding 模式下的标准输出格式，所有变更以伪代码 + 变更说明形式呈现，便于工程师审查和修改。

CODEBLOCK11java
// 变更位置：行 120-156
// 变更类型：REFACTOR
// 风险等级：CRITICAL

@Service
public class UserService {

// BEFORE:
// public boolean validateUserPermission(User user, String requiredRole) {
// return user.getRoles().contains(requiredRole);
// }

// AFTER (Spec 建议实现):
public boolean validateUserPermission(User user, String requiredRole, Long targetDeptId) {
// TODO: 重新实现权限验证逻辑
// 1. 超级管理员拥有所有权限
// 2. 部门管理员只能管理部门内用户
// 3. 普通用户只能操作自己

if (user.hasRole("super_admin")) {
return true;
}

if (user.hasRole("dept_admin")) {
return targetDeptId != null && targetDeptId.equals(user.getDepartmentId());
}

return user.getId().equals(targetUserId); // 普通用户
}
}

**变更原因**: 三级权限体系核心逻辑  
**影响范围**: 所有权限校验场景  
**测试要求**: 
- [ ] 单元测试覆盖率 >= 90% (项目规范)
- [ ] 集成测试覆盖所有权限组合
- [ ] 边界 case: 跨部门访问、权限升级

##### 3. UserRepository.java
├── UserManagement.vue (客户直接可见)
│   ├── 受影响部分: 用户列表筛选组件
│   ├── 变更描述: 用户会看到筛选器从两级变为三级下拉选择
│   └── 需要变更:
│       ▸ roles数组从['admin','user']改为['super_admin','dept_admin','user']
│       ▸ 更新筛选组件的选项配置
│
├── UserEditModal.vue (客户直接可见)
│   ├── 受影响部分: 角色分配表单
│   ├── 变更描述: 角色分配界面从单选改为级联选择
│   └── 需要变更: 重新设计角色选择UI组件
│
└── src/api/user.js
└── 受影响接口: getUserList() 参数结构变更


**客户体验变化**:
1. 视觉变化: 筛选器选项从2个增加到3个
2. 交互变化: 角色分配需要先选择部门再选择具体角色
3. 功能变化: 部门管理员只能看到本部门用户

```

客户体验变化:

• - ✅ 交互变化：角色分配从单选改为级联选择
• ⚠️ UI 响应时间：+0.3 秒

影响分析:

📁 后端影响:
├── UserStatController.java (新文件)
│ └── 需要新增: getActiveStatistics() API接口
│
├── UserStatService.java (新文件)
│ └── 需要新增: calculateActivityTrend() 业务逻辑
│
└── LoginLogRepository.java
└── 受影响查询: 需新增findRecentLoginCounts()方法

📁 前端影响 (客户可见变化):
├── UserManagement.vue
│ ├── 新增部分: 活跃度统计图表区域
│ ├── 变更描述: 用户在列表页上方会看到新的统计图表
│ └── 需要变更:
│ ▸ 引入ECharts图表库
│ ▸ 新增统计图表组件ActivityChart.vue
│ ▸ 添加日期选择器组件
│
└── src/api/user.js
└── 新增接口: getActiveStatistics()

客户体验变化:

1. 1. 新增功能: 页面顶部增加可视化统计图表
2. 数据展示: 可切换查看不同时间段的活跃趋势
3. 交互增强: 支持图表点击查看详情

🎯 客户可见变化汇总

直接影响 (用户可直接感知)

1. 1. 界面布局变更: 用户管理页面增加统计图表区域
2. 筛选功能变更: 角色筛选从两级变为三级级联选择
3. 数据展示变更: 用户列表新增"最后活跃时间"列
4. 操作流程变更: 编辑用户需要先选择部门再选角色
5. 权限提示变更: 无权限操作时显示更详细的说明

间接影响 (用户体验相关)

1. 1. 页面加载时间: 因统计图表增加，页面初始加载可能慢0.5-1秒
2. 数据时效性: 活跃度统计有1小时延迟
3. 移动端适配: 统计图表在小屏上可能显示不全

⚠️ 风险评估

高风险区域

1. 1. 权限验证逻辑 (后端: UserService.java)

1. 2. 级联选择组件 (前端: UserEditModal.vue)

中等风险区域

1. 1. 统计图表数据准确性
2. 数据库查询性能

📋 实施清单

第一阶段: 后端变更

[ ] 1. UserController.java - 修改查询接口
[ ] 2. UserService.java - 重构权限验证
[ ] 3. 新增UserStatController.java
[ ] 4. 数据库变更脚本

第二阶段: 前端变更

[ ] 1. UserManagement.vue - 集成统计图表
[ ] 2. 新增ActivityChart.vue组件
[ ] 3. 修改角色选择组件为级联选择
[ ] 4. 更新API调用层

第三阶段: 测试验证

[ ] 1. 权限功能测试
[ ] 2. 图表展示测试
[ ] 3. 性能测试
[ ] 4. 跨浏览器兼容性测试