Task Lifecycle Manager (TLM)

此技能定义了 TG ONE 项目中任务管理的唯一标准流程。 作为 AI 助手，在执行任何复杂编码任务（需建立 Workstream 的任务）时，必须严格遵守此规范。

1. 核心理念

文档即状态 (Documentation is State) 代码是逻辑的载体，而文档是工程进度的唯一真理来源 (Source of Truth)。 永远不要让 todo.md 的状态落后于代码实现。

2. 文档规范标准 (Standards)

所有新创建的任务文件夹 (docs/Workstream_{Domain}/{Date}_{TaskName}) 必须包含以下核心文件：

2.1 todo.md (任务清单)

• 定位: 任务的驾驶舱，记录"要做什么"和"做到了哪里"。
• 核心要素:
  • Context: 1-2 句话描述任务背景。
  • Strategy: 简述核心技术路径（如：Facade 模式重构，AIMD 算法实现）。
  • Phased Checklist: 必须按 Phase 1, Phase 2... 分阶段列出详细 Checkbox。
• 状态规则:
  • [ ]: 待开始。
  • [x]: 已完成（必须经代码验证）。
  • [~]: 部分完成/挂起（需备注原因）。

2.2 spec.md (技术方案)

• 定位: 实施前的蓝图，防止走歪。
• 触发条件: 涉及 DB 变更、API 接口变更、核心架构调整时必须编写。
• 核心要素:
  • Database Changes: SQL DDL 或 SQLAlchemy 模型定义。
  • API Design: Endpoint, Request/Response 示例。
  • Class/Component Design: 核心类图或接口定义。

2.3 report.md (交付报告)

• 定位: 任务结束的验收单，证明"我做完了"且"质量达标"。
• 核心要素:
  • Summary: 一句话概括产出。
  • Architecture Refactor: 实际发生的架构变更。
  • Verification: 测试结果（单元测试通过率、功能验证截图/日志）。
  • Manual: 关键配置项或用户操作指南。

2.4 process.md (全局总线)

• 定位: 项目上帝视角，位于 docs/process.md。
• 维护规则:
  • 任务启动时：在 进行中任务 添加条目。
  • 任务完成时：移至 已完成任务 表格，状态记为 100%，附上文件夹链接。

---

3. 标准作业流程 (SOP)

Stage 1: Initialization (启动)

1. 定位领域: 确定 Workstream_{Domain}。
2. 创建目录: mkdir {YYYYMMDD}_{TaskName}_{Phase}。
3. 生成模版:
   • 创建 todo.md 并填入初始规划。
   • 如果任务复杂，创建 spec.md。
   • 更新 docs/process.md，注册新任务。

Stage 2: Synchronization (同步)

何时执行: 每次对话结束前，或用户询问"进度如何"时。

1. 代码审计 (Code Audit):
   • 检查代码是否已实现 todo.md 中的 Checkbox 项。
   • Tip: 使用 grep 搜索关键函数名、类名、配置项来验证存在性。
2. 自动化验证 (Automated Verification) ⭐ NEW - MANDATORY:
   • 运行 task-syncer 技能进行文件存在性验证:

   python .agent/skills/task-syncer/scripts/check_status.py "docs/current/todo.md"
   

   • 根据输出结果修正 todo.md 的勾选状态。
3. 状态校准 (State Alignment):
   • 发现代码已实现但文档未勾选 -> 立即勾选。
   • 发现代码逻辑变更 -> 更新 todo 描述。
   • 发现已废弃的计划 -> 标记为 [Skipped] 或删除。

Stage 3: Finalization (闭环)

何时执行: 所有核心 Checkbox (P0/P1) 均为 [x] 时。

1. 生成报告: 编写 report.md。
2. 全局更新:
   • 将 docs/process.md 中的条目状态改为 100%。
   • 填写 完成日期。
3. 清理现场:
   • 删除根目录下的临时文件 (temp_*.py, debug.log)。
   • 运行 tree 命令更新 docs/tree.md (或使用 docs-maintenance 技能)。

Stage 4: Evolution Assessment (进化评估) ⭐ NEW - CLOSED LOOP

何时执行: 报告提交后，归档前。

1. 技能回顾 (Skill Review):
   • 本任务是否调用了现有 Skill？
   • 若调用失败并转为手动，必须调用 skill-evolution 修复该 Skill。
2. 新技能挖掘 (Skill Mining):
   • 本任务是否解决了重复性问题？(历史类似任务 > 1)
   • 若是，必须调用 skill-evolution 将本任务产出 (Scripts/SOP) 转化为新 Skill。

---

4. 技能指令 (Actions)

@check_status (状态检查)

当用户要求"同步状态"或"检查进度"时：

1. 读取当前任务目录下的 todo.md。
2. 读取 src/ 或 handlers/ 下的相关代码文件。
3. 对比差异，并执行 multi_replace_file_content 更新 todo.md。
4. 如果任务看似已完成（关键功能均存在），检查 report.md 是否生成。

@finalize_task (任务结项)

1. 确认 todo.md 全绿。
2. 创建/更新 report.md。
3. 更新 docs/process.md 表格。
4. 提醒用户："任务已闭环，文档已对齐。"

@create_spec (创建方案)

1. 在当前任务目录下创建 spec.md。
2. 填入模版：## 背景, ## DB Schema, ## API Design, ## Implementation Steps。

---

5. 模版示例 (Templates)

todo.md Template

# 任务名称 (Task Name)

## 背景 (Context)
简述任务目标...

## 待办清单 (Checklist)

### Phase 1: 核心实现
- [ ] 定义数据模型 (Schema)
- [ ] 实现 Service 层逻辑
- [ ] 编写单元测试

### Phase 2: UI 集成
- [ ] 更新 Web 路由
- [ ] 实现前端页面

process.md Entry Template

| {YYYYMMDD}_{Task} | {Task Description} | {Start Date} | {End Date} | 100% | [📂 查看](./Workstream_{Domain}/{Folder}/) |