---
name: medical-report-dev-workflow
description: Enforce a strict five-step workflow for all code modification requests on the Medical Surgical Report System (Gemini-图文报告系统-V1.1). Use whenever the user asks to change, add, fix, refactor, or update any project code, feature, UI, logic, or configuration. Do NOT use for simple questions, explanations, or read-only research.
---

# 手术图文病历报告系统 —— 修改需求五步工作流

当用户提出任何程序修改需求时，必须严格按照以下顺序执行。禁止跳过任何步骤，禁止在方案未经过用户二次人工审核确认前进入下一步。

---

## Step 0: Gitea 备份 + 记录时间戳

1. 获取当前时间戳，格式：`{Year}-{Mon}-{Day}-{Hour}-{Min}-{Sec}`（例如 `2026-04-16-16-39-42`）。
2. 执行 Gitea 备份：
   ```bash
   git add .
   git commit -m "backup before modification at {时间戳}"
   git remote set-url origin http://192.168.31.5:5002/admin/Mdeical_Sur_Report.git
   git branch -M main
   git push -u origin main
   ```
3. 若首次初始化仓库，执行 `git init` 和 `git checkout -b main` 后再提交。
4. 此步骤中所有 git 操作若遇到报错（如 nothing to commit），通过调整文件内容或空提交确保能推送成功。

---

## Step 1: 工程分析目录检查

确保以下目录存在（如不存在则创建）：
```
.\工程分析\
```

---

## Step 2: 需求分析文档

将用户提出的修改需求整理分析，写入文件：
```
.\工程分析\需求分析-{时间戳}.md
```

文档必须包含：
- 需求背景
- 功能目标（精确描述要实现什么）
- 涉及页面/模块/文件
- 验收标准

---

## Step 3: 实现方案文档（必须经过用户二次人工审核）

基于需求分析，编写详细实现方案，写入文件：
```
.\工程分析\实现方案-{时间戳}.md
```

文档必须包含：
- 技术思路与实现路径
- 需要修改/新增的文件清单
- 关键代码变更说明
- 潜在风险点及应对策略

**重要约束**：写完此文档后，必须立即停止并向用户汇报，等待用户二次人工审核确认。在得到明确的"确认"、"同意"、"可以执行"等回复前，禁止继续进入 Step 4 或开始任何代码修改。

---

## Step 4: 测试方案文档（必须经过用户二次人工审核）

实现方案经用户确认后，编写测试方案，写入文件：
```
.\工程分析\测试方案-{时间戳}.md
```

文档必须包含：
- 测试项清单
- 测试步骤（操作路径）
- 预期结果
- 回归验证范围（确保没有破坏现有功能）

**重要约束**：写完此文档后，必须立即停止并向用户汇报，等待用户二次人工审核确认。在得到明确的"确认"、"同意"、"可以执行"等回复前，禁止继续进入 Step 5。

---

## Step 5: 执行修改 + 经验记录

测试方案经用户确认后，开始执行：
1. 按实现方案修改代码。
2. 运行 `npm run lint` 进行 TypeScript 类型检查，确保零错误。
3. 运行 `npm run build` 验证生产构建是否通过。
4. 修改完成后，在以下文档中追加本次执行过程中遇到的关键问题及解决方案：
   ```
   .\工程分析\经验记录.md
   ```
   每条记录必须使用四段式格式：
   - **A. 具体问题**
   - **B. 产生问题原因**
   - **C. 解决问题方案**
   - **D. 后续如何避免问题**
5. 向用户汇报最终执行结果和验证情况。

---

## 快速参考

| 项目 | 值 |
|------|-----|
| Gitea 地址 | `http://192.168.31.5:5002/admin/Mdeical_Sur_Report.git` |
| 工程分析目录 | `.\工程分析\` |
| 类型检查 | `npm run lint` |
| 构建验证 | `npm run build` |
| 开发服务器 | `npm run dev` |