Commit Graph

12 Commits

Author SHA1 Message Date
dad8aa0aad docs(iron-rules): 铁律18禁止破坏原有功能统一写入所有AI工具配置
- MD/specs/IRON_RULES.md: 总览表补充#14-#18,版本升至v2.1
- AGENTS.md: P0铁律区新增铁律18
- RULES.md: P0铁律区新增铁律18
- healthlink-his-server/AGENTS.md: 速查区新增铁律18
- healthlink-his-ui/AGENTS.md: 速查区新增铁律18
- .cursorrules/.clinerules/.windsurfrules: 同步新增铁律18
- V25实体层: NursingVitalSignsChart/SurgerySafetyCheck/SpecimenBarcode/SysAuditLog/EmpiIdVerification
- V25 Flyway迁移: V25__vitalsigns_safety_barcode_audit.sql
2026-06-06 20:05:44 +08:00
22712547bc docs(iron-rules): 新增铁律17 — 禁止浅层糊弄,必须深度分析+深度设计
核心要求:如果一个模块不能在真实医院环境中使用,就不算完成

禁止行为:
- 写空壳页面就宣称功能完成
- 只做CRUD就宣称模块开发完毕
- 设计文档只有标题没有内容
- 接口只返回200不验证业务逻辑
- 前端只有表格没有交互
- 后端没有参数校验

每个模块必须达到的标准:
- 前端:搜索/筛选/分页/弹窗/反馈/空状态/加载态
- 后端:参数校验/业务规则/异常处理/日志
- 数据:完整字段/关联/索引/Flyway
- 业务:正常+异常+边界+状态机
- 设计:背景/流程图/规则/时序图/测试用例
- 测试:接口+业务逻辑+异常

质量自检:能否在真实医院环境直接使用?
同步7个AI工具配置
2026-06-06 15:09:51 +08:00
76f090d2af docs(iron-rules): 新增铁律15+16 + 业务逻辑设计文档 + 后端增强
铁律15: 模块设计必须分析业务逻辑,不能只做CRUD
- 必须查阅标准规范、梳理业务流程、设计状态流转、定义业务规则
- 附设计文档模板和医疗HIS参考标准清单

铁律16: 模块优化必须分析现有业务流并说明促进作用
- 必须回答5个问题:位置/关联/促进/兼容/冲突
- 附业务逻辑分析文档模板

业务逻辑设计文档:
- MD/specs/SURGERY_MANAGEMENT_DESIGN.md (139行)
  - 状态机: 待申请→待审批→已审批→待手术→手术中→已完成
  - 7条业务规则: 分级权限/术前讨论/术前评估/手术室冲突/禁食/随访/安全核查
- MD/specs/ORDER_MANAGEMENT_DESIGN.md
  - 状态机: 新开→签发→执行中→已完成/已停止/已签退
  - 6条业务规则: 停止时限/用药审核/查对/紧急标识/修改限制/皮试联动
- MD/specs/BED_MANAGEMENT_DESIGN.md
  - 状态机: 空闲↔占用↔清洁中↔维修中
  - 5条业务规则: 分配校验/科室匹配/自动清洁/使用率统计/预约

后端业务逻辑增强:
- SurgeryAppService: +手术室冲突校验 +手术统计
- BedController: +床位使用率统计 +分配校验 +出院自动清洁
- EsbMessageController: +消息路由校验 +消息轨迹 +死信队列处理
2026-06-06 14:11:50 +08:00
35d193d9f2 docs(iron-rules): 新增铁律9 — 开发前必须审核原有代码
- 任何新功能开发前必须先搜索项目中是否已有相关代码
- 已有部分功能 → 在原基础上升级优化完善,禁止另起炉灶
- 已有接口缺前端 → 只补前端;已有前端缺后端 → 只补后端
- 搜索清单:Controller/AppService/Service/Mapper/Entity/前端页面/API/数据库
- 禁止行为:不看代码就新建、重复实现、废弃原有代码另写一套
- 同步7个AI工具配置
2026-06-06 11:19:31 +08:00
db5fb88627 docs(specs): 添加UI设计铁律法则 - 十大设计法则+医疗HIS专项规范
- 新增 MD/specs/UI_DESIGN_IRON_RULES.md (404行)
  - 十大UI设计铁律法则: 希克/费茨/米勒/雅各布/格式塔/多赫蒂/尼尔森/泰斯勒/峰终/冯雷斯托夫
  - HIS医疗系统专项UI规范: 色彩体系/间距系统/字体/表格/表单/弹窗/交互反馈
  - 医疗特殊交互: 危急值/医嘱/处方/费用/电子签名/打印
  - 设计文档必备模板: UI布局+交互清单+调用流程+状态流转+异常处理
  - 违反检查清单

