Back to Details

roadmap-management

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Project Roadmap Management

项目路线图管理

Overview

概述

Manage project roadmaps using a minimalist, position-based priority system. Core philosophy: Position = Priority. Items at the top have the highest value.
This skill helps create and maintain 
ROADMAP.md
files using a simple, effective structure that eliminates complex priority matrices and scoring systems.
采用极简的基于位置的优先级系统管理项目路线图。核心理念：位置=优先级。排在顶部的条目价值最高。
本技能可帮助你创建和维护
ROADMAP.md
文件，采用简洁高效的结构，无需复杂的优先级矩阵和评分系统。

Core Philosophy

核心理念

Position = Priority: Instead of calculating ICE scores or filling priority matrices, manually arrange items by importance. What's at the top matters most.
Simplicity over Process: No complex tracking systems. If a task sits in Backlog for 3+ months untouched, delete it or move to Someday.
Focus on Execution: Limit "Doing" to 2-3 items max. Context switching kills productivity.
位置=优先级：无需计算ICE分数或填写优先级矩阵，手动按重要性排列条目。顶部的内容就是最关键的。
简洁胜于流程：无需复杂的跟踪系统。如果某任务在待办储备中放置3个月以上未处理，直接删除或移至“未来规划”板块。
聚焦执行：“进行中”板块最多限制2-3个条目。上下文切换会严重影响生产力。

ROADMAP Structure

ROADMAP结构

📥 Inbox          → Quick capture, weekly cleanup
🏗️ Execution
  🟢 Doing        → Active work (Max 2-3 items)
  🟡 Next Up      → Ordered by value/urgency
  ⚪ Backlog      → Future tasks, not urgent
📔 Done           → Completed achievements
📥 收件箱          → 快速捕获想法，每周清理
🏗️ 执行区
  🟢 进行中        → 活跃工作任务（最多2-3个条目）
  🟡 待启动      → 按价值/紧急程度排序
  ⚪ 待办储备      → 未来任务，暂无紧迫性
📔 已完成           → 已达成的成果

Section Guidelines

板块指南

Inbox
  • Temporary holding area for quick thoughts
  • Review weekly: promote to Execution or delete
  • Examples: "Consider payment integration", "Fix typo on profile page"
Doing (Max 2-3)
  • Currently active code/work
  • Strict limit prevents context switching
  • Include current status in parentheses
Next Up
  • Ordered list: top = highest priority
  • Manual sorting replaces priority scoring
  • Critical bugs (🔴 P0) go first
  • High-demand features come before nice-to-haves
Backlog
  • Future tasks, no urgency
  • Review monthly: promote or delete stale items
  • If untouched for 3+ months, probably deletable
Done
  • Completed milestones and achievements
  • Keep for morale and progress tracking
  • Include version numbers when applicable
收件箱
  • 临时存放快速记录的想法
  • 每周审核：将合适的条目移至执行区或删除
  • 示例：“考虑支付集成”、“修复个人资料页面的拼写错误”
进行中（最多2-3个）
  • 当前正在进行的编码/工作任务
  • 严格限制数量以避免上下文切换
  • 在括号中添加当前状态
待启动
  • 有序列表：顶部=最高优先级
  • 手动排序替代优先级评分
  • 严重漏洞（🔴 P0）排在最前面
  • 高需求功能优先于锦上添花的功能
待办储备
  • 未来任务，暂无紧迫性
  • 每月审核：将有价值的条目升级或删除长期未处理的条目
  • 若3个月以上未处理，大概率可以删除
已完成
  • 已完成的里程碑和成果
  • 保留以提升士气和跟踪进度
  • 适用时可包含版本号

Common Operations

常见操作

Initialize a New Roadmap

初始化新路线图

Copy the template from 
assets/ROADMAP.md
to the project root:
bash
cp assets/ROADMAP.md /path/to/project/ROADMAP.md
将
assets/ROADMAP.md
中的模板复制到项目根目录：
bash
cp assets/ROADMAP.md /path/to/project/ROADMAP.md

Add a New Task

添加新任务

  1. Quick capture → Add to Inbox
  2. Planned task → Add directly to appropriate section:
    • Critical bug → Top of "Next Up" or insert into "Doing"
    • Normal feature → "Next Up" ordered by priority
    • Future idea → "Backlog"
  1. 快速捕获 → 添加至收件箱
  2. 规划好的任务 → 直接添加至对应板块：
    • 严重漏洞 → “待启动”顶部或插入“进行中”
    • 常规功能 → “待启动”按优先级排序
    • 未来想法 → “待办储备”

Prioritize Tasks

任务优先级设置

Manual reordering in "Next Up":
  1. Cut the task line
  2. Paste it in the new position
  3. Top = highest priority, bottom = lowest
No calculation needed. Trust your judgment on what matters most.
在“待启动”中手动重新排序：
  1. 剪切任务行
  2. 粘贴到新位置
  3. 顶部=最高优先级，底部=最低优先级
