Commandjavascript

/git Command

先调用git获取修改的代码,然后更新task-logs到.task-logs文件夹,并且维护activeContext.md文件(也在.task-logs文件夹里),最后上传该任务所修改的代码到git上

View Source

先调用git获取修改的代码,然后更新task-logs到.task-logs文件夹,并且维护activeContext.md文件(也在.task-logs文件夹里),最后上传该任务所修改的代码到git上

git要求

分开提交git

按照不同的修改内容区分,或者用暂存和未提交的区分,要读清楚修改的内容

git提交信息

请为每次代码更新编写规范的git提交信息,包含以下内容:

  1. 简洁明了的标题行(不超过50个字符),使用类型前缀(如feat:、fix:、docs:、style:、refactor:、perf:、test:、chore:)
  2. 空一行后添加详细描述(每行不超过72个字符),包括:
    • 更改的具体内容和原因
    • 解决的问题或实现的功能
    • 技术实现的关键点
  3. 列出所有修改的文件(使用markdown列表格式)
  4. 如果有相关的issue或任务编号,请在描述中引用

提交信息应遵循Angular提交规范,使用中文编写,确保格式清晰易读,便于团队成员理解代码变更历史。

不要显示🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

样例

fix: 修复优惠券系统数据完整性问题

  • 修复优惠券领取时couponSnapshot缺少couponType字段的问题
  • 实现深度复制确保数据完整性,避免浅拷贝导致的数据不一致
  • 完善优惠券类型智能推断逻辑,兼容缺少couponType字段的情况
  • 修复支付金额浮点数精度问题,正确处理分转元的单位转换
  • 添加数据完整性验证机制,防止不完整数据写入数据库

修改文件:

  • cloudfunctions/mall/modules/coupons.js: 修复用户端优惠券领取逻辑
  • admin-miniprogram/cloudfunctions/admin/modules/coupons.js: 修复管理后台发放逻辑
  • miniprogram/utils/price-calculator.js: 完善类型推断和计算逻辑
  • miniprogram/pages/payment/checkout/index.js: 修复金额转换精度问题

关联任务: #优惠券系统数据完整性修复"

Task-Logs 标准格式模板

时间

调用date获取准确时间

📋 文件命名规范

标准命名格式

task-log_YYYY-MM-DD-type_中文描述.md

命名示例

task-log_2025-06-16-bugfix_商城搜索功能Bug修复.md
task-log_2025-06-16-feature_用户认证系统开发.md
task-log_2025-06-16-refactor_数据库架构重构.md
task-log_2025-06-16-optimization_性能优化实施.md
task-log_2025-06-16-deployment_生产环境部署.md

任务类型标识

  • bugfix - Bug修复任务
  • feature - 新功能开发
  • refactor - 代码重构
  • optimization - 性能优化
  • deployment - 部署相关
  • testing - 测试相关
  • documentation - 文档更新
  • maintenance - 维护任务

📝 标准格式模板

# 任务日志: [任务名称]

## 任务概览

**任务ID**: task_YYYY-MM-DD_[type]_[description]
**任务类型**: [任务类型描述]
**开始时间**: YYYY-MM-DD HH:MM
**完成时间**: YYYY-MM-DD HH:MM
**执行状态**: [✅ 已完成并验证 / ⏳ 进行中 / ❌ 失败 / ⏸️ 暂停]
**严重程度**: [高/中/低] ([影响描述])

## 问题描述

### 错误现象
[详细描述用户遇到的具体问题]
1. **主要问题**: [核心问题描述]
2. **次要问题**: [相关问题描述]
3. **用户体验影响**: [对用户的具体影响]

### 错误影响
- [影响范围1]
- [影响范围2]
- [影响范围3]
- [对系统整体的影响]

## 根本原因分析

### 🔍 深度诊断结果

#### 1. **技术层面问题**
- **问题类型**: [具体的技术问题类型]
- **根本原因**: [深层次的技术原因]
- **触发条件**: [问题出现的具体条件]

#### 2. **架构/设计问题**
- **设计缺陷**: [架构或设计层面的问题]
- **数据流问题**: [数据处理流程的问题]
- **依赖关系**: [模块间依赖导致的问题]

### 🚨 犀利批评
**[直接、犀利的问题批评]** [详细说明问题的严重性和根本原因,不留情面地指出设计缺陷或实现问题]

