3.7 KiB
3.7 KiB
name, description
| name | description |
|---|---|
| medical-report-dev-workflow | 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 备份 + 记录时间戳
- 获取当前时间戳，格式：
{Year}-{Mon}-{Day}-{Hour}-{Min}-{Sec}（例如2026-04-16-16-39-42）。 - 执行 Gitea 备份：
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 - 若首次初始化仓库，执行
git init和git checkout -b main后再提交。 - 此步骤中所有 git 操作若遇到报错（如 nothing to commit），通过调整文件内容或空提交确保能推送成功。
Step 1: 工程分析目录检查
确保以下目录存在（如不存在则创建）：
.\工程分析\
Step 2: 需求分析文档
将用户提出的修改需求整理分析，写入文件：
.\工程分析\需求分析-{时间戳}.md
文档必须包含：
- 需求背景
- 功能目标（精确描述要实现什么）
- 涉及页面/模块/文件
- 验收标准
Step 3: 实现方案文档（必须经过用户二次人工审核）
基于需求分析，编写详细实现方案，写入文件：
.\工程分析\实现方案-{时间戳}.md
文档必须包含：
- 技术思路与实现路径
- 需要修改/新增的文件清单
- 关键代码变更说明
- 潜在风险点及应对策略
重要约束：写完此文档后，必须立即停止并向用户汇报，等待用户二次人工审核确认。在得到明确的"确认"、"同意"、"可以执行"等回复前，禁止继续进入 Step 4 或开始任何代码修改。
Step 4: 测试方案文档（必须经过用户二次人工审核）
实现方案经用户确认后，编写测试方案，写入文件：
.\工程分析\测试方案-{时间戳}.md
文档必须包含：
- 测试项清单
- 测试步骤（操作路径）
- 预期结果
- 回归验证范围（确保没有破坏现有功能）
重要约束：写完此文档后，必须立即停止并向用户汇报，等待用户二次人工审核确认。在得到明确的"确认"、"同意"、"可以执行"等回复前，禁止继续进入 Step 5。
Step 5: 执行修改 + 经验记录
测试方案经用户确认后，开始执行：
- 按实现方案修改代码。
- 运行
npm run lint进行 TypeScript 类型检查，确保零错误。 - 运行
npm run build验证生产构建是否通过。 - 修改完成后，在以下文档中追加本次执行过程中遇到的关键问题及解决方案：
每条记录必须使用四段式格式：
.\工程分析\经验记录.md- A. 具体问题
- B. 产生问题原因
- C. 解决问题方案
- D. 后续如何避免问题
- 向用户汇报最终执行结果和验证情况。
快速参考
| 项目 | 值 |
|---|---|
| Gitea 地址 | http://192.168.31.5:5002/admin/Mdeical_Sur_Report.git |
| 工程分析目录 | .\工程分析\ |
| 类型检查 | npm run lint |
| 构建验证 | npm run build |
| 开发服务器 | npm run dev |