面向人类与 AI Agent 的共享路线图工作区，通过 MCP Server 提供任务管理工具，附带本地看板与依赖图可视化。
Roadmap Skill 是一个本地优先的任务规划与依赖管理工具，核心特色在于人机共享上下文：AI Agent 通过 MCP 协议直接操作项目、任务、标签和依赖视图，人类通过 Web 看板和依赖图进行可视化编辑，两者实时同步。
主要能力包括：
- MCP Server：暴露 30 个公共工具，覆盖项目管理、任务 CRUD、标签系统、依赖视图分析与 Web 界面控制
- Kanban 看板：四列工作流（Todo → In Progress → Review → Done），支持拖拽、双模式显示、智能搜索
- 依赖图视图：基于 @xyflow/react + dagre + elkjs 的有向图可视化，支持依赖边编辑与 Ready/Blocked 信号显示，可导出为图片
- 依赖分析：通过 analyze_dependency_view 工具自动分析执行顺序、阻塞链和就绪任务
- 批量操作：支持任务和依赖视图节点的批量更新
- Skill Pack（Beta）：内置 quick-capture、auto-prioritize、suggest-tasks 等高级工作流技能
所有数据以纯 JSON 存储于用户本地目录（~/.roadmap-skill/），无账号、无云端同步、无供应商锁定。兼容 Claude Code、Cursor、Codex、OpenCode、VS Code 等主流 MCP 客户端。
架构概要：
- MCP Server 入口为 src/server.ts，分为 Tools / Resources / Prompts 三层
- Service Layer（src/services/）处理业务逻辑
- Storage Layer（src/storage/）基于本地 JSON 文件
- Web Workspace 基于 Express + React 19 + Vite，端口 7860，与 MCP Server 共享状态
数据模型：Project 拥有 Tasks、Tags、Milestones、DependencyViews；Task 属于 Project 并引用 Tags；DependencyView 引用 Tasks 并包含 Dependency Edges。
关键约定：所有 ID 为字符串；项目类型支持 roadmap / skill-tree / kanban；任务状态为 todo / in-progress / review / done；优先级为 low / medium / high / critical；多数工具默认返回精简摘要，传入 verbose: true 返回完整结构；日期格式 YYYY-MM-DD。
安装方式：npm install -g roadmap-skill 或 npx roadmap-skill，安装后可直接在 AI 对话中下达任务创建指令，Agent 将自动保存至本地存储。