diff --git a/AGENTS.md b/AGENTS.md index 7c6c60a..c6e959d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,7 +9,7 @@ ## 2. 按里程碑推进,不跳步、不漂移 - 严格按 **M0 → M12** 顺序。每个功能的依赖与归属见时间线 §2/§3。 - 不得「想到什么做什么」。**新需求/新想法:先写入设计或时间线清单,再开发**,不脱离清单。 -- 上下文压缩后:**先读 `DevDocs/工作小结/当前态.md`** 恢复锚点,再继续,**不得凭印象跳走**。 +- 上下文压缩后:**先读 `DevDocs/工作小结/00-当前态.md`** 恢复锚点,再继续,**不得凭印象跳走**。 ## 3. 每阶段审查并勾选 - 阶段完成:后端 `go build ./...` + `go vet ./...` + `go test ./...` 全绿;前端 `tsc --noEmit` + `vite build` 通过。 @@ -20,20 +20,20 @@ - 修改任一文件/功能前,明确它在哪个里程碑、对应哪份 design 文档;改完同步该文档(若设计变了)。 ## 5. 实时同步工作小结 -- 每完成一步,更新 `DevDocs/工作小结/当前态.md`:当前里程碑 / 进度 / 已完成+未完成 / 关键决策 / 变更日志。 +- 每完成一步,更新 `DevDocs/工作小结/00-当前态.md`:当前里程碑 / 进度 / 已完成+未完成 / 关键决策 / 变更日志。 ## 6. 小步提交 + 频繁验证 - 小粒度 commit;每步 build/test 通过再提交;提交信息按 Git 规范(feat/fix/refactor/docs/chore,scope 用模块名)。 ## 7. 不信任记忆,信任清单 -- 关键决策、架构铁律、用户红线(如身份识别靠元数据、不靠提示词)都记录在 `DevDocs/工作小结/当前态.md` 的「关键决策」区;压缩后回读,不得丢失。 +- 关键决策、架构铁律、用户红线(如身份识别靠元数据、不靠提示词)都记录在 `DevDocs/工作小结/00-当前态.md` 的「关键决策」区;压缩后回读,不得丢失。 ## 8. 上下文保护:可并行项交给后台子代理,主会话当监工 - **相互独立、不依赖主会话开放状态**的开发任务(如 M0 地基各件、层 1 并行件),用 `Agent(run_in_background=true)` 派后台子代理**并行实现**。 -- 主会话**只当监工**:等子代理回报 → 验收(`go build/vet/test`)→ 更新 `DevDocs/工作小结/当前态.md` + 时间线 → 小步 commit → 派下一批。**不在主会话里重复子代理已做的搜索/实现**。 +- 主会话**只当监工**:等子代理回报 → 验收(`go build/vet/test`)→ 更新 `DevDocs/工作小结/00-当前态.md` + 时间线 → 小步 commit → 派下一批。**不在主会话里重复子代理已做的搜索/实现**。 - 子代理 prompt 必须**自包含**:写清目标、已知信息、精确文件路径、必须遵守的编码约束(02-development-constraints.md)、验收命令;不要让它去搜已经知道的东西。 - **只有真正独立才并行**;有依赖的串行。避免两个子代理同时改 `go.mod/go.sum`——若都要改,指定其中一个负责或先把依赖拉好。 -- 目的:防主会话上下文超限触发压缩;压缩后靠本文件 + `DevDocs/工作小结/当前态.md` 恢复锚点,继续当监工。 +- 目的:防主会话上下文超限触发压缩;压缩后靠本文件 + `DevDocs/工作小结/00-当前态.md` 恢复锚点,继续当监工。 ## 9. 全球红线(跨里程碑,必须遵守;违反即架构偏离) - **单二进制、单端口 `:8080`、零跨进程 IPC**:模块间同步走**进程内接口 + 依赖注入**(直接方法调用),异步走**进程内 `bus`**;**不另开监听端口、不 HTTP 互调**。