Task Master 的 Claude Code 斜杠命令完整指南：`/project:tm/` 命令体系实战详解-平芜编程栈

Task Master 的 Claude Code 斜杠命令完整指南：`/project:tm/`命令体系实战详解

【免费下载链接】claude-task-masterAn AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-task-master

本文是 Task Master AI 任务管理系统在 Claude Code 中的完整使用指南，聚焦/project:tm/命名空间下的全部斜杠命令：从安装初始化、PRD 解析生成任务，到状态流转、复杂度分析与依赖管理，再到智能工作流与旧命令迁移。读完本文，你将掌握在 Claude Code 会话中通过自然语言驱动完整任务生命周期的实战方案，并理解这套命令体系与仓库源码（packages/claude-code-plugin/commands）之间的对应关系。

概述：Task Master 的`/project:tm/`命令体系

Task Master 的全部功能都可以通过 Claude Code 的斜杠命令（slash commands）以/project:tm/命名空间调用，并且内置了自然语言支持与智能特性。这套命令体系并非凭空设计，而是与 Task Master 的 CLI 命令一一对应的产物——仓库中的 CLI 实现位于 apps/cli/src/commands，其中包含list.command.ts、next.command.ts、set-status.command.ts、generate.command.ts、export.command.ts等 20 余个命令文件。

Claude Code 的斜杠命令以.md文件形式存放于.claude/commands/目录。从源码结构看，命令的分层组织与 Claude Code 的$ARGUMENTS参数注入机制相匹配：在 packages/tm-profiles/src/slash-commands/profiles/claude-profile.ts 中可以看到 Claude Code 命令文件的格式约定——第一行为描述，动态命令第二行写入Arguments: $ARGUMENTS，其后是命令正文，这解释了为什么下面的命令可以灵活接收自然语言参数。

命令结构

命令采用与 Task Master CLI 一致的分层组织方式：

主命令位于/project:tm/[command]；
子命令位于/project:tm/[command]/[subcommand]；
全程支持自然语言参数。

例如/project:tm/list是主命令，/project:tm/set-status/to-done是状态流转子命令，/project:tm/parse-prd/with-research是增强型 PRD 解析子命令。

快速开始

在 Claude Code 会话中依次输入以下命令即可完成从安装到开工的完整链路：

# 安装 Task Master /project:tm/setup/quick-install # 初始化项目 /project:tm/init/quick # 解析需求文档（PRD） /project:tm/parse-prd requirements.md # 开始工作：获取下一个推荐任务 /project:tm/next

其中init/quick对应 CLI 的快速初始化（带-y自动确认），parse-prd接受一个 Markdown 需求文档路径作为参数。仓库根目录提供了可直接试用的示例需求文档 assets/example_prd.txt 与 RPG 风格示例 assets/example_prd_rpg.txt。

完整命令参考

下面按功能域给出全部命令及其作用，这是对 TM_COMMANDS_GUIDE 命令表的完整展开，每条命令都对应仓库 packages/claude-code-plugin/commands 下的同名命令定义文件。

安装与配置（Setup & Configuration）

命令	作用
`/project:tm/setup/install`	完整安装指南，覆盖全局安装步骤
`/project:tm/setup/quick-install`	一行式快速安装（对应命令定义见 quick-install-taskmaster.md）
`/project:tm/init`	初始化项目（智能识别 PRD 文件，见 init-project.md）
`/project:tm/init/quick`	快速初始化，等效于带`-y`参数
`/project:tm/models`	查看当前 AI 模型配置
`/project:tm/models/setup`	交互式配置 AI 模型

init命令支持智能参数：传入quick或-y跳过所有确认；传入<file.md>会在初始化后自动执行 PRD 解析；--name=<name>与--description=<desc>分别设置项目名称与描述。初始化后命令会展示生成的项目结构，并提示下一步建议（解析 PRD、配置 AI 提供商、设置 git hooks、创建首批任务）。

任务生成（Task Generation）

命令	作用
`/project:tm/parse-prd`	从 PRD 需求文档生成任务（对应实现见 src/prompts/parse-prd.json 的提示词定义）
`/project:tm/parse-prd/with-research`	增强解析，先执行网络研究再生成任务
`/project:tm/generate`	从 tasks.json 生成独立的任务文件

parse-prd是 Task Master 的核心能力之一：读取需求文档后，由 AI 依据解析提示词模板将需求拆解为带依赖关系、状态与优先级的结构化任务，写入tasks.json。仓库的解析流程实现位于 scripts/modules/task-manager/parse-prd 目录，包含完整的 PRD 读取、解析与回退逻辑。

