# update-roadmap-status

> 管理 ROADMAP.md 中的任务生命周期的技能。支持开始任务、完成任务和更新子任务进度三种操作。当用户需要更新项目路线图中的任务状态时使用此技能。支持自然语言指令解析、命令行和交互模式，保持格式一致性。

- Author: silevilence
- Repository: silevilence/FlexComDotnet
- Version: 20260130135509
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/silevilence/FlexComDotnet
- Web: https://mule.run/skillshub/@@silevilence/FlexComDotnet~update-roadmap-status:20260130135509

---

---
name: update-roadmap-status
description: 管理 ROADMAP.md 中的任务生命周期的技能。支持开始任务、完成任务和更新子任务进度三种操作。当用户需要更新项目路线图中的任务状态时使用此技能。支持自然语言指令解析、命令行和交互模式，保持格式一致性。
---

# Update Roadmap Status

## 概述

此技能用于管理 ROADMAP.md 文件中的任务生命周期。它支持三种核心操作：
1. **开始任务**：将任务从"计划中"移动到"开发中"章节
2. **完成任务**：将任务标记为完成并移动到"已完成"章节
3. **更新进度**：更新"开发中"任务的子任务状态

技能支持自然语言指令解析、命令行和交互模式，确保与现有格式保持一致。

## 使用场景

当以下情况发生时使用此技能：
- 用户开始开发某个功能，需要将任务标记为"开发中"
- 用户完成某个功能，需要将任务标记为"已完成"
- 用户想要更新正在开发任务的子任务进度
- 用户需要管理项目路线图的任务状态流转

## 快速开始

### 方法1：使用脚本（推荐）

```bash
# 开始任务
python scripts/update_roadmap_status.py start "任务名称"

# 完成任务
python scripts/update_roadmap_status.py complete "任务名称"

# 更新子任务进度
python scripts/update_roadmap_status.py update "任务名称" --subtask "子任务描述"

# 交互模式
python scripts/update_roadmap_status.py
```

### 方法2：自然语言指令

直接向 Claude 描述您的需求，例如：
- "我想开始开发 XXX 功能"
- "XXX 任务已经完成了"
- "更新 XXX 任务的子任务 YYY 状态"
- "标记 XXX 任务的子任务 YYY 为已完成"

## 核心功能

### 1. 开始任务
- **输入**：任务名称（支持中文名称或英文名称模糊匹配）
- **操作**：
  1. 在"计划中"章节查找指定任务
  2. 将任务及其所有子任务移动到"开发中"章节
  3. 保持任务复选框为未完成状态 `[ ]`
  4. 按开始时间排序（后添加的在前）

### 2. 完成任务
- **输入**：任务名称（支持模糊匹配）
- **操作**：
  1. 在"开发中"章节查找指定任务
  2. 将主任务的复选框标记为 `[x]`
  3. 将任务及其所有子任务移动到"已完成"章节
  4. 按完成时间排序（后完成的在前）

### 3. 更新进度
- **输入**：主任务名称、子任务描述
- **操作**：
  1. 在"开发中"章节查找指定主任务
  2. 根据子任务描述匹配子任务（支持模糊匹配）
  3. 更新子任务复选框状态：`[ ]` → `[x]`
  4. 主任务复选框保持 `[ ]`（除非明确指示完成）

## 任务格式规范

### 章节结构
ROADMAP.md 包含三个主要章节：
- `## 📝 计划中 (Planned)`: 待开发的需求池，按优先级排序
- `## 🚧 开发中 (In Progress)`: 当前正在进行的工作
- `## ✅ 已完成 (Completed)`: 已验收通过的功能

### 任务块定义
一个完整的任务块包括：
- **主任务行**: 以 `- [ ]` 开头，包含优先级表情符号和任务名称
- **子任务行**: 以 `    - [ ]` 开头（4空格缩进），可能包含进一步描述
- **任务边界**: 直到下一个主任务行或章节结束

### 优先级系统
- **P0** (🔴): 最高优先级，基础核心功能
- **P1** (🟡): 中等优先级，重要功能
- **P2** (🟢): 低优先级，增强功能

## 详细工作流程

### 1. 自然语言解析
从用户请求中提取：
- **操作类型**: 开始、完成、更新
- **任务名称**: 支持中文名称或英文名称模糊匹配
- **子任务描述**（仅更新操作需要）

### 2. 文件处理
1. 检查 ROADMAP.md 文件是否存在
2. 读取文件内容并解析章节结构
3. 验证章节完整性（自动创建缺失章节）

### 3. 任务查找
1. 根据操作类型确定查找章节
2. 使用模糊匹配算法查找任务
3. 提取完整的任务块（主任务 + 所有子任务）

### 4. 状态验证
1. 验证当前任务状态是否允许目标操作
2. 提供清晰的错误信息和恢复建议

### 5. 状态更新
1. 执行相应的状态转换操作
2. 保持格式一致性
3. 按章节规则重新排序任务

### 6. 保存与确认
1. 保存更新后的文件
2. 向用户显示变更摘要
3. 确认操作成功

## 错误处理

- **任务不存在**: 提供相似任务建议，列出可能的匹配项
- **章节不存在**: 自动创建缺失章节
- **子任务不存在**: 列出所有可用子任务供选择
- **任务已在目标状态**: 提示当前状态，询问是否继续
- **文件权限问题**: 显示详细错误信息和修复建议
- **格式错误**: 尝试修复或提示用户手动修复

## 资源参考

- **脚本**: `scripts/update_roadmap_status.py` - 主处理脚本
- **格式参考**: `references/roadmap_format.md` - ROADMAP.md 格式规范
- **相关技能**: `add-roadmap-task` - 任务添加技能

## 最佳实践

1. **保持一致性**: 遵循现有的格式和风格
2. **及时更新**: 任务状态应及时反映实际开发进度
3. **详细描述**: 子任务更新时应提供具体进展
4. **定期审查**: 定期审查路线图，确保状态准确
5. **团队协作**: 确保团队成员了解任务状态变化

## 与现有技能集成

本技能与 `add-roadmap-task` 技能完全兼容：
- 共享相同的格式规范和优先级系统
- 支持相同的任务命名约定
- 可以无缝衔接使用：添加任务 → 开始任务 → 更新进度 → 完成任务

## 故障排除

### 常见问题
1. **任务查找失败**
   - 检查任务名称是否正确
   - 使用交互模式查看所有可用任务
   - 确保任务在正确的章节中

2. **文件权限错误**
   - 检查文件是否被其他程序占用
   - 确保有写权限
   - 尝试以管理员身份运行

3. **格式损坏**
   - 备份原始文件
   - 使用 `git diff` 查看变更
   - 手动修复格式问题

### 恢复选项
- **自动备份**: 每次操作前自动创建备份文件
- **手动恢复**: 提供回滚到上一个版本的选项
- **验证检查**: 操作后验证文件格式完整性