Private
Public Access
1
0

重构:文件系统模块化架构,优化应用启动流程

This commit is contained in:
2026-01-28 00:28:54 +08:00
parent 4a9b25a505
commit 8c577f70e7
123 changed files with 32030 additions and 967 deletions

View File

@@ -0,0 +1,146 @@
# AI协作检查清单
**状态**:已确定
**最后更新**2025-01-28
---
## 一、开始任务前检查
### 1.1 读取约束
- [ ] 已读取 [编码规范.md](./编码规范.md)
- [ ] 已读取 [架构规范.md](./架构规范.md)
- [ ] 已读取 [技术栈.md](../参考/技术栈.md)
### 1.2 检查决策
- [ ] 已检查 [决策记录/](../决策记录/) 中相关决策
- [ ] 已理解相关决策的约束和影响
### 1.3 检查问题
- [ ] 已检查 [问题追踪/](../../问题追踪/) 中相关问题
- [ ] 已理解待解决问题和待实现功能
---
## 二、设计阶段检查
### 2.1 设计文档
- [ ] 设计文档符合模板格式
- [ ] 引用了相关的知识库规范
- [ ] 关联了相关的决策记录ADR
- [ ] 列出了待讨论问题
### 2.2 决策记录
- [ ] 重要决策已创建ADR
- [ ] ADR格式符合标准模板
- [ ] 决策理由清晰明确
---
## 三、实现阶段检查
### 3.1 代码规范
- [ ] 方法参数不超过3个
- [ ] 不返回 `RetResult<Void>` 类型
- [ ] 代码简洁,易于维护
- [ ] 必要注释已添加
### 3.2 架构规范
- [ ] 符合分层架构
- [ ] 职责分离明确
- [ ] 事件参数使用对象格式
- [ ] 所有事件有类型定义
### 3.3 样式规范
- [ ] 使用Arco基础样式
- [ ] 避免过度自定义样式
- [ ] 确保主题兼容
---
## 四、文档更新检查
### 4.1 知识库更新
- [ ] 新确定的知识已加入知识库
- [ ] 知识库内容已验证
### 4.2 问题追踪更新
- [ ] 已解决问题已关闭
- [ ] 新问题已创建
- [ ] 问题状态已更新
### 4.3 决策记录更新
- [ ] 新决策已创建ADR
- [ ] 相关ADR已更新
---
## 五、完成检查
### 5.1 代码检查
- [ ] 编译通过
- [ ] 无Linter错误
- [ ] 符合编码规范
### 5.2 文档检查
- [ ] 设计文档已更新
- [ ] 决策记录已更新
- [ ] 问题追踪已更新
### 5.3 测试检查
- [ ] 功能测试通过
- [ ] 测试用例已更新
---
## 六、常见错误避免
### 6.1 代码错误
- ❌ 方法参数超过3个
- ❌ 返回 `RetResult<Void>` 类型
- ❌ 过度设计,增加不必要复杂度
### 6.2 架构错误
- ❌ 违反分层架构
- ❌ 事件参数使用多个参数
- ❌ 缺少类型定义
### 6.3 文档错误
- ❌ 问题与知识混淆
- ❌ 决策未记录
- ❌ 约束未明确
---
## 七、引用规范
### 7.1 引用格式
- 知识库:`[知识库/规范/编码规范.md](../../知识库/规范/编码规范.md)`
- 决策记录:`[ADR-001](../决策记录/ADR-001-事件系统设计.md)`
- 问题追踪:`[问题-001](../../问题追踪/待讨论/问题-001-右键菜单实现方式.md)`
- 设计文档:`[设计文档/架构设计/事件系统设计.md](../../设计文档/架构设计/事件系统设计.md)`
### 7.2 引用原则
- 引用要准确,使用相对路径
- 引用要明确,说明引用内容
- 引用要完整,包含路径和说明
---
## 八、协作流程
### 8.1 开始任务
1. 读取约束(知识库/规范)
2. 检查决策(决策记录)
3. 检查问题(问题追踪)
### 8.2 执行任务
1. 遵循约束
2. 记录决策
3. 更新问题
### 8.3 完成任务
1. 更新文档
2. 创建检查报告
3. 更新任务状态