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