Files
lpt-meta/.agents/roles

通用规则(.agents/roles/)

存放跨仓库通用的代理行为规则。

目录名叫 roles,但里面不放「角色扮演」式定义(没有「你是某某角色、你的职责是……」), 只记录规则本身:什么情况下必须做什么、怎么核对。

放什么,不放什么

判断标准只有一句:这条规则换到另一个仓库还成立吗?

内容 位置 例子
通用规则(不限仓库) 本目录,meta 统一管理 提交后收口 todo、轮末对账
项目专属规则 各仓库自己的 AGENTS.md 后端的迁移写法、前端的测试隔离
项目知识与架构约定 各仓库 AGENTS.md 端口、调用关系、命名约定
跨仓库待办与验收标准 OPTIMIZATION_BACKLOG.md 优化条目
按任务触发的专业指令 .agents/skills/ 绘图评审流程

生效方式(重要)

.agents/roles/ 不是自动加载入口。 规则要真正约束行为,必须在 AGENTS.md 里被引用—— AGENTS.md 是每次会话自动加载的项目指令入口,只有它(和按描述触发的 skills)会被读到。 所以:新增规则时,务必同时在 AGENTS.md 对应章节挂上入口。

配套事实:pi 加载 AGENTS.md 时会同时读工作目录及其父目录。 因此在 lpt-be 这类子目录里干活时,meta 的 AGENTS.md 仍会被读到—— 这正是各子项目不再重复通用规则的前提。

规则文件的写法(强制)

每个规则文件的开头必须是如下三段,顺序不变,方便 agent 在决定是否继续读之前就能判断该不该用:

  1. 名称——作为 # 一级标题;
  2. 功能简述——一句话说明这条规则解决什么问题;
  3. 关键字 / 情况——告诉 agent 何时需要用到这条规则。这部分要简洁(一行枚举触发场景即可),不要在这里展开内容,正文放到后面。

模板:

# <名称>

- **功能**:<一句话说明这条规则做什么>
- **何时用**:<触发场景 / 关键字的简短枚举>

## <正文…>

新增或修改规则后自查:标题是名称?有「功能」行?有「何时用」行?「何时用」是否够短?

规则清单

规则 文件 触发点
todo 收口纪律 todo-discipline.md 提交后 / 轮末 / 会话压缩后
并行与委派 parallel-and-delegation.md 开工排期、派发子任务时