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

添加新任务

Quick capture → Add to Inbox
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"

快速捕获 → 添加至收件箱
规划好的任务 → 直接添加至对应板块：
- 严重漏洞 → “待启动”顶部或插入“进行中”
- 常规功能 → “待启动”按优先级排序
- 未来想法 → “待办储备”

Prioritize Tasks

任务优先级设置

Manual reordering in "Next Up":

Cut the task line
Paste it in the new position
Top = highest priority, bottom = lowest

No calculation needed. Trust your judgment on what matters most.

在“待启动”中手动重新排序：

剪切任务行
粘贴到新位置
顶部=最高优先级，底部=最低优先级

无需计算，相信你对重要性的判断。

Move Task Status

移动任务状态

Starting work: Cut from "Next Up" → Paste into "Doing" Completing work: Change

[ ]

[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

每周清理

Review Inbox: promote or delete each item
Check Backlog: delete anything 3+ months old and untouched
Ensure "Doing" has max 2-3 items
Reorder "Next Up" based on current priorities

审核收件箱：升级或删除每个条目
检查待办储备：删除3个月以上未处理的条目
确保“进行中”最多有2-3个条目
根据当前优先级重新排序“待启动”

Workflow Integration

工作流集成

VS Code Setup

VS Code设置

Pin the file: Right-click
```
ROADMAP.md
```
→ Pin tab
Quick capture: Write
```
// TODO: xxx
```
in code, transfer to Inbox later
Pre-commit review: Check ROADMAP before
```
git commit
```
, update status

固定文件：右键点击
```
ROADMAP.md
```
→ 固定标签页
快速捕获：在代码中写入
```
// TODO: xxx
```
，之后再转移到收件箱
提交前审核：
```
git commit
```
前检查ROADMAP，更新任务状态

Commit Hook Pattern

提交钩子模式

Before committing:

Review what was completed
Update
```
[ ]
```
→
```
[x]
```
for finished tasks
Move completed items to "Done" section
Add any new tasks discovered during work to Inbox

提交前：

回顾已完成的工作
将已完成任务的
```
[ ]
```
改为
```
[x]
```
将已完成的条目移至“已完成”板块
将工作中发现的新任务添加至收件箱

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

最佳实践

Keep Doing small: 2-3 items max. Finish before starting new work.
Trust manual ordering: Don't second-guess priority placement. Top = most important.
Weekly Inbox zero: Clear Inbox every week. Decide or delete.
Delete aggressively: Backlog items untouched for 3+ months rarely matter.
Context in parentheses: Add current status to "Doing" items.
Bug triage: P0 bugs jump the queue. P1-P2 go to Backlog.

控制进行中任务数量：最多2-3个。完成现有任务再开始新工作。
信任手动排序：不要质疑优先级排列。顶部就是最重要的。
每周清空收件箱：每周清理收件箱，要么处理要么删除。
果断删除：待办储备中3个月以上未处理的条目几乎不重要。
括号添加上下文：为“进行中”的条目添加当前状态。
漏洞分类处理：P0漏洞插队。P1-P2漏洞移至待办储备。

Resources

资源

This skill includes:

assets/ROADMAP.md - Template file ready to copy to any project root

本技能包含：

assets/ROADMAP.md - 可直接复制到任何项目根目录的模板文件