代码详细设计
本目录用于承接 Phase 1 特性实现设计，进一步从代码维度说明这些特性应如何落到模块、接口、数据结构和测试上。
本阶段仍然不写生产代码。目标是为后续代码实现提供足够明确的工程蓝图。
设计目标
代码详细设计需要回答：
- 每个 feature 对应哪些代码模块？
- 每个模块的职责边界是什么？
- 核心数据模型有哪些？
- 核心函数/类接口是什么？
- 运行流如何串联？
- 测试应该覆盖哪些行为？
- 哪些地方必须保持可替换，以满足性能和未来调度要求？
约束
代码详细设计必须遵守：
尤其要遵守以下冻结边界：
- Phase 1 CLI-first。
- Pydantic AI 是 execution engine。
- Runtime local-first，但 scheduler-ready。
- Runs durable、sandboxed、artifact-based。
- Memory 外部化，通过显式 contract 访问。
- Skills 是 filesystem packages，支持 progressive loading。
- Tools 显式、受权限控制、可观测。
- Quality/Governance 从最小可执行检查开始。