## 修复方案

### 技术修复步骤

#### 1. **核心修复**
```[language]
// 文件:[文件路径] ([具体行号])

// 修复前 (错误)
[错误代码示例]

// 修复后 (正确)
[正确代码示例]

2. 相关修复

// 文件:[文件路径] ([具体行号])
[相关修复代码]

3. 配置/环境修复

// 配置文件修改
[配置修改内容]

返回值格式适配/数据结构调整

  • [数据格式变更说明]
  • [API接口调整说明]
  • [兼容性处理说明]

修复验证

✅ 修复确认清单

  1. 核心功能: [具体验证项] ✅
  2. 相关功能: [具体验证项] ✅
  3. 数据一致性: [具体验证项] ✅
  4. 性能影响: [具体验证项] ✅
  5. 用户体验: [具体验证项] ✅

🔍 代码检查结果

  • 搜索 [问题关键词]: 0个匹配项 ✅
  • 搜索 [修复关键词]: X个匹配项 ✅
  • 文件语法检查: 无错误 ✅

功能测试结果

| 测试场景 | 修复前 | 修复后 | 状态 | |---------|--------|--------|------| | [测试场景1] | [结果1] | [结果2] | ✅ 修复完成 | | [测试场景2] | [结果1] | [结果2] | ✅ 修复完成 |

技术细节

修改文件

  1. 文件: [文件路径]

    • 第X-Y行: [修改内容描述]
    • 第Z行: [修改内容描述]
  2. 文件: [文件路径]

    • 第X-Y行: [修改内容描述]

兼容性保证

  • [兼容性说明1]
  • [兼容性说明2]
  • [向后兼容处理]

预防措施

🛡️ 未来预防策略

  1. 技术预防: [具体的技术预防措施]
  2. 流程预防: [流程改进措施]
  3. 监控预防: [监控和告警措施]
  4. 测试预防: [测试覆盖改进]

📋 质量保证

  • [质量保证措施1]
  • [质量保证措施2]
  • [长期改进建议]

总结

🎯 修复成果

  • 问题解决: [具体解决的问题]
  • 代码质量: [代码质量改进]
  • 系统稳定: [系统稳定性提升]
  • 用户体验: [用户体验改进]
  • 功能验证: [功能验证结果]

💡 经验教训

[深度的技术反思和经验总结,包括对问题根因的深入分析和未来避免类似问题的策略]

重要提醒:

  1. [重要提醒1]
  2. [重要提醒2]
  3. [重要提醒3]

🚀 后续建议

[具体的后续行动建议]:

  • ✅ [已完成项]
  • ✅ [已完成项]
  • ⏳ [待完成项]
  • ⏳ [待完成项]

任务完成时间: YYYY-MM-DD HH:MM 修复质量: [优秀/良好/一般] - [质量评价说明] 影响范围: [具体影响的模块或功能]


## 🎯 关键要素说明

### 必须包含的核心要素

#### 1. **犀利批评部分**
- 必须包含直接、不留情面的问题批评
- 指出设计缺陷、实现问题、架构问题
- 体现技术严谨性和质量要求

#### 2. **技术深度**
- 详细的代码修改示例
- 具体的文件路径和行号
- 完整的修复验证过程

#### 3. **经验教训**
- 深度的技术反思
- 对问题根因的深入分析
- 未来预防策略

#### 4. **量化验证**
- 具体的测试结果对比
- 可验证的检查清单
- 明确的成功标准

### 格式要求

#### 1. **标题层级**
- 使用标准的Markdown标题层级
- 保持层级结构清晰
- 使用emoji图标增强可读性

#### 2. **代码块格式**
- 使用正确的语言标识
- 包含文件路径和行号注释
- 提供修复前后对比

#### 3. **表格格式**
- 使用标准的Markdown表格
- 包含状态标识(✅❌⏳)
- 提供清晰的对比数据

#### 4. **时间格式**
- 统一使用 YYYY-MM-DD HH:MM 格式
- 包含开始和完成时间
- 记录关键时间节点

## 📚 参考示例

参考已完成的任务日志:
- `task-log_2025-06-16-bugfix_商城前后端交互Bug修复.md`
- `task-log_2025-06-16-bugfix_商城搜索功能Bug修复.md`

这些示例展示了标准格式的完整应用,包括犀利批评、技术深度和经验总结。