2026-07-14 15:01:17 +08:00
|
|
|
# AGENTS.md
|
|
|
|
|
|
|
|
|
|
## MVP 实现阶段指南
|
|
|
|
|
|
|
|
|
|
在 MVP 实现阶段，解决问题时请遵循以下文档阅读层级（由高到低，只有需要时才往下阅读）：
|
|
|
|
|
|
|
|
|
|
### 文档阅读层级
|
|
|
|
|
|
|
|
|
|
- **P1 - MVP 方案文档** (`docs/mvp-skeleton-plan.md`)
|
|
|
|
|
- 项目骨架结构、模块划分、接口定义
|
|
|
|
|
- 技术实现要点和代码规范
|
|
|
|
|
- **优先阅读**：大部分问题应首先在此文档中寻找答案
|
|
|
|
|
|
|
|
|
|
- **P2 - 原型文档** (`docs/ref/xinfra-prototype.v3.html`)
|
|
|
|
|
- 完整的页面交互流程和 UI 规范
|
|
|
|
|
- 组件行为、状态管理、API 调用时机
|
|
|
|
|
- 异常处理和用户体验细节
|
|
|
|
|
- **当需要理解具体交互时阅读**
|
|
|
|
|
|
|
|
|
|
- **P3 - 架构文档** (`docs/ref/架构文档-v3.md`)
|
|
|
|
|
- 系统架构设计和技术选型
|
|
|
|
|
- 模块划分和依赖关系
|
|
|
|
|
- 数据流向和接口规范
|
|
|
|
|
- **当需要理解整体架构时阅读**
|
|
|
|
|
|
|
|
|
|
- **P4 - 需求文档** (`docs/ref/平台需求文档-v3.md`)
|
|
|
|
|
- 平台整体需求和功能范围
|
|
|
|
|
- 用户故事和验收标准
|
|
|
|
|
- **当需要明确需求范围时阅读**
|
|
|
|
|
|
|
|
|
|
### 实现原则
|
|
|
|
|
|
|
|
|
|
- **先读文档，再看代码**：理解设计意图后再动手实现
|
|
|
|
|
- **层级优先**：P1 能解决的问题不要去看 P2、P3、P4
|
|
|
|
|
- 严格遵循 MVP 文档中定义的目录结构和模块划分
|
|
|
|
|
- 参考原型文档中的交互流程和状态管理
|
|
|
|
|
- 保持代码简洁，聚焦 MVP 核心功能
|
|
|
|
|
- 遵循项目既定的技术栈和编码规范
|
2026-07-14 15:04:12 +08:00
|
|
|
|
|
|
|
|
### Git 操作规范
|
|
|
|
|
|
|
|
|
|
- **禁止自动提交**：除非用户明确指示，否则不要执行 `git commit`
|
|
|
|
|
- **Commit Message**：使用多行格式，包含 type、scope、subject 和详细 body
|
