Big Plan 是一个仅做规划的 Claude Code 技能,属于 takazudo/claude-resources 资源集。它的核心目标不是实现代码,而是把要做的实现工作变成一份清晰、可评审、可追踪的计划,并最终落地为 GitHub Issues 或本地协调目录,再交给后续实现技能执行。
用途与定位
Big Plan 会探索代码库,提出任务拆分方案,把规划日志保存到 $HOME/cclogs/{slug}/,获取第二意见(codex,并带自动 Opus 回退),创建 GitHub Issues,验证没有遗漏,然后在新的会话中移交给 /x-wt-teams。它适用于几乎所有实现任务,而不只是超大任务:把意图固化下来,把工作拆成可评审的单元,并形成能在上下文压缩后仍然保留的书面记录。
主要能力
-
输入解析:支持自由文本描述要实现的内容;支持已有 Issue 引用,包括 GitHub Issue URL、#123 或裸数字 123、以及“all open issues”“recent N open issues”等短语,从而进入已有 Issue 模式;也支持混合输入。
-
评审与验证:默认包含第二意见评审(Step 5,codex,带 Opus 回退)、向用户提出方案(Step 6)、需求验证(Step 9),以及清理审计(Step 10)。
-
Issue 创建与移交:创建 epic 和子 Issue,并把最终实现移交给下游技能。多子 Issue 计划交给 /x-wt-teams,单子 Issue 计划交给 /x-as-pr。
-
自动自治模式:-a / --auto 让整个链条自主运行,跳过 Step 6 确认等待并自动创建 Issue,但仍保留质量门禁(Step 5 评审、Step 9 验证)。它是一种“知情委托”,产品/设计偏好、范围界定、架构、高难度、陌生的父分支形状等都由代理作出选择并披露,而不是停下来询问。只有合同定义的硬自治停止条件才回退到询问等待。
-
参数与组合:
- -nor / --no-review:不做常规确认门禁和评审步骤,跳过 Step 5、Step 6、Step 9,直接起草计划、保存日志、创建 Issue 并结束会话。这是唯一跳过 Step 5 的方式。
- -m / --merge:Big Plan 本身从不合并,但该标记会触发与 -a 相同的 Step 11 自动调用,并把 -m 转发给下游技能,由下游在实现完成后合并 PR 到基础分支、运行清理阶段并监控基础分支 CI。与 -a 组合即完全无人值守。
- -po / --plan-only:规划自治,链条止于 Issue 创建,Step 11 永不自动调用实现技能。用于分离模型工作流,例如 -is -po 清扫。
- -f / -fix / --auto-fix 与 -nf / --no-fix:Big Plan 本身不做自动修复;-f 只是下游默认值的显式形式,真正改变行为的是 -nf,它会在 Step 11 移交时转发以跳过下游自动修复。
- -ri / --raise-issues 与 -nori / --no-raise-issues:同上,只有 -nori 改变行为,转发后让实现会话及其评审者把发现只保留为终端输出。
- -lo / --local:本地模式,不创建 GitHub Issue,而是把计划写入 cclogs 协调目录,并把路径交给实现技能,使整个运行保持无 Issue。
- -br / --bake-resource:资源烘焙模式,用于“本地 Mac 规划 → 网页端实现”的方向,把实现者需要读取的原型/设计参考/夹具从 Dropbox cclogs 目录复制进仓库的 _temp-resource/{epic#}-{slug}/,再运行基础分支资源移交。仅终端可用,网页端为惰性。
- -toco / --to-codex:把实现移交给 Codex CLI,在 tmux 新窗口中运行 codex 并暂存实现命令。仅终端可用,被 -po 覆盖。
- -tocl / --to-claude:移交给全新 Claude Code 会话,在 tmux 新窗口运行 claude,保留新创建的 Issue 编号。仅终端可用,被 -po 覆盖,与 -toco 互斥。
- -is / --issue-sweep:批量清扫模式,必须是用户手动输入才生效。收集开放 Issue,分诊处理或跳过,对每个处理的 Issue 规划为一个 epic,批次产生 2 个以上 epic 时打包成一个清扫级 super-epic,并由一次链式 /x-wt-teams -a 按顺序实现所有子 epic。清扫专属伴随参数有 -f LABEL / --filter LABEL、-ex LABEL / --exclude LABEL 和 -re / --refresh-epic。
- -isask / --issue-sweep-ask:访谈式清扫,隐含清扫模式,与 -is 不同的是候选集包含此前已被推迟的 Issue 和 sticky 人工检查仪表盘上的未关闭条目,并且把单一的 Step 3 批量门禁变为逐个访谈。重复推迟是一等结果。
使用方式
在 Claude Code 中以技能形式调用,输入可以是自由文本、Issue 引用或清扫短语,并可按需附加上述标记。默认流程包含评审、确认与验证;使用 -a 或 -po 可改变自治程度。规划完成后,计划会保存到日志目录,Issue 会创建到 GitHub,或(在 -lo 下)写入本地协调目录。
网页环境适配
在网页端 Claude Code($CLAUDE_CODE_REMOTE=true)时,需遵循 web/web-mode.md:通过 GitHub MCP(issue_write、sub_issue_write)而非 gh 创建/编辑 epic 与子 Issue,并预先创建 epic/sub 标签;默认 Codex Step-5 计划评审器不可用,改用 Claude 评审器(如 /opus-2nd)。规划日志落在临时的 /tmp cclogs stub,Step 11 会把最终计划日志作为 epic Issue 评论发布以在容器销毁后保留,其他重要内容要持久化到 epic Issue 正文。网页端不支持 super-epic 打包,-is 清扫会退化为把每个处理的 Issue 规划为独立 epic,并提示必须从终端会话运行。网页端有限的验证环境无法运行最终视觉/Mac 专属检查,/big-plan 只需在标签引导中植入 mac 标签,不为此增加 Step 11 暂停。
适用场景
几乎所有实现类任务的规划阶段,尤其是需要把意图固化、把工作拆成可评审单元、并留下可跨上下文压缩的书面记录的场景;也适用于批量清扫开放 Issue 并统一规划,或采用分离模型工作流(强推理模型规划、另一会话实现)的团队。
限制
部分标记仅终端可用(-br、-toco、-tocl),网页端为惰性;网页端不支持 super-epic 打包;-is 与 -isask 必须由用户手动输入才生效;-toco 与 -tocl 互斥;-po 会覆盖 Step 11 自动调用。关于具体收费、价格、支持平台与效果,资料中暂未提供。