2eefaa8cc9
新增功能： - 用户管理列表页面（搜索、分页） - 用户详情页面（基本信息、收藏统计） - 管理员重置用户密码功能 - 管理员修改用户昵称功能 - 管理后台首页添加用户统计卡片 优化改进： - 统一后台菜单结构，创建可复用的 sidebar 组件 - 所有后台页面使用统一菜单，避免硬编码 - 优化权限配置文件，清理冗余规则 技术文档： - 添加任务分解规则文档 - 添加后台菜单统一规则文档 - 添加数据库字段修复脚本 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
4.5 KiB
4.5 KiB
任务分解规则
📋 规则说明
在接到新任务后，必须将主任务分解成合适的子任务，通过分步执行的方式来保障开发的稳定性和准确性。
🎯 核心原则
- 先分解，后执行 - 不要直接开始编码，先进行任务分解
- 小步快跑 - 每个子任务应该是独立、可测试的小单元
- 逐步验证 - 完成一个子任务后，验证无误再进行下一个
- 降低风险 - 避免一次性修改过多文件导致的连锁错误
📝 任务分解流程
第一步：理解需求
- 仔细阅读用户的需求描述
- 明确功能目标和验收标准
- 识别涉及的技术栈和文件
第二步：分解任务
将主任务分解为 3-8 个子任务，每个子任务应该：
- 独立性 - 可以独立完成和测试
- 原子性 - 只做一件事情
- 可验证 - 有明确的完成标准
- 有序性 - 按照依赖关系排序
第三步：列出任务清单
使用 TaskCreate 工具创建任务清单，包括：
- 任务标题（简短、动词开头）
- 详细描述（包含具体要做什么）
- 预期结果（如何验证完成）
第四步：逐个执行
- 使用 TaskUpdate 标记任务为 in_progress
- 完成后标记为 completed
- 遇到问题及时反馈，不要继续下一个任务
✅ 良好的任务分解示例
主任务： 添加用户管理功能
子任务分解：
- 创建用户列表页面路由和模板
- 创建用户详情页面路由和模板
- 实现重置密码 API 接口
- 实现修改用户名 API 接口
- 在管理后台首页添加用户统计
- 在管理后台导航添加用户管理入口
❌ 不良的任务分解示例
错误示例1：任务过大
- ❌ "完成用户管理功能" - 太笼统，无法独立验证
错误示例2：任务过细
- ❌ "创建 user_list.html 文件"
- ❌ "在 user_list.html 中添加表格"
- ❌ "在表格中添加用户名列"
- 这样分解过于琐碎，失去了任务管理的意义
错误示例3：任务无序
- ❌ 先做"添加导航入口"，后做"创建页面路由"
- 应该先有功能，再添加入口
🔍 任务粒度参考
合适的任务粒度：
- 创建一个完整的页面（路由 + 模板 + 样式）
- 实现一个 API 接口（路由 + 逻辑 + 错误处理）
- 添加一个数据库表（模型 + 迁移脚本）
- 实现一个完整的功能模块（前端 + 后端）
任务太大的信号：
- 需要修改超过 5 个文件
- 预计耗时超过 30 分钟
- 包含多个不相关的功能点
- 难以用一句话描述清楚
任务太小的信号：
- 只修改几行代码
- 无法独立测试
- 必须和其他任务一起才有意义
🛠️ 使用工具
TaskCreate - 创建任务
subject: "创建用户列表页面"
description: "创建 /admin/users 路由，实现用户列表展示，包括搜索和分页功能"
activeForm: "创建用户列表页面"
TaskUpdate - 更新任务状态
taskId: "1"
status: "in_progress" # 开始工作时
taskId: "1"
status: "completed" # 完成后
TaskList - 查看任务列表
定期查看任务列表，了解整体进度
📊 任务分解模板
模板1：新增功能页面
- 创建后端路由和数据查询逻辑
- 创建前端页面模板
- 添加页面样式和交互
- 在导航菜单中添加入口
- 测试功能完整性
模板2：API 接口开发
- 设计 API 接口规范（URL、参数、返回值）
- 实现后端路由和业务逻辑
- 添加参数验证和错误处理
- 实现前端调用逻辑
- 测试接口功能
模板3：数据库变更
- 设计数据库表结构
- 创建数据库迁移脚本
- 更新 ORM 模型定义
- 运行迁移并验证
- 更新相关业务逻辑
⚠️ 注意事项
- 不要跳过分解步骤 - 即使任务看起来简单，也要先分解
- 及时调整计划 - 如果发现任务分解不合理，及时调整
- 记录遇到的问题 - 在任务描述中记录遇到的问题和解决方案
- 保持沟通 - 遇到不确定的地方，及时向用户确认
🎯 预期效果
通过任务分解，可以达到：
- ✅ 降低开发风险，减少大规模返工
- ✅ 提高代码质量，每个子任务都经过验证
- ✅ 便于进度跟踪，用户可以看到实时进展
- ✅ 提升开发效率，问题可以及早发现和解决
创建日期: 2025-02-08 最后更新: 2025-02-08 维护人: Claude Sonnet 4.5