Task Master Smart Workflow 智能工作流命令：让 Claude Code 依据上下文自动编排任务流程

本篇技术指南围绕 claude-task-master 项目中 Claude Code 插件（packages/claude-code-plugin）提供的 smart-workflow（智能工作流）命令展开，讲解它如何综合最近执行过的命令、当前任务状态、时间信息与个人工作习惯，自动判断"此刻最该做什么"，并编排出一条可执行的命令链路。读完本文，你将掌握该命令的决策机制、四步编排流程、学习模式，以及它与 command-pipeline、next-task、project-status 等周边命令的协作方式，并能在日常开发中直接落地使用。

命令概览：一条命令启动一天的开发节奏

smart-workflow 是 Task Master 在 Claude Code 中提供的工作流类命令之一。它的定位不是执行某个单一操作，而是"根据当前项目状态和最近命令，执行一条智能工作流"（Execute an intelligent workflow based on current project state and recent commands）。

在 Claude Code 中通过斜杠命令触发：

/taskmaster:smart-workflow
/taskmaster:smart-workflow [context]

第二个形式中的 [context] 是可选参数——你可以直接附加一段上下文描述，例如 just finished the auth module 或 morning kickoff，命令会将其纳入决策输入。

在命令参考（packages/claude-code-plugin/commands/tm-main.md）中，smart-workflow 被归类在 "Workflows & Automation"（工作流与自动化）分类下，与 command-pipeline（命令链）和 auto-implement-tasks（自动实现任务）并列，定位为"Context-aware intelligent workflow execution"（上下文感知的智能工作流执行）。

四维上下文分析：命令在"读"什么

命令启动后，会从四个维度收集信息来构建对当前处境的理解：

1. 最近执行过的命令（Recent commands you've run）——判断你刚刚做了什么，正处于工作流的哪个阶段；
2. 当前项目状态（Current project state）——任务清单、各任务的状态分布；
3. 时间信息（Time of day / day of week）——一天中的时段与星期几，用于推断工作节奏；
4. 你的工作模式（Your working patterns）——长期积累的个人习惯。

对应的上下文分析要点包括：

• 上一条执行的命令是什么（Previous command executed）
• 当前各任务的状态（Current task states）
• 上次会话遗留的未完成工作（Unfinished work from last session）
• 你典型的工作模式（Your typical patterns）

这些信息共同构成"决策输入"。从源码结构看，该命令本身并不维护本地状态，而是把决策权交给大模型——命令内容通过 $ARGUMENTS 占位符把用户输入注入提示词，由模型基于仓库可观察到的实际状态进行推断。其 TS 实现位于 packages/tm-profiles/src/slash-commands/commands/common/smart-workflow.ts，被导出并在 common/index.ts 的 Workflows 分组中注册为 smartWorkflow。

智能执行规则：上一条命令决定下一步

命令文档给出了明确的"上一命令 → 推断意图 → 推荐工作流"映射表，这是整个智能选择的骨架：

上一条命令	推断的意图	推荐工作流
status（查看状态）	可能刚开始工作	运行每日站会（daily standup）
complete（完成任务）	任务刚完成	寻找下一个任务（find next task）
list pending（列出待办）	处于规划阶段	建议冲刺规划（sprint planning）
expand（任务拆解）	正在拆分工作	展示复杂度分析（complexity analysis）
init（初始化项目）	新项目	展示上手引导流程（onboarding workflow）

例如：你刚执行完 status 查看项目整体进度，接着调用 smart-workflow，命令会判定你"正准备开始干活"，于是自动拉起站会式的工作流——汇总在办事项、阻塞项与今日优先级；而如果你刚 complete 了一个任务，命令会倾向于直接帮你找到下一个可接手的任务。

无最近命令时的启发式决策：时间与状态的组合判断

如果没有可参考的最近命令记录，命令退回到基于"时间 + 项目状态"的启发式判断：

• 早上（Morning） → 每日站会工作流（Daily standup workflow）
• 大量待办任务（Many pending tasks） → 冲刺规划（Sprint planning）
• 任务被阻塞（Tasks blocked） → 依赖解析（Dependency resolution）
• 周五（Friday） → 周回顾（Weekly review）

这套规则体现了命令的设计意图：把"节奏感"编码进决策。早晨适合对齐目标，任务堆积时适合做规划，出现阻塞时优先解依赖，周五则做收尾回顾。配合前文"上一命令"的映射，两条决策路径共同覆盖了"有明确上下文"和"无明确上下文"两种场景。

工作流编排四步法

确定主工作流后，命令按以下四个步骤将其组合落地：

1. 分析当前状态（Analyze current state）——先摸清任务清单、状态分布与阻塞点；
2. 执行主工作流（Execute primary workflow）——执行上一步选定的站会 / 规划 / 依赖解析等主流程；
3. 建议后续动作（Suggest follow-up actions）——给出可执行的下一步建议；
4. 为编码做好准备（Prepare environment for coding）——把环境调整到适合立即开工的状态。

这种"先诊断、再执行、后建议、终就绪"的编排顺序，与仓库中 next-task 命令的"准备工作流"理念一脉相承：next-task 在选定任务后同样会展示完整上下文与历史、设置开发环境、运行相关测试、打开相关文件并估算完成时间（见 packages/claude-code-plugin/commands/next-task.md）。smart-workflow 把这一整套"从决策到实现零摩擦"（Zero friction from decision to implementation）的思路提升到了流程级别。

学习模式：命令如何越用越懂你

smart-workflow 的一个重要特性是学习模式（Learning Mode），它会从你的使用行为中持续积累偏好：

