diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8ad58a5 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,19 @@ +# Agent 工作说明(Agent-System-Documents) + +本仓开发遵循 Development-Guidelines(Dev 仓 `deps/development-guidelines`,gitlink 固定版本): +核心规则见其 `core/`,按任务触发阅读 `standards/` 专题;日常交付走 `workflows/delivery.md`。 + +## 任务启动门禁 + +- 任务启动或恢复后,第一次写操作前在 Dev 仓运行 `make precheck` 并附完整输出(本仓作为子仓随父仓编排); + 本仓独立开发时核对工作树 clean、与权威 origin/main 同步,并按任务触发读对应专题。 +- 从权威 origin/main 固定共同起点 R0,建 feature|fix|hotfix/ 分支(Dev 仓 `make task-start` 自动化); + 任务中途不重复 precheck。 +- 验收、请求审核、合入前各同步一次最新目标分支并附证据;合入后回收任务工作区与已合入分支。 +- 提交主题行:英文祈使句一行(≤100 列,不以句点结尾);body 写 `Why: / Evidence: / Impact: / Refs:`。 + +## 仓内规则 + +- 模块边界、公开契约与隔离档位见 `policy/modules/`(如有)与 PROJECT.md。 +- 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进;受保护分支经 PR 合入。 +- 验证命令见 PROJECT.md「验证」节;完成声明须附实际命令输出证据。