64 lines
2.5 KiB
Markdown
64 lines
2.5 KiB
Markdown
# 任务完成时间标记规约
|
|
|
|
## 1. 目的
|
|
|
|
本规约旨在统一任务完成时间的标记规范，确保所有已完成任务都有明确的完成时间，便于任务进度追踪和历史任务管理。
|
|
|
|
## 2. 适用范围
|
|
|
|
本规约适用于 `docs/00_Business/Task_Overview.md` 文件中所有任务表的完成时间标记。
|
|
|
|
## 3. 规范内容
|
|
|
|
### 3.1 表格结构
|
|
|
|
所有任务表必须包含 "完成时间" 列，表头格式如下：
|
|
|
|
```markdown
|
|
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
|
```
|
|
|
|
### 3.2 完成时间格式
|
|
|
|
- 已完成任务的完成时间统一格式为 `YYYY-MM-DD`
|
|
- 未完成任务的完成时间字段为空
|
|
- 历史已完成任务的完成时间统一设置为 `2026-03-20`
|
|
|
|
### 3.3 状态标记
|
|
|
|
- 已完成任务状态标记为 `✅ completed` 或 `✅ 已完成`
|
|
- 未完成任务状态标记为 `pending` 或其他未完成状态
|
|
|
|
### 3.4 操作流程
|
|
|
|
1. **添加完成时间列**：为所有任务表添加 "完成时间" 列
|
|
2. **标记已完成任务**：为所有状态为已完成的任务添加完成时间 `2026-03-20`
|
|
3. **保持未完成任务**：未完成任务的完成时间字段保持为空
|
|
4. **新增任务处理**：新添加的任务，完成后及时添加完成时间
|
|
|
|
### 3.5 示例
|
|
|
|
```markdown
|
|
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
|
| ------- | -------- | -------- | ---- | ---- | -------- | ---- | ------ | ---- | -------- | ------ | -------- |
|
|
| FE-P001 | 商品刊登闭环 | 渲染商品列表页面 | 用户ID, 筛选条件 | 商品列表数据 | 页面加载 | ✅ completed | P1 | - | 4h | AI-Frontend-1 | 2026-03-20 |
|
|
| FE-P002 | 商品刊登闭环 | 渲染商品详情页面 | 商品ID | 商品详情数据 | 点击商品 | ✅ completed | P1 | FE-P001 | 3h | AI-Backend-9 | 2026-03-20 |
|
|
| BE-P001 | 商品刊登闭环 | 商品数据获取接口 | 商品ID | 商品数据 | API请求 | pending | P1 | - | 5h | AI-Backend-1 | |
|
|
```
|
|
|
|
## 4. 执行责任
|
|
|
|
- 任务完成后，负责人应及时更新任务状态并添加完成时间
|
|
- 定期检查任务表，确保所有已完成任务都有完成时间标记
|
|
- 新增任务时，按照本规约格式添加到任务表中
|
|
|
|
## 5. 版本控制
|
|
|
|
本规约自发布之日起生效，如有变更，将在文档中更新版本号和变更内容。
|
|
|
|
### 版本历史
|
|
|
|
| 版本 | 发布日期 | 变更内容 |
|
|
| ---- | -------- | -------- |
|
|
| 1.0 | 2026-03-20 | 初始发布 |
|