Task Master 的 parse-prd 命令从 PRD 文档到结构化开发任务的智能解析指南【免费下载链接】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-masterParse PRD 是 Task Master 项目中最核心的“需求转任务”能力它读取一份产品需求文档PRD交给 AI 模型分析后自动生成一份带编号、依赖关系、优先级与验收策略的结构化任务清单。本文基于 parse-prd.md 展开结合 parse-prd.js、parse-prd.json、commands.js 等源码完整讲解命令用法、解析流程、参数选项、底层实现原理与后续扩展工作流读完即可在自己的项目中用一份 PRD 快速落地可执行的任务看板。命令概述与基本用法parse-prd接受一个必选参数PRD 文件路径支持.txt、.md等纯文本格式。其核心定位是分析你的需求文档并生成完整的任务拆解Analyzes your requirements document and generates a complete task breakdown。最基础的一条命令task-master parse-prd --input$ARGUMENTS其中$ARGUMENTS即 PRD 文件路径。也可以使用位置参数直接传入task-master parse-prd requirements.txt从 commands.js 可以看到该命令通过programInstance.command(parse-prd)注册PRD 路径的解析逻辑为options.input || file即--input选项优先于位置参数。执行时会先初始化 TaskMasterinitTaskMaster随后调用底层parsePRD函数完成解析。智能解析流程parse-prd的解析过程分为三个阶段每一阶段都有对应的源码实现支撑。1. 文档分析Document AnalysisAI 模型对 PRD 内容进行四方面的分析提取关键需求Extract key requirements识别产品必须交付的核心功能点识别技术组件Identify technical components判断实现所需的技术栈、模块与组件检测依赖关系Detect dependencies梳理功能之间的先后顺序与耦合关系评估复杂度Estimate complexity据此决定任务拆分粒度。在实现层面readPrdContent见 parse-prd-helpers.js会同步读取 PRD 文件并校验内容非空空文件会抛出Input file ... is empty or could not be read错误。随后 buildPrompts 调用promptManager.loadPrompt(parse-prd, ...)将 parse-prd.json 中定义的 Handlebars 模板渲染成发给模型的 system/user 提示词。2. 任务生成Task Generation模型按提示词约束输出 JSON 格式的任务数组默认生成10–15 个任务具体数量受--num-tasks影响且保证包含实现类任务implementation tasks补充测试类任务testing tasks覆盖文档类任务documentation tasks为任务设置逻辑依赖logical dependencies。提示词中的输出 JSON 结构见 parse-prd.json每个任务对象包含{ id: 1, title: 任务标题, description: 任务描述, status: pending, dependencies: [], priority: medium, details: 实现细节, testStrategy: 验证方案 }服务端返回后processTasks 会执行两遍处理第一遍将 AI 返回的相对 ID 重映射为从nextId即已有任务最大 ID 1开始的连续 ID并为status、priority、dependencies、subtasks等字段补默认值第二遍将dependencies中的旧 ID 映射为新 ID并过滤掉“指向自身或更高 ID”的非法依赖依赖只能指向更小 ID 的任务。同时 validateSequentialTaskIds 会在运行时校验 AI 返回的 ID 必须是从 1 开始的连续正整数序列从源头杜绝脏数据写入tasks.json。3. 智能增强Smart Enhancements功能分组Group related functionality将相近需求聚合为原子任务优先级设置Set appropriate priorities按关键程度与依赖顺序分配high/medium/low默认值为medium验收标准Add acceptance criteria写入testStrategy字段测试策略Include test strategies每个任务都附带可执行的验证方案。提示词中的 11 条 Guideline见 parse-prd.json进一步约束任务必须原子化、按依赖与实现顺序排序、早期任务先做基础搭建与核心功能、优先级基于关键性和依赖顺序、PRD 中明确的技术栈/数据库/框架要求必须严格保留不得丢弃。选项参数详解parse-prd支持多个修饰参数除了文档中提到的三种快捷写法CLI 还提供完整的命名选项见 commands.js。参数数量数字后缀 →--num-tasks参数说明-n, --num-tasks number生成任务的数量默认值由getDefaultNumTasks()决定默认为 10文件名后直接跟数字task-master parse-prd requirements.txt 15等价于--num-tasks 15显式写法task-master parse-prd requirements.txt --num-tasks 15设为0时让模型根据 PRD 复杂度自行决定任务数量MCP 工具parse_prd的numTasks参数明确支持该行为见 parse-prd.js建议不要超过 50避免超出模型上下文窗口。研究模式research→--research-r, --research启用研究模式文档原话为使用 Perplexity AI 提供“research-backed”的任务生成。在提示词层面见 parse-prd.json 的{{#if research}}分支模型在拆解任务前会先完成六步动作调研适用于该项目的最新技术栈、库、框架与最佳实践识别 PRD 中未明说的技术挑战、安全隐患与扩展性问题结合行业标准与趋势旨在缓解 LLM 因训练数据截止导致的信息过期与幻觉评估多种实现路径并推荐最直接的方案给出具体的库版本、API 与落地指引始终坚持最直接实现路径避免过度工程。task-master parse-prd requirements.txt --research注意--research需要配置对应的 AI API Key且会显著增加 token 消耗。全面模式comprehensive→ 生成更多任务文档中的comprehensive修饰符用于请求生成更全面、更多的任务对应到提示词层面即numTasks数值偏大时模型会“除非复杂度需要更多否则恰好生成 N 个任务”见 parse-prd.json Guideline 1。其他 CLI 选项选项说明-i, --input filePRD 文件路径优先于位置参数-o, --output file输出文件路径默认tasks.json-f, --force跳过覆盖确认直接覆盖已有任务--append追加到已有任务而不是覆盖--tag tag指定任务操作的 tag 上下文默认master覆盖保护机制当目标 tag 中已存在任务时若未加--force或--appendCLI 会弹出确认confirmOverwriteIfNeeded见 commands.js确认后内部将useForce置为true在底层validateFileOperations见 parse-prd-helpers.js中非 MCP 场景下未授权覆盖会直接process.exit(1)终止。底层执行链流式与非流式从 parse-prd.js 可以看到完整的执行链设计parsePRD(prdPath, tasksPath, numTasks, options) └─ PrdParseConfig 构造配置对象 ├─ useStreaming true → parsePRDWithStreaming → parsePRDCore(handleStreamingService) └─ useStreaming false → parsePRDWithoutStreaming → parsePRDCore(handleNonStreamingService)parsePRDCore统一完成六步公共流程加载已有任务loadExistingTasks→ 校验文件操作validateFileOperations→ 读取 PRDreadPrdContent→ 构建提示词buildPrompts→ 调用 AI 服务serviceHandler→ 处理并保存任务processTaskssaveTasksToFile。值得注意的实现细节流式失败自动回退useStreaming分支捕获到StreamingError或超时错误TimeoutManager.isTimeoutError时会打印黄色警告并自动降级到非流式模式重试parse-prd.js超时控制streamingTimeout默认 180 秒Duration.seconds(180).milliseconds见 parse-prd-config.js流式功能开关源码中ENABLE_STREAMING常量当前为false即当前版本默认走generateObject非流式路径注释说明待问题解决后重新启用见 parse-prd-config.js。输出结果与后续工作流任务文件结构解析结果保存到tasks.json采用tag 维度组织saveTasksToFile见 parse-prd-helpers.js仅更新目标 tag 而不影响其他 tag 的任务并附带created/updated时间戳与描述元数据{ master: { tasks: [ /* 任务数组 */ ], metadata: { created: 2026-09-11T00:00:00.000Z, updated: 2026-09-11T00:00:00.000Z, description: Tasks for master context } } }解析完成后的下一步文档建议解析完成后依次执行展示任务摘要CLI 会通过displayParsePrdSummary见 src/ui/parse-prd.js输出总任务数、优先级分布、PRD 路径、输出路径、耗时与生成的任务文件范围并附带 token 用量与费用统计displayAiUsageSummary查看依赖图运行task-master list查看全部任务及其依赖关系对复杂任务进行展开运行task-master expand --idid将单个任务拆解为子任务该提示也由displayNonStreamingCliOutput直接输出见 parse-prd-helpers.js推荐冲刺规划结合优先级与依赖链安排迭代顺序。准备一份高质量的 PRD解析质量直接取决于 PRD 的结构化程度。仓库提供了 example_prd.txt 作为推荐模板建议按以下区块组织内容Overview产品解决什么问题、面向谁、价值何在Core Features每个功能做什么、为什么重要、高层如何工作User Experience用户画像、关键流程、UI/UX 考量Technical Architecture系统组件、数据模型、API 与集成、基础设施需求Development Roadmap按阶段拆分 MVP 与增强项只关注范围与细节而非时间线Logical Dependency Chain先建什么地基、如何最快到达可用的前端、如何让每个功能原子化且可持续迭代Risks and Mitigations技术挑战、MVP 界定、风险应对方案。提示词同时要求模型填补 PRD 未完全指定的空白但严禁丢弃 PRD 中任何显式要求见 parse-prd.json Guideline 9-10因此模板中的占位符都应替换为具体内容越明确越好。在 MCP 与 Claude Code 插件中使用除了 CLIparse-prd还以 MCP 工具的形式暴露为parse_prd见 parse-prd.js参数与 CLI 一一对应input默认docs/prd.txt、projectRoot必填绝对路径、tag、output、numTasks默认 10、force、research、append。Agent 可据此在对话中直接调用无需手动执行命令。本文所述命令与参数均以当前仓库 commands.js、parse-prd.js、parse-prd.json 的实现为准。从一份 PRD 到一张可执行的任务清单parse-prd打通了产品需求与工程执行的最后一公里——配合 expand 命令、list与set-task-status等命令即可形成完整的“解析 → 拆解 → 排期 → 执行 → 流转”闭环。【免费下载链接】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），仅供参考
Task Master 的 parse-prd 命令从 PRD 文档到结构化开发任务的智能解析指南【免费下载链接】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-masterParse PRD 是 Task Master 项目中最核心的“需求转任务”能力它读取一份产品需求文档PRD交给 AI 模型分析后自动生成一份带编号、依赖关系、优先级与验收策略的结构化任务清单。本文基于 parse-prd.md 展开结合 parse-prd.js、parse-prd.json、commands.js 等源码完整讲解命令用法、解析流程、参数选项、底层实现原理与后续扩展工作流读完即可在自己的项目中用一份 PRD 快速落地可执行的任务看板。命令概述与基本用法parse-prd接受一个必选参数PRD 文件路径支持.txt、.md等纯文本格式。其核心定位是分析你的需求文档并生成完整的任务拆解Analyzes your requirements document and generates a complete task breakdown。最基础的一条命令task-master parse-prd --input$ARGUMENTS其中$ARGUMENTS即 PRD 文件路径。也可以使用位置参数直接传入task-master parse-prd requirements.txt从 commands.js 可以看到该命令通过programInstance.command(parse-prd)注册PRD 路径的解析逻辑为options.input || file即--input选项优先于位置参数。执行时会先初始化 TaskMasterinitTaskMaster随后调用底层parsePRD函数完成解析。智能解析流程parse-prd的解析过程分为三个阶段每一阶段都有对应的源码实现支撑。1. 文档分析Document AnalysisAI 模型对 PRD 内容进行四方面的分析提取关键需求Extract key requirements识别产品必须交付的核心功能点识别技术组件Identify technical components判断实现所需的技术栈、模块与组件检测依赖关系Detect dependencies梳理功能之间的先后顺序与耦合关系评估复杂度Estimate complexity据此决定任务拆分粒度。在实现层面readPrdContent见 parse-prd-helpers.js会同步读取 PRD 文件并校验内容非空空文件会抛出Input file ... is empty or could not be read错误。随后 buildPrompts 调用promptManager.loadPrompt(parse-prd, ...)将 parse-prd.json 中定义的 Handlebars 模板渲染成发给模型的 system/user 提示词。2. 任务生成Task Generation模型按提示词约束输出 JSON 格式的任务数组默认生成10–15 个任务具体数量受--num-tasks影响且保证包含实现类任务implementation tasks补充测试类任务testing tasks覆盖文档类任务documentation tasks为任务设置逻辑依赖logical dependencies。提示词中的输出 JSON 结构见 parse-prd.json每个任务对象包含{ id: 1, title: 任务标题, description: 任务描述, status: pending, dependencies: [], priority: medium, details: 实现细节, testStrategy: 验证方案 }服务端返回后processTasks 会执行两遍处理第一遍将 AI 返回的相对 ID 重映射为从nextId即已有任务最大 ID 1开始的连续 ID并为status、priority、dependencies、subtasks等字段补默认值第二遍将dependencies中的旧 ID 映射为新 ID并过滤掉“指向自身或更高 ID”的非法依赖依赖只能指向更小 ID 的任务。同时 validateSequentialTaskIds 会在运行时校验 AI 返回的 ID 必须是从 1 开始的连续正整数序列从源头杜绝脏数据写入tasks.json。3. 智能增强Smart Enhancements功能分组Group related functionality将相近需求聚合为原子任务优先级设置Set appropriate priorities按关键程度与依赖顺序分配high/medium/low默认值为medium验收标准Add acceptance criteria写入testStrategy字段测试策略Include test strategies每个任务都附带可执行的验证方案。提示词中的 11 条 Guideline见 parse-prd.json进一步约束任务必须原子化、按依赖与实现顺序排序、早期任务先做基础搭建与核心功能、优先级基于关键性和依赖顺序、PRD 中明确的技术栈/数据库/框架要求必须严格保留不得丢弃。选项参数详解parse-prd支持多个修饰参数除了文档中提到的三种快捷写法CLI 还提供完整的命名选项见 commands.js。参数数量数字后缀 →--num-tasks参数说明-n, --num-tasks number生成任务的数量默认值由getDefaultNumTasks()决定默认为 10文件名后直接跟数字task-master parse-prd requirements.txt 15等价于--num-tasks 15显式写法task-master parse-prd requirements.txt --num-tasks 15设为0时让模型根据 PRD 复杂度自行决定任务数量MCP 工具parse_prd的numTasks参数明确支持该行为见 parse-prd.js建议不要超过 50避免超出模型上下文窗口。研究模式research→--research-r, --research启用研究模式文档原话为使用 Perplexity AI 提供“research-backed”的任务生成。在提示词层面见 parse-prd.json 的{{#if research}}分支模型在拆解任务前会先完成六步动作调研适用于该项目的最新技术栈、库、框架与最佳实践识别 PRD 中未明说的技术挑战、安全隐患与扩展性问题结合行业标准与趋势旨在缓解 LLM 因训练数据截止导致的信息过期与幻觉评估多种实现路径并推荐最直接的方案给出具体的库版本、API 与落地指引始终坚持最直接实现路径避免过度工程。task-master parse-prd requirements.txt --research注意--research需要配置对应的 AI API Key且会显著增加 token 消耗。全面模式comprehensive→ 生成更多任务文档中的comprehensive修饰符用于请求生成更全面、更多的任务对应到提示词层面即numTasks数值偏大时模型会“除非复杂度需要更多否则恰好生成 N 个任务”见 parse-prd.json Guideline 1。其他 CLI 选项选项说明-i, --input filePRD 文件路径优先于位置参数-o, --output file输出文件路径默认tasks.json-f, --force跳过覆盖确认直接覆盖已有任务--append追加到已有任务而不是覆盖--tag tag指定任务操作的 tag 上下文默认master覆盖保护机制当目标 tag 中已存在任务时若未加--force或--appendCLI 会弹出确认confirmOverwriteIfNeeded见 commands.js确认后内部将useForce置为true在底层validateFileOperations见 parse-prd-helpers.js中非 MCP 场景下未授权覆盖会直接process.exit(1)终止。底层执行链流式与非流式从 parse-prd.js 可以看到完整的执行链设计parsePRD(prdPath, tasksPath, numTasks, options) └─ PrdParseConfig 构造配置对象 ├─ useStreaming true → parsePRDWithStreaming → parsePRDCore(handleStreamingService) └─ useStreaming false → parsePRDWithoutStreaming → parsePRDCore(handleNonStreamingService)parsePRDCore统一完成六步公共流程加载已有任务loadExistingTasks→ 校验文件操作validateFileOperations→ 读取 PRDreadPrdContent→ 构建提示词buildPrompts→ 调用 AI 服务serviceHandler→ 处理并保存任务processTaskssaveTasksToFile。值得注意的实现细节流式失败自动回退useStreaming分支捕获到StreamingError或超时错误TimeoutManager.isTimeoutError时会打印黄色警告并自动降级到非流式模式重试parse-prd.js超时控制streamingTimeout默认 180 秒Duration.seconds(180).milliseconds见 parse-prd-config.js流式功能开关源码中ENABLE_STREAMING常量当前为false即当前版本默认走generateObject非流式路径注释说明待问题解决后重新启用见 parse-prd-config.js。输出结果与后续工作流任务文件结构解析结果保存到tasks.json采用tag 维度组织saveTasksToFile见 parse-prd-helpers.js仅更新目标 tag 而不影响其他 tag 的任务并附带created/updated时间戳与描述元数据{ master: { tasks: [ /* 任务数组 */ ], metadata: { created: 2026-09-11T00:00:00.000Z, updated: 2026-09-11T00:00:00.000Z, description: Tasks for master context } } }解析完成后的下一步文档建议解析完成后依次执行展示任务摘要CLI 会通过displayParsePrdSummary见 src/ui/parse-prd.js输出总任务数、优先级分布、PRD 路径、输出路径、耗时与生成的任务文件范围并附带 token 用量与费用统计displayAiUsageSummary查看依赖图运行task-master list查看全部任务及其依赖关系对复杂任务进行展开运行task-master expand --idid将单个任务拆解为子任务该提示也由displayNonStreamingCliOutput直接输出见 parse-prd-helpers.js推荐冲刺规划结合优先级与依赖链安排迭代顺序。准备一份高质量的 PRD解析质量直接取决于 PRD 的结构化程度。仓库提供了 example_prd.txt 作为推荐模板建议按以下区块组织内容Overview产品解决什么问题、面向谁、价值何在Core Features每个功能做什么、为什么重要、高层如何工作User Experience用户画像、关键流程、UI/UX 考量Technical Architecture系统组件、数据模型、API 与集成、基础设施需求Development Roadmap按阶段拆分 MVP 与增强项只关注范围与细节而非时间线Logical Dependency Chain先建什么地基、如何最快到达可用的前端、如何让每个功能原子化且可持续迭代Risks and Mitigations技术挑战、MVP 界定、风险应对方案。提示词同时要求模型填补 PRD 未完全指定的空白但严禁丢弃 PRD 中任何显式要求见 parse-prd.json Guideline 9-10因此模板中的占位符都应替换为具体内容越明确越好。在 MCP 与 Claude Code 插件中使用除了 CLIparse-prd还以 MCP 工具的形式暴露为parse_prd见 parse-prd.js参数与 CLI 一一对应input默认docs/prd.txt、projectRoot必填绝对路径、tag、output、numTasks默认 10、force、research、append。Agent 可据此在对话中直接调用无需手动执行命令。本文所述命令与参数均以当前仓库 commands.js、parse-prd.js、parse-prd.json 的实现为准。从一份 PRD 到一张可执行的任务清单parse-prd打通了产品需求与工程执行的最后一公里——配合 expand 命令、list与set-task-status等命令即可形成完整的“解析 → 拆解 → 排期 → 执行 → 流转”闭环。【免费下载链接】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），仅供参考
