Skills Atlas · Claude Code Ultraplan
Claude Code · 規劃階段

Ultraplan — 實作前的規劃 在寫下任何程式前徹底規劃
唯讀研究、多方案、核准閘門。

Ultraplan 指把「先深度規劃、後實作」的方法用在規劃階段:以唯讀的 plan mode 徹底研究,由 Plan 代理產出可執行的實作計畫,必要時以多個獨立方案評審與對抗式檢查比較,並在使用者核准前不動程式。本文描述的是由 Claude Code 既有規劃工具組成的做法。

規劃模式
Plan Mode
唯讀研究階段,產出計畫後經核准閘門才實作。
Plan 代理
Read-only
軟體架構代理,產出逐步計畫、指出關鍵檔案與權衡。
核准閘門
Approve
計畫在核准前不執行;plan mode 內以提問釐清需求。
後續交付
Executing
計畫可於另一 session 帶審查檢查點執行。
01 / 概述 WHAT IT IS · PLAN BEFORE CODE

先把計畫做對,再動程式

概述 OVERVIEW

Ultraplan 是把徹底程度用在規劃階段:在進入實作前,以唯讀研究、多個獨立方案與對抗式檢查產出一份經得起檢驗的計畫,並以核准閘門把關。它由 Claude Code 既有的規劃工具組成:plan mode、Plan 代理、AskUserQuestion 釐清,以及 writing-plans 與 executing-plans 等技能。

01

規劃階段是唯讀的。

plan mode 與 Plan 代理只研究、不寫檔:閱讀程式、找出關鍵檔案、評估架構權衡,產出逐步計畫。

02

計畫在核准前不執行。

進入 plan mode 後,以 AskUserQuestion 釐清需求或在方案間選擇,再以 ExitPlanMode 提交計畫供核准。核准是明確的閘門。

03

計畫與實作可分離。

寫好的計畫可在另一個 session 帶審查檢查點執行(executing-plans),或以 subagent 分派獨立任務。

02 / Plan Mode READ-ONLY · CLARIFY · APPROVE
01

Plan Mode 規劃模式

唯讀的研究階段。釐清需求、研究程式、產出計畫,核准後才實作。

3 Steps
Read-only · Clarify
Approve
01/03
Plan 代理

唯讀研究.

軟體架構代理,產出逐步計畫、指出關鍵檔案與權衡.

Plan 代理為設計實作計畫而生:回傳逐步計畫、辨識關鍵檔案、考量架構取捨。它具備除 Agent、Edit、Write、NotebookEdit、ExitPlanMode 以外的工具,屬唯讀,不修改程式。

唯讀 逐步計畫 關鍵檔案
Role 架構代理 Output 逐步計畫
02
AskUserQuestion

釐清需求.

在 plan mode 內用提問釐清需求或在方案間選擇.

進入 plan mode 後,以 AskUserQuestion 在敲定計畫前釐清需求或在方案間選擇。不要用它詢問「計畫好了嗎」,使用者在 ExitPlanMode 之前看不到計畫。

提問釐清 方案選擇
When 敲定前 Tool AskUserQuestion
03
ExitPlanMode

核准閘門.

以 ExitPlanMode 提交計畫供核准,核准前不動程式.

切換進 plan mode 用 EnterPlanMode;提交計畫供核准用 ExitPlanMode。核准前不執行任何寫入動作。

核准閘門 EnterPlanMode ExitPlanMode
Gate 核准 Enter EnterPlanMode
03 / 方案設計 N CANDIDATES · SCORE · SYNTHESIZE
02

方案設計 Design exploration

當解空間寬廣時,產生多個獨立方案、評分後合成,優於單一方案反覆修。

3 Moves
Candidates · Verify
Brainstorm
01/03
評審團

N 個獨立方案.

從不同角度產生 N 個方案,並行評審評分,從勝出者合成.

design 型 workflow 的典型做法:從 MVP 優先、風險優先、使用者優先等不同角度產生獨立方案,以並行評審評分,從勝出方案合成並擷取次優者的優點。解空間寬廣時優於單次嘗試反覆修。

多角度 評分 合成
Panel N 方案 Pick 勝出合成
02
對抗式檢查

採納前反駁.

為計畫中的關鍵假設派出 skeptic,要求反駁.

對計畫中的風險假設派出獨立檢查者,各以不同視角(正確性、相依、可重現)嘗試反駁,多數反駁則修正計畫。在動程式前先淘汰脆弱假設。

風險假設 視角多樣
Verify 採納前 Lens 多視角
03
brainstorming

創作前探索.

任何創作工作前先釐清意圖、需求與設計.

brainstorming 技能用於實作前:在建立功能、元件或修改行為前,先探索使用者意圖、需求與設計。屬規劃階段的前置步驟。

意圖探索 需求釐清
When 創作前 Skill brainstorming
04 / 計畫交付 WRITE · EXECUTE · DISPATCH
03

計畫交付 Plan handoff

寫好的計畫可帶審查檢查點執行,或拆成獨立任務分派。

3 Paths
Write · Execute
Dispatch
01/03
writing-plans

把規格寫成計畫.

有規格或需求時,在動程式前寫下多步驟計畫.

writing-plans 技能用於:當你有一份規格或多步驟任務的需求時,在觸碰程式前先寫下計畫。

規格轉計畫 動程式前
When 有規格 Skill writing-plans
02
executing-plans

檢查點執行.

在另一 session 執行寫好的計畫,設審查檢查點.