• 追踪命令序列（Track command sequences）
• 记录时间偏好（Note time preferences）
• 记住常用工作流（Remember common workflows）
• 适配你的个人风格（Adapt to your style）

文档给出了三类被检测到的典型流程示例：

• 早上：standup → next → start（站会 → 找下一个任务 → 开工）
• 午饭后：status → continue task（查看状态 → 继续手头任务）
• 一天结束：complete → commit → status（完成任务 → 提交 → 收尾状态）

也就是说，命令通过观察你在不同时段反复出现的命令组合，逐步建立"你的一天如何展开"的画像，从而在相似时刻给出更贴合你习惯的建议。

源码实现：一个带参数校验的动态命令

smart-workflow 的实现并不复杂，但它的注册方式体现了 tm-profiles 包中命令工厂的设计约束。在 smart-workflow.ts 中：

export const smartWorkflow = dynamicCommand(
	'smart-workflow',
	'Smart Workflow',
	'[context]',
	`Execute an intelligent workflow based on current project state and recent commands.
...
Arguments: $ARGUMENTS
...`
);

它使用 dynamicCommand 工厂创建。查看工厂实现（packages/tm-profiles/src/slash-commands/factories.ts）可以发现一个硬性约束：

export function dynamicCommand(
	name: string,
	description: string,
	argumentHint: string,
	content: string,
	mode?: OperatingMode
): DynamicSlashCommand {
	if (!content.includes('$ARGUMENTS')) {
		throw new Error(
			`Dynamic slash command "${name}" must contain $ARGUMENTS placeholder`
		);
	}
	// ...
}

动态命令的内容必须包含 $ARGUMENTS 占位符，否则工厂会直接抛错。这正是 smart-workflow 内容中 Arguments: $ARGUMENTS 这一行的由来——它负责把用户输入的上下文参数注入命令提示词。工厂还会返回 argumentHint: '[context]' 作为参数提示，帮助用户了解该命令期望的输入形态。这类命令属于"提示词驱动的动态命令"：真正的智能决策由大模型依据注入的提示与仓库实际状态完成，而非硬编码的分支逻辑。

与周边命令的协作：组成完整的自动化闭环

smart-workflow 并不是孤立存在的，它与 Workflows 分类下的其他命令协同，构成一套完整的自动化体系：

• command-pipeline：以显式语法链式执行多条命令，支持条件分支（if:pending>10）、循环（for:pending-tasks）、变量传递与错误处理（try:catch、retry:3）等（见 packages/claude-code-plugin/commands/command-pipeline.md）。当 smart-workflow 判断出"应该做冲刺规划"时，规划的具体执行往往由这类管道式命令落地；
• project-status：提供项目仪表盘与智能洞察，包括闲置任务、瓶颈、预测性分析（见 packages/claude-code-plugin/commands/project-status.md），是站会工作流的数据基础；
• next-task：负责"找下一个任务"环节，并自带 quick（2 小时内）、easy（低复杂度）、important（高优先级）、continue（继续上次任务）等快捷参数；
• auto-implement-tasks：实现层命令，负责代码生成、测试与质量保障，是工作流最终"落地到编码"的出口（见 packages/claude-code-plugin/commands/auto-implement-tasks.md）。

命令的"帮助"文档（packages/claude-code-plugin/commands/help.md）给出的上手路径也能印证这一闭环：安装（quick-install-taskmaster）→ 初始化（init-project-quick）→ 学习（learn）→ 工作（smart-workflow），即 smart-workflow 被定位为日常工作的主入口。

落地使用：从安装到日常闭环

要在 Claude Code 中实际使用该命令，完整的路径如下：

1. 安装 Task Master：执行 /taskmaster:quick-install-taskmaster 完成一行式全局安装，或 /taskmaster:install-taskmaster 查看完整安装指南；
2. 初始化项目：执行 /taskmaster:init-project-quick（自动确认模式）或 /taskmaster:init-project，让项目生成任务清单；
3. 熟悉命令体系：执行 /taskmaster:tm-main 查看完整命令参考，或用 /taskmaster:learn 进行交互式学习；命令支持自然语言参数与 ID 参数，例如 /taskmaster:show 45、/taskmaster:update mark all API tasks as high priority；
4. 启动智能工作流：在任意工作节点执行 /taskmaster:smart-workflow（可附带 [context]），命令将依据上文所述的规则选择工作流并编排执行；
5. 深化自动化：将 smart-workflow 与 command-pipeline 结合，把判断出的工作流固化为可复用的管道。

需要说明的是：smart-workflow 的决策依赖大模型对当前仓库状态的实时理解，其"学习模式"所积累的模式来自对话上下文中可观察到的命令使用序列，而非独立的持久化存储文件；命令的提示词内容同时存在于 Claude Code 插件命令文档（smart-workflow.md）与 tm-profiles 的 TS 注册实现（smart-workflow.ts）中，二者保持一致，这也意味着该命令可被不同编辑器 / Agent 配置复用。

小结

smart-workflow 的价值在于把"什么时候该做什么"这件事从人的脑中解放出来：它读取最近命令、任务状态、时间与个人习惯四类上下文，依据清晰的决策规则选择站会、冲刺规划、依赖解析或周回顾等主工作流，再通过"分析 → 执行 → 建议 → 就绪"四步编排落地，并借助学习模式持续适配个人节奏。结合 command-pipeline、next-task、project-status 与 auto-implement-tasks，它构成了 claude-task-master 中"自动判断 → 自动编排 → 自动执行"的完整日常开发闭环。