
AGENTS.md
人机分工、规则优先级与强制边界统一入口;人类负责业务目标与风险边界,AI 在边界内实现与验证。

AI-First 工程脚手架
不止是开箱即用的企业级底座,更是一套约束 AI、带证据交付的协作体系——强制分层契约、规则路由、架构门禁,让 AI 按章程工作,而不是黑箱输出。

从需求到验收,AI 走一条被规则约束的流水线:先论证、再动手、最后补证据。
人类给定目标、数据与验收标准
requirements-discovery
business-task-intake
skill-routing
分层与边界内落地
单测 + 集成测试
ai-check 必须通过
反馈循环:验收发现偏差 → 同步修正任务契约、实现与测试;规范与代码不一致时,同一变更内一起改。
数据含义、状态流转、权限语义或对外契约不明时,AI 先提出最少且会改变业务行为的问题,而不是替你补齐业务假设。
任何未运行的检查都要在交付时说明具体原因,不以「AI 已检查」代替可复现证据——自动化门禁才是质量兜底。
四个环节组成一条人机协作管线:任务按信号路由到最小规则集,产出必须通过机器门禁——让任意 AI 编码助手按同一套契约可靠交付。

人机分工、规则优先级与强制边界统一入口;人类负责业务目标与风险边界,AI 在边界内实现与验证。

编码、提交、迁移、日志四类硬约束,任何 AI 编码助手一视同仁。

28 个任务 Skill:CRUD 标准流、数据库变更、数据权限、测试标准……高频任务模板化。

分层依赖与路由契约机器可校验,架构检查不通过即视为未完成,不依赖 AI 自觉。
人类负责业务目标、数据含义与风险边界;AI在既定边界内实现与验证——交付质量由门禁兜底,而不是靠提示词运气。了解 AI 工程体系 →
产品与工程的双重底气。每一条都有据可查,不是形容词堆砌。
测试是默认门禁,不是被讨要的。主要业务规则均有用例覆盖;集成测试连真实 PostgreSQL,直接查询数据正确性。
自研 StartJob 引擎:基于 Redisson 分发、多实例实时同步,自带调度 / 执行 / 日志面板。无需再集成 XXL-Job 或 Quartz。
Spring Boot 4.1.1(Framework 7)· MyBatis-Flex · Jackson 3 · Redisson;前端 Vue 3.5 + Fantastic-admin。站在这一代框架的最前沿。
Fantastic-admin 骨架 + Element Plus + 40 余个 Fa 组件:搜索栏、工具行、分页、上传各有既定套路,交互一致、明暗主题双端兼顾。
Controller → Service → Manager → Mapper 分层、命名与注释对齐《阿里巴巴 Java 开发手册》,由 ai-check 架构门禁强制把关——不通过即视为未完成。
从权限体系到集群通信,从分层契约到 AI 工程化,每一层都为长期演进设计。

Java 25 与 Spring Boot 4 全面落地,享受最新特性带来的性能红利。

Sa-Token 完整 RBAC、JWT 无状态会话、接口权限与行级数据权限。

MyBatis-Flex 链式 API 提升数据库操作效率,Liquibase 管版本演进。

start-common 沉淀 11 个技术能力域,零业务语义、互不耦合。

分布式优化 WebSocket,支持跨节点消息精准路由与会话管理。

AGENTS.md + 28 个任务 Skill + ai-check 质量门禁,人机分工可靠交付。
共享能力域与业务模块两层拆分:业务模块按端/场景独立,共享 start-common 能力域、互不耦合。 单体部署常驻一个进程,部署运维极简,又能按需拆分演进。
start-admin-boot-backend ├── start-common # 共享能力域(11 个) │ ├── core / cache / db / satoken │ ├── log / excel / oss / websocket │ └── social / job / web ├── start-admin # 后台管理业务模块 │ ├── auth # 认证 │ ├── system # 系统管理 │ ├── monitor # 系统监控 │ └── social # 社交账号 └── start-app (规划中) # APP 端接口服务 start-admin-boot-web-ui ├── apps/example # 业务主应用(Vue 3 + Fantastic-admin) └── packages/ # components / settings / themes / types
后端与前端都站在最新稳定版本上,工程体验与长期可维护性兼得。
开箱即用,接入你现有的 Spring Boot 项目;AI 工程体系随底座一起交付,而不是一句口号。