executing-plans 技能用於:把寫好的實作計畫在另一個 session 執行,並在過程中設置審查檢查點。

另一 session 審查檢查點
When 執行計畫 Skill executing-plans
03
分派任務

subagent 與平行.

計畫中的獨立任務以 subagent 分派,或平行處理.

subagent-driven-development 用於在當前 session 執行含獨立任務的計畫;dispatching-parallel-agents 用於 2 個以上無共享狀態、無順序相依的任務。

subagent 平行任務
Solo 當前 session Parallel 無相依
05 / 使用說明書 HOW TO USE · STEP BY STEP

從進入規劃到核准的操作流程

Ultraplan 在實作前完成。以下是從進入 plan mode 到核准執行的步驟。

01

進入 plan mode

在 Claude Code 中以 Shift+Tab 循環切換至 plan mode,或直接要求 Claude 先規劃再實作。進入後 Claude 只研究、不寫檔。

02

唯讀研究

Claude 閱讀程式、找出關鍵檔案、評估架構權衡。較複雜的工作可委派 Plan 代理產出逐步計畫。

03

釐清需求

規劃過程中以 AskUserQuestion 釐清需求或在方案間選擇。較寬的解空間可產生多個獨立方案,評分後合成。

04

提交計畫供核准

以 ExitPlanMode 提交計畫。這是明確的核准閘門:在核准前不執行任何寫入動作。

05

核准後執行

核准後才進入實作。較大的計畫可寫成文件,於另一 session 帶審查檢查點執行(executing-plans),或拆成獨立任務以 subagent 分派。

Ultraplan 的規劃閘門
# 規劃在實作前完成,核准前不動程式
進入 plan mode  (Shift+Tab,唯讀)
  ├─ 研究程式、找關鍵檔案、評估權衡
  ├─ 產生多個方案 → 評分 → 合成
  ├─ AskUserQuestion 釐清需求
  └─ ExitPlanMode 提交計畫
核准閘門 ───── 核准前不動程式
  └─ 核准後:executing-plans / subagent 分派
06 / 使用情境 SAMPLE USE CASES

四個值得先規劃的情境。

Ultraplan 適合大型、跨檔、或難以回復的工作。以下情境在動程式前先完成規劃。

01/04
architecture refactor

大型重構前的藍圖

唯讀研究 + 多方案 + 對抗式檢查

對跨多檔的重構,先在 plan mode 研究現況、找出關鍵檔案與相依,產生數個重構路徑評分後合成,對風險假設做對抗式檢查,核准後才動手。

唯讀研究 多方案 對抗式檢查
Scope 跨多檔 Gate 核准
02
migration plan

遷移前的盤點

盤點改動點 → 排序 → 風險檢查

遷移前以唯讀研究盤點所有改動點與相依順序,輸出逐步計畫與風險點。計畫核准後可於另一 session 帶檢查點執行。

盤點 逐步計畫 executing-plans
Output 逐步計畫 Exec 跨 session
03
tech selection

技術選型的多方案評比

N 個方案從不同角度評分合成

面對寬的解空間(框架、儲存、架構選擇),從 MVP 優先、風險優先、使用者優先等角度產生獨立方案,並行評分後從勝出者合成,擷取次優者的優點。

評審團 評分 合成
Panel N 方案 Pick 勝出合成
04
feature breakdown

把大型功能拆成可執行計畫

brainstorming → writing-plans → 分派

先以 brainstorming 釐清意圖與需求,再以 writing-plans 寫成多步驟計畫,最後把獨立任務以 subagent 或平行代理分派執行。

brainstorming writing-plans subagent
Pre brainstorming Exec subagent
07 / 落地建議 WHEN TO PLAN DEEPLY

讓規劃成為實作的前置閘門

規劃投資與任務規模對齊。較大或不可逆的工作先徹底規劃;小改動直接做。

01 · 何時徹底規劃

大或不可逆的工作先規劃

跨多檔、架構變更、遷移、或難以回復的工作,值得先進 plan mode 徹底研究與比較方案。單檔小修改直接處理。

02 · 唯讀先行

研究再下筆

規劃階段唯讀:閱讀程式、找關鍵檔案、評估權衡,產出逐步計畫。不在此階段寫入任何檔案。

03 · 核准閘門

計畫經核准再執行

以 AskUserQuestion 在敲定前釐清需求,以 ExitPlanMode 提交計畫。核准前不動程式,確保方向正確再投入實作成本。

04 · 計畫即交付物

計畫可跨 session 執行

寫好的計畫是可交付、可審查的產物,能在另一 session 帶檢查點執行,或拆成獨立任務以 subagent 分派。

想把這些 Skills 接進你的團隊?

Skills 已經開源。
接上 生產環境這一段,
是 Tenten 在做的事。

Tenten 是 AI-First 設計與技術顧問公司。我們把 Claude、MCP、Agentic Commerce 接進 Headless CMS、Webflow、Shopify Plus 的企業級交付 — 讓這份 Skills Atlas 裡每一個好的開源資產,都能真正跑在你正式上線的 pipeline 上。

Tenten 如何部署這些 Skills
Skills 架構諮詢
依團隊與堆疊選出適配 skills,建立 OpenClaw 路由與 CI/CD 部署流程。
Claude Design System Sprint
兩週固定價格,接上 frontend-design + brand-guidelines 到 production。
Agentic Commerce Build
Shopify Plus / Webflow / Headless 遷移,搭配 Claude + MCP 營運層。