docs(conventions): §10.5 立 canonical 活档约定 + knowledge 加 canonical 指针
§10.5(补 §10.4 子系统粒度落地):canonical 活档=无日期主题名子系统SoT,与§10.1 dated命名词表互补; dated spec 波次收口折进对应 canonical;分层 canonical>knowledge速查>architecture基线>总账状态(不双写)。 product-and-architecture 加子系统 canonical 指针(知识层→canonical 接线)。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
ee55a2db6a
commit
ebb994b155
@ -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)。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@ -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`。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user