用途:把一条需求转化为战略路线图,通过迭代拆解生成可执行 issue,供后续执行流水线使用。该技能仅做规划,绝不执行代码或修改源文件,输出为路线图与 issue 供用户审阅。
主要能力:生成单一事实来源 roadmap.md(含战略评估、路线图表格、每个 issue 的收敛标准、迭代历史,可选代码库上下文附录);双模式拆解——progressive(MVP→可用→精炼→优化,2-4 层,适合高不确定性)与 direct(拓扑任务序列,适合需求明确);可选通过 web.run 做外部研究;issue 追加写入全局 .workflow/issues/issues.jsonl;用 functions.update_plan 跟踪阶段进度;记录结构化决策轨迹;结束时提供交接门(执行计划/查看 Issue/完成)。
使用方式:命令形如 $roadmap-with-file "Implement user authentication system with OAuth and 2FA",可加 -m progressive、-m direct、-m auto、--continue、-y。标志:-y/--yes 跳过确认进入自动模式;-c/--continue 继续已有会话;-m/--mode 选择策略。输出目录 .workflow/.roadmap/{session-id}/,核心输出 roadmap.md 与 issues.jsonl。issue 可用 ccw issue list、ccw issue queue list、ccw issue queue dag、ccw issue next --queue <queue-id>、ccw issue queue add <issue-id>、ccw issue done <item-id> 查询与操作。
适用场景:需求尚不清晰、需要先验证再推进时用 progressive;技术已确认、任务依赖明确时用 direct。
限制:仅规划,不落地代码;迭代最多 5 轮;自动模式会跳过交互式细化;子代理等待超时按状态探测→强制收尾→关闭处理。其余细节资料未提供。