Roadmap Skill

路线图技能

The local planning workspace: status in Kanban, execution order in Graph View.

Shared roadmap for humans and AI Agents

Visual kanban and graph views for you. MCP server for Agents. Local-first.

简体中文 | English

AI可读文档： llms.txt · llms-full.txt · Architecture · Tool Interface Standard

______________________________________________________________________

是什么让它与众不同

共享上下文 --与您的代理聊天以计划任务，或直接在看板中编辑——两者保持同步。你的代理人总是看到最新的状态。

本地代理 --作为MCP服务器构建。你的人工智能可以在对话中直接创建、更新和查询任务。

可视化工作空间 --打开 localhost:7860 当你想打开它时，或者让你的代理人打开它 open_web_interface.看板用于显示状态，图形视图用于排序。或者只是继续聊天。这三个工作。

本地优先 --您的数据存储在您的机器上。没有帐户，没有云同步，没有供应商锁定。

______________________________________________________________________

v0.3.0中的新功能：图形视图

图形视图是 v0.3.0.

Graph View turns roadmap tasks into a dependency map, so you can inspect order, blockers, and ready work at a glance.

看板非常适合跟踪状态。图形视图用于理解执行顺序。

它可以帮助您和您的代理人回答以下问题：

• 首先必须发生什么？
• 哪些任务现在准备好了？
• 未完成的工作会阻碍什么？
• 应该添加、反转或删除哪种依赖关系？

图形视图将路线图任务转化为一个可视化的依赖关系图，其中包含节点连接、就绪/完成状态、详细的任务卡和导出支持，而不是将其视为一个平面列表。它专为计划会议而设计，在这些会议中，顺序与状态同样重要。

如果您将Roadmap Skill用作MCP工作区，这是使代理辅助规划感觉具体的视图：您的代理可以在聊天中构建和更新依赖关系图，您可以在web UI中立即直观地检查结构。

______________________________________________________________________

快速启动（零配置）

# Integrate with your AI assistant (MCP config below)

View platform configurations

Claude Code

claude mcp add roadmap "npx -y roadmap-skill"

Claude Desktop

{
  "mcpServers": {
    "roadmap": {
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

Copilot

/mcp add

或编辑 ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "roadmap": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

Cursor

{
  "mcpServers": {
    "roadmap": {
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

JetBrains (via Cline)

安装Cline插件，然后添加到 cline_mcp_settings.json:

{
  "mcpServers": {
    "roadmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

Roo Code

{
  "mcpServers": {
    "roadmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

Opencode

编辑 ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "roadmap": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "roadmap-skill"
      ],
      "enabled": true
    }
  }
}

Trae

首选 Settings -> MCP -> Add new MCP Server:

{
  "mcpServers": {
    "roadmap": {
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

VS Code

{
  "mcp": {
    "servers": {
      "roadmap": {
        "command": "npx",
        "args": ["-y", "roadmap-skill"]
      }
    }
  }
}

Windsurf

遵循Windsurf MCP文档并使用：

{
  "mcpServers": {
    "roadmap": {
      "command": "npx",
      "args": ["-y", "roadmap-skill"]
    }
  }
}

Zed

{
  "context_servers": {
    "roadmap": {
      "command": {
        "path": "npx",
        "args": ["-y", "roadmap-skill"]
      }
    }
  }
}

Codex CLI / Codex IDE

一个衬垫（推荐）：

codex mcp add roadmap -- npx -y roadmap-skill

手动配置 --编辑 ~/.codex/config.toml:

[mcp_servers.roadmap]
command = "npx"
args = ["-y", "roadmap-skill"]

视窗：没有 cmd /c 需要包装器——Codex直接处理子流程。

服务器名称：必须匹配 ^[a-zA-Z0-9_-]+$。带有空格或括号的名称将被拒绝。

备注：Codex CLI和Codex VSCode扩展共享相同的内容 ~/.codex/config.toml。语法错误会破坏两者。

设置后，只需告诉您的AI：

创建一个网站重新设计项目，包括主页、关于页面和联系表单的任务

AI将立即创建项目和任务，并将其保存到本地存储中。你可以打开 随时查看可视化看板。

______________________________________________________________________

代理技能

此存储库包括以下可安装技能 skills/，通过git存储库而不是已发布的npm包分发。

可用技能：

• skills/roadmap/ -轻量级背景和路线图技能
• skills/roadmap-task-flow/ -捕获、丰富、标记和优先排序路线图任务
• skills/roadmap-planning-views/ -从任务子集构建有重点的计划图
• skills/roadmap-web-visualization/ -打开并使用本地路线图web工作区

技能意识工具的推荐安装模式：

# install from the git repository when the installer supports repo sources
npx skills add shiquda/roadmap-skill

这些技能仍处于测试阶段。如果你遇到问题或有建议，我们非常欢迎你的反馈。

______________________________________________________________________

这是给谁的？

独立开发人员、人工智能高级用户和vibe程序员，他们希望自己的Agent成为真正的合作者，而不仅仅是代码生成器。

______________________________________________________________________

典型使用案例

1.在不中断流程的情况下捕捉想法

在会议进行到一半时，你的脑海中突然浮现出一些东西：

“请注意：将身份验证模块切换到JWT+刷新令牌轮换”

使用 /quick-capture 或者只是说“帮我记下来”——你的代理人把它变成一个任务，保存在本地，然后你继续做下去。没有上下文转换，没有被遗忘的想法。

2.让代理帮助您确定优先级

“本月的OKR正在完成用户系统重构——你能列出相关任务并找出哪些任务应该放在首位吗？”

使用 /auto-prioritize 让您的代理分析当前项目状态并相应地重新排序任务优先级。

3.让客服推荐下一步要做什么

“当前项目还剩下什么？我还没有处理过任何高优先级的任务吗？”

或使用 /suggest-tasks --您的代理根据当前进度和优先级建议下一步行动。

无标签切换。无复制粘贴。尽管问

核心功能

______________________________________________________________________

支持的平台

• ✅ 克劳德代码、Codex、OpenCode --命令行AI助手
• ✅ 光标，VS代码 --AI驱动的IDE
• ✅ 任何MCP客户端 --标准MCP协议支持

______________________________________________________________________

数据存储

路线图技能使用 纯本地JSON文件存储。所有数据都保存在您的用户目录中：

您可以从web界面导出或导入备份文件。

______________________________________________________________________

许可证

MIT© 石曲达

______________________________________________________________________

If this project helps you, please consider giving it a star!