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