backup before modification at 2026-04-16-16-51-00

.agents/skills/medical-report-dev-workflow/SKILL.md

@@ -0,0 +1,113 @@
+---
+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` |