Files
Neo-ZQYY/.claude/commands/pre-change.md
Neo 70324d8542 chore: 文档与 IDE 配置整理
- .kiro/specs/ → docs/specs/(41 个历史需求 spec 迁移,移除 .config.kiro)
- CLAUDE.md 三层拆分:根文件精简 + apps/backend/CLAUDE.md + .claude/commands/
- 新增 /spec-close、/pre-change 两个工作流命令
- DDL 基线刷新(从测试库重新导出 11 个文件,dws 35→38 表,biz 18→21 表)
- BD_Manual → BD_manual 命名统一(48 个文件)
- 修复 3 处文档与数据库不一致(auth.users.status 默认值、scheduled_tasks 字段、RLS 视图数)
- 新增 BD_manual_public_rbac_tables.md(public schema 8 张 RBAC/工作流表)
- 合并 biz.trigger_jobs 文档(10→12 字段,归档独立文档)
- docs/database/README.md 索引更新

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-06 00:02:37 +08:00

1.8 KiB
Raw Permalink Blame History

/pre-change — 逻辑改动前置调研

对即将修改的模块进行全面调研,输出上下文摘要供用户确认后再动手。

适用场景

任何逻辑改动ETL/业务规则/API/数据模型/前端交互),写代码前执行。

执行步骤

第 1 步:识别改动范围

从用户需求中提取:

  • 要修改的模块和文件
  • 涉及的数据表/API/页面
  • 预期的行为变化

第 2 步:委托 Explore 子代理调研

启动 Explore 子代理thoroughness: very thorough调研以下内容

  1. 目标模块文件:读取要修改的文件及其直接依赖
  2. 历史审计:搜索 docs/audit/changes/ 中相关模块的历史变更记录
  3. 相关文档README、PRDdocs/prd/、BD 手册(docs/database/、API 参考
  4. 调用关系:要修改文件的调用方和被调用方
  5. 数据流向:上游(数据从哪来)→ 当前模块 → 下游(数据到哪去)
  6. 影响范围:哪些模块/页面/任务可能受影响

第 3 步:输出「改动前上下文摘要」

格式:

## 改动前上下文摘要

### 模块职责
<模块做什么,在系统中的角色>

### 历史变更
<近期审计记录中的相关改动,特别是踩坑记录>

### 数据流向
上游: <数据来源>
当前: <本模块处理>
下游: <消费方>

### 影响范围
- <受影响的模块/页面/任务列表>

### 风险点
- <可能的副作用、边界条件、兼容性问题>

### 建议方案
<基于调研结果的实施建议>

第 4 步:等待用户确认

输出摘要后,等待用户确认或调整方向,确认后再进入编码实施。

例外(无需执行此流程)

  • 纯格式调整、注释/文档纯文字修改
  • 用户明确说"直接改/跳过调研"
  • 新建文件且不涉及已有逻辑