zizi 0260bcd8e2 设计文档:SoT 同步与生成物重出
- 新版设计各域 SoT 按本轮实现同步:总体架构、模块设计、接口契约、数据模型、功能规格、文件设计与决策记录。
- 接口契约生成物重新导出(openapi 与前端客户端随契约一致)。
- 实现回顾与专项检查台账保留历史结论;本轮收尾发现另见 .agents.local 下的收尾报告与审查处置。
2026-09-18 01:15:18 +08:00

5.2 KiB

新版 agent-example 设计目录

新版目标设计与原研究的统一入口。建议先读阅读指南,再按主题展开。源码、配置与数据库目录仅在目标树中定义,本目录不代表实现完成。

名称 相对地址 内容描述 使用场景 使用要求
业务需求目录 目录.md 要解决谁的什么问题、不做哪些 业务需求的文件与材料索引 功能还没方案、对齐目标和范围时 设计、实现或评审对应主题 需求确认或变更时 与阅读指南的主题权威分工一致
决策目录 目录.md 决策的文件与材料索引 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
功能规格目录 目录.md 功能规格的文件与材料索引 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
接口契约目录 目录.md 接口契约的文件与材料索引 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
数据模型目录 目录.md 数据长什么样、存在哪、怎么一致 数据模型的文件与材料索引 改存储、迁移、字段、一致性时 设计、实现或评审对应主题 schema / 数据生命周期变化时 与阅读指南的主题权威分工一致
模块设计目录 目录.md 代码按什么模块分、职责与依赖 模块设计的文件与材料索引 动模块边界、新代码往哪放拿不准时 设计、实现或评审对应主题 模块职责或依赖变化时 与阅读指南的主题权威分工一致
研究依据目录 目录.md 研究依据的文件与材料索引 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
调用链路目录 目录.md 一条真实路径经过哪些代码 调用链路的文件与材料索引 改这条链路、排障、清理相关代码时 设计、实现或评审对应主题 关键路径稳定或被改写后 与阅读指南的主题权威分工一致
领域模型目录 目录.md 业务概念、词什么意思、概念边界;术语全文在 术语表.md 领域模型的文件与材料索引 改业务行为、起名、对术语有分歧时 设计、实现或评审对应主题 新术语或概念边界确认时 与阅读指南的主题权威分工一致
功能覆盖矩阵 功能覆盖矩阵.md 功能覆盖矩阵 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
作者工作台设计 工作台设计.md 作者工作台设计 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
新版 agent-example 总体架构 总体架构.md 新版 agent-example 总体架构 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
现有 Skill 承接表 技能承接表.md 现有 Skill 承接表 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
目标文件清单 目标文件清单.json 逐文件路径、归属、意图、职责、边界和目标 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
编排与能力资源 编排与能力资源.md 编排与能力资源 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
迁移与验收 迁移与验收.md 迁移与验收 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
新版 agent-example 设计阅读指南 阅读指南.md 新版 agent-example 设计阅读指南 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
项目目录与文件职责 项目目录与文件职责.md 项目目录与文件职责 设计、实现或评审对应主题 与阅读指南的主题权威分工一致
文件设计目录 目录.md 各部分文件树与每个目标的意图、职责、边界、目标 确定文件去向和实施边界 清单是目标合同,退出须满足实际验收
验证设计目录 目录.md 诊断行为场景与现行测试登记导航 维护测试及行为评测 各执行模式独立取证
R2 改造历史留痕 R2改造历史留痕.md 固定版本与验证边界 历史追溯 不作为当前全量通过证明

| 优化执行合同 | 优化执行合同.md | 已裁定范围与跨包接口、归属、验证及退出条件 | 实施全仓优化时 | 设计裁决不代表实现已验收 |