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 解析--namename与--descriptiondesc分别设置项目名称与描述。初始化后命令会展示生成的项目结构并提示下一步建议解析 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.jsCLI 侧对应 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-complexityAI 分析任务复杂度并生成拆分建议/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-implementAI 自动实现任务含代码生成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 中以最少的心智负担完成从需求到交付的完整任务闭环。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考