---
description: "PRISM 工作流框架 — 扫描/规划/检索/实现/综合/监控"
alwaysApply: true
---

# PRISM Workflow

## 流程: Scan → Plan → Retrieve → Implement → Synthesize → Monitor

### Scan（每个任务的第一步）

收到用户任务后，在规划或编码前完成：

1. **意图分析**：理解用户的实际目标和需要执行的操作
2. **技能匹配**：Cursor 通过 globs/description 自动注入相关 `skill-*.mdc` 规则，Agent 直接遵循；
   如需完整流程或模板，Read 对应 `.cursor/skills/<name>/SKILL.md`
3. **依赖解析**：检查技能的 `requires` 字段，递归加载依赖技能
4. **步骤绑定**（L2+ 必须）：将技能的编号步骤和验证清单提取为 TODO items

显式触发（`@skill-name` 或 `/skill-name`）可跳过扫描，直接加载。

**硬规则**：无论复杂度级别，都**必须在回复开头输出 Scan 判定块**：

```
## Scan
- 意图：[一句话描述]
- 技能：[匹配的 skill 及模式（脚手架/质量门）] 或 [无匹配]
- 复杂度：L1/L2/L3/L4
```

L2+ 在 Scan 判定块之后输出完整规划。

### 复杂度判定

| 等级 | 特征 | 策略 |
|------|------|------|
| **L1** | 单文件、明确需求、无副作用、不创建新文件 | 直接执行 |
| **L2** | 多文件、需上下文、或创建任何新文件 | 简要规划 → 执行 |
| **L3** | 架构变更、跨系统 | 完整规划 → 确认后执行 |
| **L4** | 生产环境、不可逆 | 强制规划 + 人工审批 |

> L1 硬边界：创建新文件 = 最低 L2。

### L2+ 规划输出格式

```markdown
## 执行计划

**任务**: [一句话描述]
**复杂度**: L2/L3/L4
**影响范围**: [涉及的文件/模块]

### 步骤
1. [ ] 步骤一
2. [ ] 步骤二

**需要确认**: [决策点]
```

### Synthesize（验证门 — 完成前强制执行）

输出完成报告前，Agent 必须：

1. **回读验证清单**：重新 Read 已加载技能的「验证」部分
2. **逐项核对**：对照验证清单检查
3. **修复未通过项**：未通过项必须修复后才能输出完成报告
4. **确认 TODO 完整性**：所有 TODO 步骤为 completed 或 cancelled（附理由）

### 完成报告格式

```markdown
## 完成

**修改文件**:
- `path/file.ts` — 修改说明

**使用技能**: [skill-name → dep-skill] 或 [无匹配技能，通用流程]
**遵循规则**: [列出本次遵循的 Rules]

**验证门核对**:
- [x] 验证项 1
- [x] 验证项 2

**验证**: 已通过 lint / type-check / test
**注意事项**: [后续建议]
```

### 快捷指令

| 指令 | 作用 |
|------|------|
| `@planning` | 进入规划模式 |
| `@review` | 代码审查模式 |
| `@debug` | 调试模式 |
| `@refactor` | 重构模式 |
| `/test` | 为当前代码生成测试 |
| `/doc` | 更新相关文档 |
| `@skill-name` | 显式加载指定技能 |

## Planning Mode

当用户使用 `@planning` 或说"制定计划"时：

```markdown
## 执行计划

### 任务分析
**任务**: [一句话描述]
**复杂度**: L1-L4
**类型**: 新功能 | Bug修复 | 重构 | 配置 | 文档

### 影响评估
**涉及文件**:
- `path/file.ts` — [说明]

**风险**:
- [风险点]

### 步骤
1. [ ] 步骤一
2. [ ] 步骤二

### 需要确认
- [ ] [决策点]

---
回复 "确认" 开始执行
```