任务管理（Task Management）

命令	作用
`/project:tm/list`	列出任务，支持自然语言过滤
`/project:tm/list/with-subtasks`	树形层级视图，含子任务
`/project:tm/list/by-status <status>`	按状态过滤（pending / in-progress / done / review / deferred / cancelled）
`/project:tm/show <id>`	查看任务详情
`/project:tm/add-task`	创建新任务（带 AI 辅助）
`/project:tm/update`	更新任务，支持自然语言描述变更
`/project:tm/remove-task`	删除任务（带确认）

任务状态常量定义在 src/constants/task-status.js，CLI 侧对应 apps/cli/src/commands/list.command.ts 与 apps/cli/src/commands/show.command.ts。

状态管理（Status Management）

命令	作用
`/project:tm/set-status/to-pending <id>`	将任务重置为待处理
`/project:tm/set-status/to-in-progress <id>`	开始任务
`/project:tm/set-status/to-done <id>`	标记任务完成
`/project:tm/set-status/to-review <id>`	提交审查
`/project:tm/set-status/to-deferred <id>`	推迟任务
`/project:tm/set-status/to-cancelled <id>`	取消任务

六种状态覆盖了任务从待处理到完成/取消的完整生命周期。状态流转的 CLI 实现位于 apps/cli/src/commands/set-status.command.ts，命令会校验任务 ID 与目标状态的合法性。

任务分析（Task Analysis）

命令	作用
`/project:tm/analyze-complexity`	AI 分析任务复杂度并生成拆分建议
`/project:tm/complexity-report`	查看复杂度分析报告
`/project:tm/expand <id>`	将指定任务拆解为子任务
`/project:tm/expand/all`	批量展开所有复杂任务

复杂度分析依据任务描述长度、依赖数量、子任务数量等信号为任务打分，报告会输出到task-complexity-report.json（仓库根目录即有一份样例 task-complexity-report.json）。展开任务的提示词模板定义在 src/prompts/expand-task.json。

依赖管理（Dependencies）

命令	作用
`/project:tm/add-dependency`	添加任务依赖
`/project:tm/remove-dependency`	移除任务依赖
`/project:tm/validate-dependencies`	检查依赖问题（循环依赖、悬空引用等）
`/project:tm/fix-dependencies`	自动修复依赖问题

依赖管理底层由 scripts/modules/dependency-manager.js 实现，支持检测循环依赖、补充缺失的逆向依赖（reverse dependency），保证next等命令给出的推荐任务永远处于可执行状态。跨 tag 移动任务时的依赖一致性处理可参考 docs/cross-tag-task-movement.md。

工作流（Workflows）

命令	作用
`/project:tm/workflows/smart-flow`	自适应工作流，根据项目状态选择流程
`/project:tm/workflows/pipeline`	命令链编排，串联多个命令
`/project:tm/workflows/auto-implement`	AI 自动实现任务（含代码生成）

smart-flow是这套体系中智能化程度最高的命令：它会分析最近执行过的命令、当前任务状态、时段/星期与你的工作模式，从而选择最合适的流程。命令定义 smart-workflow.md 中描述了典型的模式识别逻辑：

上次命令是status→ 判定为开始工作 → 运行每日站会流程；
上次命令是complete→ 任务完成 → 查找下一个任务；
上次命令是list pending→ 处于规划期 → 建议冲刺（Sprint）规划；
上次命令是expand→ 正在拆解工作 → 展示复杂度分析；
无近期命令且是早晨 → 每日站会；大量待办 → 冲刺规划；存在阻塞任务 → 依赖解决流程。

工具（Utilities）

命令	作用
`/project:tm/status`	项目仪表盘，总览全部任务状态
`/project:tm/next`	智能推荐下一个任务
`/project:tm/utils/analyze`	深度项目分析与洞察
`/project:tm/learn`	交互式帮助与命令学习

next命令（见 next-task.md）会综合当前任务状态、近期活动、时间约束、依赖关系和工作模式做决策树判断：若存在进行中任务，检查是否闲置超过 2 小时（建议恢复或切换）、是否接近完成（展示剩余步骤）、是否被阻塞（寻找替代任务）；若没有进行中任务，则按"无阻塞高优先级 → 需拆解的复杂任务 → 全部阻塞时的依赖解决"的优先级给出建议。它还支持特殊参数：quick（找 2 小时内的任务）、easy（低复杂度）、important（高优先级）、continue（恢复上次任务）。

关键特性

自然语言支持

所有命令都能理解自然语言，无需记忆参数语法：

/project:tm/list pending high priority /project:tm/update mark 23 as done /project:tm/add-task implement OAuth login