- 更新铁律体系
  - RULES.md: 新增铁律14 - 设计文档必须包含UI设计和调用流程
  - MD/specs/IRON_RULES.md: 新增铁律#9详细说明
  - MD/specs/FRONTEND_DEVELOPMENT_STANDARD.md: 新增UI设计法则速查表

- 同步7个AI工具配置: AGENTS.md/.cursorrules/.copilot/.windsurf/.cline/.qwen/.aider
2026-06-06 11:12:02 +08:00
46d21077a8 docs: 铁律#11补充 — 设计文档必须包含系统调用关系/方法调用链/业务流程图 2026-06-06 11:05:39 +08:00
96d2300175 docs: 铁律#11 正式化 — 设计文档确认后自主开发,禁止反复询问
- 更新 RULES.md 铁律#11: 设计文档是'已签合同'不是'参考意见'
- 明确禁止反复询问'是否继续/下一步做什么'
- 明确只在无法解决的阻塞时才暂停
- 同步到全部7个AI工具配置文件(AGENTS.md/.cursorrules/.copilot等)
2026-06-06 10:46:23 +08:00
ca9cd0d478 docs: 新增铁律#11 设计文档确认后自主开发,不反复询问 2026-06-06 10:44:01 +08:00
f3880eb8df feat: 全面整合agentforge-rs + .codex/harness方法论到AI开发规范
RULES.md 420→460行,新增整合内容:
- Karpathy编码准则(先想再写/简洁优先/精准修改/目标驱动)
- 验证后才宣称完成铁律(Verification Before Completion)
- 系统化调试四阶段(Systematic Debugging)
- 约束设计原则(可验证/无歧义/优先级/渐进增强)
- 持久执行三层状态管理(系统层/执行层/业务层)
- 审查与审计三层体系(自审/配对审查/合规审查)
- BDT方法论(Bug Driven Testing + Playwright 7种检查模式)
- L4/L5分析与AI自主优化机制
- 标准工作循环(Init→Select→Implement→Verify→Cleanup)
- Clean State Checklist(会话结束检查)
- 新增10条过往教训(含上下文焦虑/过早宣告胜利等)

新增 MD/specs/HARNESS_ENGINEERING.md (305行) — 完整方法论参考:
- WalkingLabs 5子系统模型
- 约束/反馈/控制平面/持久执行详解
- Agent协作管线/路由/去重/禅道操作
- BDT测试用例设计/质量标准
- L4量化分析 + L5 AI自优化

7个AI工具配置文件同步更新(470行内嵌)
2026-06-06 10:01:41 +08:00
84ba9a4139 feat: 整合Harness Engineering + AgentForge规范到AI开发规范
RULES.md 218→420行,新增内容:
- AgentForge 10条铁律(状态一致性/禁删源文件/禁改方法签名等)
- Harness Engineering 4大组件(约束金字塔/反馈系统/控制平面/持久执行)
- 全链路6环分析(录入→验证→业务→持久化→存储→联动)
- 5级质量门禁(L1编译→L2测试→L3DB审查→L4验收→L5归档)
- 8个Agent角色定义和协作流水线
- 8条过往教训(Bug#574等)

7个AI工具配置文件同步更新(全部430行内嵌)
2026-06-06 09:56:25 +08:00
355c905026 feat: AI工具配置文件内嵌完整规则 — 打开项目即自动生效
改为单一信源+内容嵌入模式:
- RULES.md: 唯一规范信源(218行)
- scripts/sync-ai-rules.sh: 一键同步脚本
- 7个工具配置文件全部内嵌完整规则内容(非引用)

支持的AI工具(打开项目自动加载):
- AGENTS.md → Codex CLI / Claude Code
- .cursorrules → Cursor IDE
- .github/copilot-instructions.md → GitHub Copilot
- .windsurfrules → Windsurf / Codeium
- .clinerules → Cline
- .qwenrules → Qwen Coder / 通义灵码
- .aider.conf.yml → Aider

使用: 编辑 RULES.md 后运行 bash scripts/sync-ai-rules.sh
2026-06-06 09:47:10 +08:00
e8af9ea40a feat: 添加AI开发规范自动加载配置 — 支持所有AI编码工具
单一信源设计:
- RULES.md: 项目唯一规范信源(218行,覆盖铁律+后端+前端规范)

多工具适配(7个配置文件):
- AGENTS.md: Codex CLI / Claude Code 自动读取
- .cursorrules: Cursor IDE 自动读取
- .github/copilot-instructions.md: GitHub Copilot 自动读取
- .windsurfrules: Windsurf/Codeium 自动读取
- .clinerules: Cline 自动读取
- .aider.conf.yml: Aider 自动读取
- .qwenrules: Qwen Coder/通义灵码 自动读取

子目录 AGENTS.md 同步更新引用 RULES.md
2026-06-06 09:46:15 +08:00