docs: 更新开发计划文档并添加工具选择说明
添加 Claude Code 简称说明到代码生成情况对比文档 在新功能开发计划文档中添加详细的工具选择说明,明确不同任务类型推荐使用的 AI 工具 更新各阶段开发任务说明,标注哪些组件应使用 Trae 生成
Showing
2 changed files
with
49 additions
and
4 deletions
| 1 | # 26.1.26 新功能开发计划 | 1 | # 26.1.26 新功能开发计划 |
| 2 | 2 | ||
| 3 | +## 🤖 工具选择说明(重要) | ||
| 4 | + | ||
| 5 | +根据 [代码生成情况对比](../done/代码生成情况对比.md) 的决策树,本次开发采用 **Claude Code (规划) + Trae (页面/组件) + Claude Code (测试)** 的混合工作流: | ||
| 6 | + | ||
| 7 | +### 工具分工 | ||
| 8 | + | ||
| 9 | +| 任务类型 | 使用工具 | 原因 | | ||
| 10 | +| ---------------- | --------------- | ---------------------------- | | ||
| 11 | +| **新组件生成** | **Trae** | 视觉还原效果好,样式处理精细 | | ||
| 12 | +| **API 接口** | **Claude Code** | 遵循项目架构,代码规范统一 | | ||
| 13 | +| **Composables** | **Claude Code** | 业务逻辑封装,易于测试 | | ||
| 14 | +| **修改现有组件** | **Claude Code** | 小改动(< 50 行)直接修改 | | ||
| 15 | +| **代码审查** | **Claude Code** | 检查代码风格和架构模式 | | ||
| 16 | +| **测试编写** | **Claude Code** | TDD 流程,测试覆盖 | | ||
| 17 | + | ||
| 18 | +### 本次开发涉及的新组件(使用 Trae 生成) | ||
| 19 | + | ||
| 20 | +1. **第 2 阶段**: | ||
| 21 | + - `CheckinCommentDialog.vue` - 评论输入弹窗 | ||
| 22 | + - `EmojiPicker.vue` - 表情选择器 | ||
| 23 | + | ||
| 24 | +2. **第 3 阶段**: | ||
| 25 | + - `CheckinCommentList.vue` - 评论列表组件 | ||
| 26 | + | ||
| 27 | +3. **第 4 阶段**: | ||
| 28 | + - `CheckinPoster.vue` - 海报生成组件 | ||
| 29 | + | ||
| 30 | +### 推荐流程 | ||
| 31 | + | ||
| 32 | +```bash | ||
| 33 | +# 1. 使用 Trae 生成新组件 | ||
| 34 | +# 上传设计稿 → 描述需求 → Trae 生成代码 | ||
| 35 | + | ||
| 36 | +# 2. 使用 Claude Code 生成 API 和 Composables | ||
| 37 | +# /speckit.implement 或直接编写 | ||
| 38 | + | ||
| 39 | +# 3. 使用 Claude Code 进行代码审查和测试 | ||
| 40 | +# /code-review + /tdd | ||
| 41 | +``` | ||
| 42 | + | ||
| 43 | +--- | ||
| 44 | + | ||
| 3 | ## 背景 | 45 | ## 背景 |
| 4 | 46 | ||
| 5 | 为了增强用户在打卡列表的互动性和管理能力,需要在打卡卡片(CheckinCard)上增加更多操作选项,包括置顶、评论、海报分享以及展示评论列表。这些功能将通过环境变量开关进行控制,以便按需开启。 | 47 | 为了增强用户在打卡列表的互动性和管理能力,需要在打卡卡片(CheckinCard)上增加更多操作选项,包括置顶、评论、海报分享以及展示评论列表。这些功能将通过环境变量开关进行控制,以便按需开启。 |
| ... | @@ -325,12 +367,13 @@ | ... | @@ -325,12 +367,13 @@ |
| 325 | - 在 `src/api/checkin.js` 中定义 `addCheckinCommentAPI` | 367 | - 在 `src/api/checkin.js` 中定义 `addCheckinCommentAPI` |
| 326 | 368 | ||
| 327 | 2. **创建评论输入弹窗**: | 369 | 2. **创建评论输入弹窗**: |
| 328 | - - 创建 `CheckinCommentDialog.vue` 组件 | 370 | + - 🎨 **使用 Trae 生成**: `CheckinCommentDialog.vue` 组件 |
| 371 | + - 参考 Vant Popup 组件,底部弹出样式 | ||
| 329 | - 实现 `van-field` 文本输入框(多行模式) | 372 | - 实现 `van-field` 文本输入框(多行模式) |
| 330 | - 实现字符计数提示(最多 200 字) | 373 | - 实现字符计数提示(最多 200 字) |
| 331 | 374 | ||
| 332 | 3. **实现表情选择器**: | 375 | 3. **实现表情选择器**: |
| 333 | - - 创建 `EmojiPicker.vue` 组件 | 376 | + - 🎨 **使用 Trae 生成**: `EmojiPicker.vue` 组件 |
| 334 | - 使用 `van-popup` + `van-grid` 展示表情符号 | 377 | - 使用 `van-popup` + `van-grid` 展示表情符号 |
| 335 | - 实现点击表情插入到输入框光标位置 | 378 | - 实现点击表情插入到输入框光标位置 |
| 336 | - 定义常用表情列表(原生 Unicode Emoji) | 379 | - 定义常用表情列表(原生 Unicode Emoji) |
| ... | @@ -375,7 +418,7 @@ | ... | @@ -375,7 +418,7 @@ |
| 375 | - `deleteCheckinCommentAPI` - 删除评论 | 418 | - `deleteCheckinCommentAPI` - 删除评论 |
| 376 | 419 | ||
| 377 | 2. **创建评论列表组件**: | 420 | 2. **创建评论列表组件**: |
| 378 | - - 创建 `CheckinCommentList.vue` 组件 | 421 | + - 🎨 **使用 Trae 生成**: `CheckinCommentList.vue` 组件 |
| 379 | - 参考 `StudyCommentsSection.vue` 的实现模式 | 422 | - 参考 `StudyCommentsSection.vue` 的实现模式 |
| 380 | - 实现首屏展示最多 5 条评论 | 423 | - 实现首屏展示最多 5 条评论 |
| 381 | - 超过 5 条显示"查看全部"按钮 | 424 | - 超过 5 条显示"查看全部"按钮 |
| ... | @@ -438,7 +481,7 @@ | ... | @@ -438,7 +481,7 @@ |
| 438 | - 安装依赖: `pnpm add html2canvas` | 481 | - 安装依赖: `pnpm add html2canvas` |
| 439 | 482 | ||
| 440 | 2. **创建海报组件**: | 483 | 2. **创建海报组件**: |
| 441 | - - 创建 `CheckinPoster.vue` 组件 | 484 | + - 🎨 **使用 Trae 生成**: `CheckinPoster.vue` 组件 |
| 442 | - 参考 `SharePoster.vue` 的实现模式 | 485 | - 参考 `SharePoster.vue` 的实现模式 |
| 443 | - 实现布局: 用户信息、打卡内容、二维码 | 486 | - 实现布局: 用户信息、打卡内容、二维码 |
| 444 | 487 | ... | ... |
-
Please register or login to post a comment