从源码结构看，这种自然语言能力由两部分支撑：Claude Code 侧通过$ARGUMENTS占位符将用户输入注入命令模板（见 claude-profile.ts 的格式构建逻辑），Task Master 侧则由 LLM 负责将自然语言映射为结构化的操作参数。

智能上下文

命令会分析项目当前状态，并基于以下维度提供智能建议：

当前任务状态（active / in-progress / blocked）；
任务依赖关系；
团队协作模式；
项目所处阶段。

例如next会根据"进行中任务是否闲置过久""是否存在阻塞任务"给出不同建议；smart-flow会根据上次命令与时段选择工作流。

视觉增强

所有命令的输出都经过组织化排版，包括：

进度条与状态指示器（实现见 src/ui/indicators.js）；
状态徽章（badge）；
清晰的层级化任务展示。

CLI 侧的表单渲染逻辑位于 apps/cli/src/ui/formatters 与 apps/cli/src/ui/components，控制台输出的颜色、图标与表格布局均由此生成。

常见工作流

每日开发（Daily Development）

/project:tm/workflows/smart-flow morning /project:tm/next /project:tm/set-status/to-in-progress <id> /project:tm/set-status/to-done <id>

早晨用smart-flow morning进入站会流程，next拿到推荐任务，标记进行中开始编码，完成后流转为 done。这条链路覆盖了"规划 → 领取 → 执行 → 交付"的最小闭环。

任务拆解（Task Breakdown）

/project:tm/show <id> /project:tm/expand <id> /project:tm/list/with-subtasks

先查看任务详情确认边界，再拆解为子任务，最后用层级视图检查拆分结果是否合理。

冲刺规划（Sprint Planning）

/project:tm/analyze-complexity /project:tm/workflows/pipeline init → expand/all → status

先做全量复杂度分析识别高风险任务，再用pipeline将"初始化 → 批量展开 → 状态总览"三个命令串联为自动化命令链，一次性完成冲刺初期的准备工作。

旧命令迁移对照表

如果此前使用过旧版命名空间（/project:task-master:或/project:workflows:），可按下表迁移：

旧命令	新命令
`/project:task-master:list`	`/project:tm/list`
`/project:task-master:complete`	`/project:tm/set-status/to-done`
`/project:workflows:auto-implement`	`/project:tm/workflows/auto-implement`

新命名空间将原本分散在task-master与workflows两个前缀下的命令统一收敛到/project:tm/之下，命名也改为动词化的语义层级（如set-status/to-done），更贴近 CLI 结构。仓库中迁移前的旧式命令文件仍保留在 packages/claude-code-plugin/commands 中（如to-done.md、command-pipeline.md、auto-implement-tasks.md），可作为对照参考。

使用技巧

用/project:tm/+ Tab 做命令发现：Claude Code 会补全并列出该命名空间下的全部子命令；
自然语言随处可用：过滤、更新、新增任务都可直接用口语化描述；
善用智能默认值：大多数命令会基于上下文给出合理的默认参数；
用命令链实现自动化：通过pipeline把重复的例行操作固化为一键流程；
遇到困惑时输入/project:tm/learn：获取交互式帮助。

命令体系与源码的对应关系

这套/project:tm/命令体系在仓库中有完整的实现支撑，可按需深入阅读：

命令定义：packages/claude-code-plugin/commands 存放 70+ 个命令的 Markdown 模板（含智能逻辑提示词），例如 smart-workflow.md、next-task.md、command-pipeline.md；
命令生成机制：packages/tm-profiles/src/slash-commands/profiles/claude-profile.ts 展示了 Claude Code 命令文件（.claude/commands/*.md）的格式构建逻辑，包括描述首行与$ARGUMENTS注入；
CLI 底层实现：apps/cli/src/commands 是各命令的实际执行逻辑，斜杠命令最终映射到这些 CLI 模块；
MCP 集成：packages/claude-code-plugin/mcp.json 声明了task-master-aiMCP 服务器（stdio 类型，通过npx -y task-master-ai启动），可在 Claude Code 中以工具方式调用同一套任务管理能力。

从整体架构看，/project:tm/斜杠命令、task-master-aiMCP 服务器与原生 CLI 三者在底层共享同一套 scripts/modules 任务管理逻辑，只是暴露给 AI 编程助手的交互入口不同——这正是"同一任务系统、多种驱动方式"的设计体现。掌握了本文的斜杠命令体系，即可在 Claude Code 中以最少的心智负担完成从需求到交付的完整任务闭环。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Task Master 的 Claude Code 斜杠命令完整指南：`/project:tm/` 命令体系实战详解