Neo
81e41730ec
Co-Authored-By: OpenAI Codex <codex@openai.com> Co-authored-by: Cursor <cursoragent@cursor.com>
72 lines
2.0 KiB
Markdown
72 lines
2.0 KiB
Markdown
---
|
||
name: pre-change
|
||
description: /pre-change — 逻辑改动前置调研。从 Claude Code 命令迁移为 Cursor project skill；用户要求执行 pre-change、/pre-change 或相关流程时使用。
|
||
disable-model-invocation: true
|
||
---
|
||
|
||
# /pre-change — 逻辑改动前置调研
|
||
|
||
对即将修改的模块进行全面调研，输出上下文摘要供用户确认后再动手。
|
||
|
||
## 适用场景
|
||
|
||
任何逻辑改动（ETL/业务规则/API/数据模型/前端交互），写代码前执行。
|
||
|
||
## 执行步骤
|
||
|
||
### 第 1 步：识别改动范围
|
||
|
||
从用户需求中提取：
|
||
- 要修改的模块和文件
|
||
- 涉及的数据表/API/页面
|
||
- 预期的行为变化
|
||
|
||
### 第 2 步：委托 Explore 子代理调研
|
||
|
||
启动 Explore 子代理（thoroughness: very thorough），调研以下内容：
|
||
|
||
1. **目标模块文件**：读取要修改的文件及其直接依赖
|
||
2. **历史审计**：搜索 `docs/audit/changes/` 中相关模块的历史变更记录
|
||
3. **相关文档**：README、PRD（`docs/prd/`）、BD 手册（`docs/database/`）、API 参考
|
||
4. **调用关系**：要修改文件的调用方和被调用方
|
||
5. **数据流向**：上游（数据从哪来）→ 当前模块 → 下游（数据到哪去）
|
||
6. **影响范围**：哪些模块/页面/任务可能受影响
|
||
|
||
### 第 3 步：输出「改动前上下文摘要」
|
||
|
||
格式：
|
||
|
||
```
|
||
## 改动前上下文摘要
|
||
|
||
### 模块职责
|
||
<模块做什么，在系统中的角色>
|
||
|
||
### 历史变更
|
||
<近期审计记录中的相关改动，特别是踩坑记录>
|
||
|
||
### 数据流向
|
||
上游: <数据来源>
|
||
当前: <本模块处理>
|
||
下游: <消费方>
|
||
|
||
### 影响范围
|
||
- <受影响的模块/页面/任务列表>
|
||
|
||
### 风险点
|
||
- <可能的副作用、边界条件、兼容性问题>
|
||
|
||
### 建议方案
|
||
<基于调研结果的实施建议>
|
||
```
|
||
|
||
### 第 4 步：等待用户确认
|
||
|
||
输出摘要后，等待用户确认或调整方向，确认后再进入编码实施。
|
||
|
||
## 例外（无需执行此流程）
|
||
|
||
- 纯格式调整、注释/文档纯文字修改
|
||
- 用户明确说"直接改/跳过调研"
|
||
- 新建文件且不涉及已有逻辑
|