docs: 更新 agent 规则并新增项目约束文档

This commit is contained in:
augushong
2026-07-18 23:35:04 +08:00
parent 51d0ed7331
commit ce8a0c795b
6 changed files with 134 additions and 27 deletions

View File

@@ -0,0 +1,24 @@
# 业务约束
> 来源使用者业务project-
> 作用域:全局(业务逻辑实现)
> 触发条件:智能体实现或修改业务逻辑前
本项目业务层面的**硬约束**——不可协商的业务铁律。这些约束散落在代码逻辑中,智能体无法从代码结构直接推断,必须显式记录。
## 约束清单
**只记录不可协商的业务铁律**——违反会导致数据损坏、资损或安全事故的约束。不要记录业务流程描述、状态机、字段清单等易变内容,这些在代码中已有,记录后容易脱节。
每条应可执行、可验证。示例:
- 库存扣减必须在数据库事务内完成,不允许超卖
- 支付回调必须验证签名后再处理
按项目实际情况增删。无硬约束时可保留本文件为空或删除本文件。)
## 相关数据表
(约束涉及的核心数据表,便于智能体定位。
示例:`ul_order``ul_order_item``ul_stock_log`。)

View File

@@ -0,0 +1,57 @@
# 本项目开发/运行/部署模式
> 来源使用者业务project-
> 作用域:全局环境操作(命令执行、调试、部署、运行环境判断)
> 触发条件:智能体执行命令、调试、部署、判断运行环境前
本项目实际采用的开发、运行、部署模式。**完全开放记录,不限于框架预设的 stack**——实际项目可能使用 WAMP、宝塔面板、lnmp 一键包、Docker、源码直传等各种方式按实际情况描述即可。
框架级通用判断规则见 [ulthon-deploy-environment.md](./ulthon-deploy-environment.md)(教智能体如何判断部署栈模式),本文件记录的是"**本项目实际选了哪种**"。
## 开发方式
(描述本项目的开发模式。例如:
- 本地 WAMP / XAMPP + 直接修改代码
- 宿主机 PHP + composer + `php think run` 内置服务器
- Docker 开发镜像 + bind mount 挂载源码
- 宝塔面板 + FTP 上传修改
- 其他任何方式
复杂场景可展开多段说明,如开发环境依赖、数据库初始化方式、前端构建流程等。)
## 运行方式
(描述本项目实际如何运行。例如:
- `php think run` 内置服务器(开发期)
- nginx + php-fpm
- Apache + mod_php
- docker run / docker compose
- 宝塔站点配置
- 其他
如有多环境差异(开发/测试/生产运行方式不同),分别说明。)
## 部署方式
(描述本项目如何部署到生产环境。例如:
- 源码 `git pull` + `composer install`
- Docker 镜像打包分发
- rsync 同步代码
- 宝塔一键部署 / FTP 上传
- OSS 静态资源 + 源码后端分离部署
- 其他
如涉及数据库迁移、静态资源发布、定时任务部署等,一并说明。)
## 相关规则
- 框架级部署判断规则:[ulthon-deploy-environment.md](./ulthon-deploy-environment.md)
## 维护说明
- 本文件为 `project-` 前缀,不被框架更新(`admin:update`)影响
- 模式变更时及时更新本文件,避免智能体用过期信息执行命令
- 若某一章节内容过于复杂(如部署涉及多套流程),可拆分为独立子规则文件(如 `project-deploy-detail.md`),并在本文件中引用