无需计算，相信你对重要性的判断。

Move Task Status

移动任务状态

Starting work: Cut from "Next Up" → Paste into "Doing" Completing work: Change 
[ ]
to 
[x]
, cut → paste into "Done" Deprioritizing: Cut → paste into "Backlog"
开始工作：从“待启动”剪切 → 粘贴至“进行中” 完成工作：将
[ ]
改为
[x]
，剪切 → 粘贴至“已完成” 降低优先级：剪切 → 粘贴至“待办储备”

Handle Bugs

漏洞处理

  • Critical (🔴 P0): Top of "Next Up" or insert into "Doing" immediately
  • Minor (🟡): Add to "Backlog", fix when changing mental context
  • 严重（🔴 P0）：立即移至“待启动”顶部或插入“进行中”
  • 次要（🟡）：添加至“待办储备”，在切换工作上下文时修复

Weekly Cleanup

每周清理

  1. Review Inbox: promote or delete each item
  2. Check Backlog: delete anything 3+ months old and untouched
  3. Ensure "Doing" has max 2-3 items
  4. Reorder "Next Up" based on current priorities
  1. 审核收件箱：升级或删除每个条目
  2. 检查待办储备：删除3个月以上未处理的条目
  3. 确保“进行中”最多有2-3个条目
  4. 根据当前优先级重新排序“待启动”

Workflow Integration

工作流集成

VS Code Setup

VS Code设置

  1. Pin the file: Right-click 
    ROADMAP.md
    → Pin tab
  2. Quick capture: Write 
    // TODO: xxx
    in code, transfer to Inbox later
  3. Pre-commit review: Check ROADMAP before 
    git commit
    , update status
  1. 固定文件：右键点击
    ROADMAP.md
    → 固定标签页
  2. 快速捕获：在代码中写入
    // TODO: xxx
    ，之后再转移到收件箱
  3. 提交前审核：
    git commit
    前检查ROADMAP，更新任务状态

Commit Hook Pattern

提交钩子模式

Before committing:
  1. Review what was completed
  2. Update 
    [ ]
    → 
    [x]
    for finished tasks
  3. Move completed items to "Done" section
  4. Add any new tasks discovered during work to Inbox
提交前：
  1. 回顾已完成的工作
  2. 将已完成任务的
    [ ]
    改为
    [x]
  3. 将已完成的条目移至“已完成”板块
  4. 将工作中发现的新任务添加至收件箱

Task Format Examples

任务格式示例

markdown
undefined
markdown
undefined

📥 Inbox

📥 收件箱

  • Consider adding payment gateway integration
  • Fix typo in user profile header
  • 考虑添加支付网关集成
  • 修复用户资料头部的拼写错误

🟢 Doing (Max 2-3)

🟢 进行中（最多2-3个）

  • #021 Refactor LLM interface layer (handling streaming output)
  • #021 重构LLM接口层（处理流式输出）

🟡 Next Up

🟡 待启动

  • [BUG] Fix API timeout on high concurrency (🔴 P0)
  • #018 Mobile layout adaptation (highest user demand)
  • #022 Integrate Gemini API
  • Add caching layer for frequently accessed data
  • [BUG] 修复高并发下的API超时问题（🔴 P0）
  • #018 移动端布局适配（用户需求最高）
  • #022 集成Gemini API
  • 为频繁访问的数据添加缓存层

⚪ Backlog

⚪ 待办储备

  • PDF export functionality
  • Multi-language i18n support
  • PDF导出功能
  • 多语言i18n支持

📔 Done

📔 已完成

  • v1.1.0 Initial framework setup
  • OpenAI API integration
undefined
  • v1.1.0 初始框架搭建
  • OpenAI API集成
undefined

Best Practices

最佳实践

  1. Keep Doing small: 2-3 items max. Finish before starting new work.
  2. Trust manual ordering: Don't second-guess priority placement. Top = most important.
  3. Weekly Inbox zero: Clear Inbox every week. Decide or delete.
  4. Delete aggressively: Backlog items untouched for 3+ months rarely matter.
  5. Context in parentheses: Add current status to "Doing" items.
  6. Bug triage: P0 bugs jump the queue. P1-P2 go to Backlog.
  1. 控制进行中任务数量：最多2-3个。完成现有任务再开始新工作。
  2. 信任手动排序：不要质疑优先级排列。顶部就是最重要的。
  3. 每周清空收件箱：每周清理收件箱，要么处理要么删除。
  4. 果断删除：待办储备中3个月以上未处理的条目几乎不重要。
  5. 括号添加上下文：为“进行中”的条目添加当前状态。
  6. 漏洞分类处理：P0漏洞插队。P1-P2漏洞移至待办储备。

Resources

资源

This skill includes:
assets/ROADMAP.md - Template file ready to copy to any project root
本技能包含：
assets/ROADMAP.md - 可直接复制到任何项目根目录的模板文件