用途:在 Claude Code 工作流中,把一条需求拆解为收敛的层级(渐进模式)或按拓扑排序的任务序列(直接模式),并自动创建 issue。核心流程为需求理解→策略选择→上下文收集(可选)→拆解与建 issue→校验→交接 team-planex。
主要能力:三种模式——progressive(MVP→迭代分层,适合高不确定性需求)、direct(拓扑排序任务序列,适合低不确定性需求)、auto(按不确定性自动选择);可选通过 cli-explore-agent 子代理扫描代码库获得上下文;issue 存入 .workflow/issues/issues.jsonl,wave 与依赖信息写入 issue 标签和 extended_context.notes;输出目录为 .workflow/.req-plan/{session-id}/,含 roadmap.md、strategy-assessment.json、exploration-codebase.json;包含强制的拆解质量检查步骤。
必要用法:$workflow-req-plan "Implement user authentication system with OAuth and 2FA";$workflow-req-plan -m progressive "Build real-time notification system";$workflow-req-plan -m direct "Refactor payment module";$workflow-req-plan -m auto "Add data export feature";$workflow-req-plan --continue "user authentication system";$workflow-req-plan -y "Implement caching layer"。标志:-y/--yes 跳过全部确认;-c/--continue 继续已有会话;-m/--mode <progressive|direct|auto> 拆解策略,默认 auto。
适用场景:需要将较大需求分阶段推进、希望以可测试收敛标准定义完成度、并与 team-planex 规划交接配合的项目。
限制:资料未提供具体价格、收费、平台支持范围及运行环境要求;依赖 ccw 命令、Gemini(回退 Qwen 或手动拆解)及子代理 API,缺少这些依赖时资料未说明降级行为;代码库上下文仅在检测到项目文件时收集。