Terminal-first project bootstrapper and workspace context manager. Use when the user asks for /project-style workflows: detect current project, read project context/brief, run standardized targets (build/test/lint/deploy), init a .project bundle via plan/apply, manage artifacts, or expose these actions via MCP server mcp-project-router and CLI project.
数据来源:ClawHub。 在 ClawSkills 查看
选择你使用的 Agent
方法一:命令行安装(推荐)
推荐(无需提前安装 clawhub)
npx clawhub@latest --dir ~/.claude/skills install project-router或使用 clawhub CLI(需提前安装)
clawhub --dir ~/.claude/skills install project-router⚠️ 需要 Node.js 18+,没有 Node?请使用下方方法二直接下载 ZIP。 安装 Node.js →
方法二:手动下载安装(无需 Node)
下载 ZIP,解压后将文件夹放到以下路径,重启 Agent 即可:
安装路径
~/.claude/skills/project-router/💡解压后将文件夹放到上方路径,重启 Agent 即可生效
--- name: project-router description: "Terminal-first project bootstrapper and workspace context manager. Use when the user asks for /project-style workflows: detect current project, read project context/brief, run standardized targets (build/test/lint/deploy), init a .project bundle via plan/apply, manage artifacts, or expose these actions via MCP server mcp-project-router and CLI project." ---
This skill is Safa’s canonical project management + context switching control plane.
Core idea:
It provides:
project ... mcp-project-router (tools mirror the CLI).project/ (brief, targets, artifact index)The .project/ bundle is the project-local context nucleus. The canonical PM DB points at these bundles.
Inside a project root:
.project/project.json — structured manifest.project/PROJECT.md — living brief.project/targets.json — target definitions (commands).project/index/artifacts.json — artifact index.project/history/plans/*.json — plans.project/history/applies/*.json — apply receiptsFrom anywhere inside a repo/workspace:
project detectproject contextproject target listproject target run Initialize a bundle (dry-run plan + apply):
project init (prints plan)project apply Artifacts:
project artifact add [--tags a,b,c] (plan + apply)> Note: these verbs are the target UX. Implementations should remain idempotent and safe.
Project registration:
project pm project add --name "..." --root project pm project listTask management:
project pm task add "" --priority P0|P1|P2|P3 [--status inbox|next|doing|blocked|waiting|done] project pm task list [--project ] [--status ...] project pm task set-status Context switching:
project pm switch - prints pinned docs + top targets + active tasks
project pm focus - loads task-linked files/artifacts and updates the task activity log
Trello sync:
project pm trello sync [--project ] - ensures the single "Safa — PM" Trello board exists - ensures lists exist (Inbox/Next/Doing/Blocked/Waiting/Done) - upserts cards for canonical tasks - moves cards to match status - applies priority labels (P0..P3)
mcporter list mcp-project-router --schema --timeout 120000 --jsonExamples:
- mcporter call --server mcp-project-router --tool project_detect --args '{}'
- mcporter call --server mcp-project-router --tool project_context_read --args '{}'
- mcporter call --server mcp-project-router --tool project_target_run --args '{"target":"test"}'
Single-board setup:
Safa — PM (or configurable) - Inbox, Next, Doing, Blocked, Waiting, Done
[] ```yaml --- pm --- task_id:
- P0 = red - P1 = orange - P2 = yellow - P3 = blue
Recommended DB location (in workspace):
/home/safa/clawd/data/pm/pm.sqliteMinimum tables (v0):
projects(slug PRIMARY KEY, name, root_path, created_at, updated_at)tasks(task_id PRIMARY KEY, project_slug, title, status, priority, created_at, updated_at)task_refs(task_id, kind, ref) (file paths / urls / artifacts)external_refs(task_id, system, external_id, meta_json) (e.g., Trello card_id/list_id)task_id marker; never duplicate cards).project_target_run executes commands defined in .project/targets.json.安装 Project Router 后,可以对 AI 说这些话来触发它
Help me get started with Project Router
Explains what Project Router does, walks through the setup, and runs a quick demo based on your current project
Use Project Router to terminal-first project bootstrapper and workspace context manager
Invokes Project Router with the right parameters and returns the result directly in the conversation
What can I do with Project Router in my developer & devops workflow?
Lists the top use cases for Project Router, with example commands for each scenario
将技能文件夹放到 ~/.claude/skills/project-router/ 目录(个人级,所有项目可用),或 .claude/skills/project-router/(项目级)。重启 AI 客户端后,用 /project-router 主动调用,或让 AI 根据上下文自动发现并使用。
Project Router 支持 Claude、Cursor、OpenClaw,可与这些 AI 平台无缝集成,扩展其能力。
Project Router 可免费安装使用。请查阅仓库了解许可证信息。
Terminal-first project bootstrapper and workspace context manager. Use when the user asks for /project-style workflows: detect current project, read project context/brief, run standardized targets (build/test/lint/deploy), init a .project bundle via plan/apply, manage artifacts, or expose these actions via MCP server mcp-project-router and CLI project.
Project Router 属于「Developer & DevOps」分类,该分类的技能帮助 AI 智能体在此领域执行专业任务。
Automate my developer & devops tasks using Project Router
Identifies repetitive steps in your workflow and sets up Project Router to handle them automatically