diff --git a/.agents/knowledge/product-and-architecture.md b/.agents/knowledge/product-and-architecture.md index 20545e53..352ec56d 100644 --- a/.agents/knowledge/product-and-architecture.md +++ b/.agents/knowledge/product-and-architecture.md @@ -3,6 +3,7 @@ > 蒸馏来源:`docs/architecture/系统概要设计-投资人版.md`、`docs/architecture/产品需求清单.md`、`docs/architecture/技术架构与模块.md`、`docs/architecture/需求模块映射.md`、`docs/architecture/系统概要设计-技术决策版.md`、`docs/architecture/系统概要设计-开发团队版.md` > 目的:让后续 Agent 读本篇即掌握产品定位、用户角色、分层架构、三仓库、13 模块与依赖、Huijing 复用边界、SDK 定位,不必重读原始长文档。 > 相关:决策见 [`tech-decisions.md`](./tech-decisions.md);MVP 范围见 [`mvp-scope-and-milestones.md`](./mvp-scope-and-milestones.md);术语见 [`glossary.md`](./glossary.md)。 +> **子系统现行设计+现状(深一层 SoT)**:见 `docs/agent-specs/` 子系统 canonical 活档——`引擎与运行时` / `agentic编排-SAA` / `开闸验收门-W-G1` / `渠道发行` / `studio前端设计体系` / `变现与单位经济` / `战略与合规` / `prompt治理体系-execution`;生成域=固定架构设计链;导航见 [`../../docs/agent-specs/_index.md`](../../docs/agent-specs/_index.md)。本篇=速查蒸馏,重叠处以 canonical 为 SoT(见 engineering-conventions §10.5)。 --- diff --git a/.agents/rules/engineering-conventions.md b/.agents/rules/engineering-conventions.md index a88df969..06a6e18b 100644 --- a/.agents/rules/engineering-conventions.md +++ b/.agents/rules/engineering-conventions.md @@ -263,3 +263,13 @@ subject: 动词开头,简明描述(中英文均可) - **终稿自洽**:活档不需回读被取代的前身才能懂;若需,则前身内容未折入(补折入)。 - **同一提交内删/归档被取代者**(强化 §10.2):commit 设计档前**自检**——「本次提交/工作树里有无被本档取代的旧档?」有则同提交 `git rm`(过期且错)或 `git mv` 到 `_archive/`(过期但留参考)+ tombstone 横幅;**绝不把过期档单独连推上去**。 - 收口按 wave-close 第 8 步把本任务设计档**收敛成最小自洽集**(典型 1 review + 1 execution)。 + +### 10.5 canonical 活档(子系统 SoT · 无日期主题名 · 2026-06-17 深度重构立) + +> 由来:2026-06-17 创始人要求 agent-specs 从「按时间堆 review/execution/verdict 流水」改为「**每子系统一份 canonical 活档**」——dated spec 是某波次过程产物,子系统的「现行架构+目标+现状」应收敛成一份持续更新的活档。本节是 §10.4「一题一活档」在**子系统粒度**的落地。是 §10.1 dated 命名词表之外**另立的一类活档形态**(不违反 §10.1,互补)。 + +- **形态**:`<主题>.md`(**无日期前缀、无 type 后缀**,如 `引擎与运行时.md`/`agentic编排-SAA.md`/`战略与合规.md`);顶部第一行标 `# <主题> · canonical(子系统 SoT)`,随附 `类型=canonical 活档 · 更新 YYYY-MM-DD / 取代=N 份历史 spec / 读法`。一子系统一份,**≤150 行**。 +- **装什么**:一页结论 → 目标/非目标 → 现行架构(含必要 Mermaid) → 现状(done/在飞/待办) → 关键指针(commit/skill/契约)。**砍掉**:演进流水/逐轮评审 transcript/逐 commit 过程/取证日志/已 supersede 旧方案(留 git + `_archive/`)。 +- **与 dated spec 的关系**:dated `review/execution/report`(§10.1)= 某波次工作期过程档;**波次收口时把活内容折进对应子系统 canonical**(wave-close 第 8 步),dated 源档随即 `git rm`(已折入)或 `git mv _archive/`(账本/取证类留参考 + tombstone)。canonical 之外不再久留同主题 dated 流水。 +- **分层(不双写)**:canonical(子系统 SoT·深)> `.agents/knowledge/*`(AI 速查一句话·浅)> `docs/architecture/` Doc A/B/C + 技术决策版(基线 WHAT/HOW)> `docs/mvp/MVP进度总账.md`(跨线状态)。重叠处 canonical 是 SoT,其余留速查 + 指针。 +- **导航**:`docs/agent-specs/_index.md` 列全部 canonical(一域一档)+ 生成域设计链 + KEEP + 归档指针。维护见记忆 `agent-specs-canonical-structure`。