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