feat(rules): 新增零散规则管理机制

- 新增 .agents/rules/ 目录,存放模块级/场景级独立规则文件
- 新增 ulthon-rules-manager 技能,指导规则的新增/索引/格式
- 新增 ulthon-timer-multi-node 规则文件(从 PROJECT.md 迁移)
- AGENTS.md 新增「零散规则」章节,含框架级规则索引表
- PROJECT.md 新增「规则索引」章节,含全量规则索引表
- 命名约定:ulthon- 前缀为框架内置,project- 前缀为使用者业务
This commit is contained in:
augushong
2026-06-01 21:26:16 +08:00
parent 5941a61b80
commit f867c42a72
5 changed files with 225 additions and 19 deletions

35
.agents/rules/.README Normal file
View File

@@ -0,0 +1,35 @@
# 零散规则目录
本目录存放按模块/场景拆分的独立规则文件,避免全局规则膨胀。
## 命名约定
- `ulthon-` 前缀:框架内置规则,框架作者维护
- `project-` 前缀:使用者业务规则,开发者维护
## 文件格式
每个规则文件包含以下章节:
```markdown
# 规则名称
> 来源框架内置ulthon-或使用者业务project-
> 作用域:适用的模块/文件/场景
> 触发条件:智能体何时应加载此规则
## 规则内容
(具体的可执行规则)
## 相关文件 / 相关数据表 / 相关命令
(关联的代码路径、配置路径等)
```
## 索引
- 框架级规则索引:根目录 `AGENTS.md` 的「零散规则」章节
- 全量规则索引:`.agents/PROJECT.md` 的「规则索引」章节
## 管理技能
新增/维护规则时,参考技能:[ulthon-rules-manager](../skills/ulthon-rules-manager/SKILL.md)

View File

@@ -0,0 +1,33 @@
# 定时任务多节点协调
> 来源框架内置ulthon-
> 作用域定时任务相关模块TimerConfig、TimerLog、Host
> 触发条件:涉及定时任务开发、多节点部署、主节点选举等场景时加载
## 规则内容
- 多节点定时任务协调以数据库为主协调中心
- run_type 调度模式auto / main / all / manual
- 支持主节点自动选举与手动切换
- 执行日志必须记录,支持查看与清理
- 定时任务配置管理通过 UI 管理
## 相关数据表
- ul_system_timer_config
- ul_system_timer_log
- ul_system_host含 is_master 字段)
## 相关命令
- `php think admin:timer:log:clean [--days=30]` — 清理过期执行日志
## 相关管理页面
- 定时器配置管理:/admin/system.timer_config/index
- 定时器执行日志:/admin/system.timer_log/index
- 主机列表增强(主节点标识、切换主节点)
## 相关技能
- [ulthon-timer](../skills/ulthon-timer/SKILL.md)