把任何決策(商業或職涯)當成一個要持續迭代的產品:框定 → 拆解 → 驗證 → 收斂 → 決策 → 交付 → 迭代。
整合 business-analysis 與 career-iteration 兩個姊妹 skill 為單一引擎;用 JSON 當大腦、單檔 HTML 看板把所有思路可視化,且能在任何回合被打斷、注入新思考並重新規劃。
- 所有思路可視化 — 每次更新重生
dashboard.html:假設樹、假設看板、洞察、決策、打斷軌跡。 - 可中途打斷 — 隨時注入新假設 / 重新框定 / 重排 / 分枝 / 切鏡頭,引擎立刻重算下一步。
- Dynamic workflow — 不是固定腳本;依「目前狀態」決定下一個最該做的階段。
- 說出你的決策 — 在 Claude Code 裡直接說,例如:「幫我想清楚要不要把副業轉全職」
- 看板自動開啟 — 瀏覽器會跳出一個看板,你的思路會隨對話長出來
- 跟著提示走 — 每一輪結尾 Claude 會告訴你「現在只要做一件事」,回答那個就好
不用記任何術語。隨時可以打斷:說「等等,我想到...」就好。
這是一個 Claude Code skill。把整個 decision-iterator 資料夾放進 Claude Code 的 skills 目錄即可,不需要 GitHub 帳號:
| 系統 | 放到這裡 |
|---|---|
| Windows | C:\Users\<你的使用者名>\.claude\skills\decision-iterator |
| macOS / Linux | ~/.claude/skills/decision-iterator |
步驟:
- 把拿到的
decision-iterator.zip解壓縮。 - 把解出來的
decision-iterator資料夾整個搬到上表的 skills 目錄下(若.claude\skills不存在就自己建)。 - 確認電腦有安裝 Node.js(渲染看板用;任意近代版本皆可)。
- 重開 Claude Code → 直接說「幫我開一個決策 session」就會觸發,或輸入
/decision-iterator。
全部路徑都是自動偵測的,搬到哪台電腦、哪個使用者名稱都能跑,無需修改任何檔案。
在 skill 資料夾內執行(<SKILL_DIR> = 這個 decision-iterator 資料夾):
# 建立新 session
node bin/new-session.mjs "決策標題" hybrid --render
# 改完 JSON 後重生看板
node bin/render.mjs <session-id 或 JSON 路徑>
# 即時自動刷新(在 session 資料夾,選配;需要 Python)
python -m http.server 8765 # 開 http://localhost:8765/dashboard.html(Windows 建議用 node bin/serve.mjs)零依賴,只需 Node。看板純雙擊也能開(離線可用);Python 那步只是為了「自動刷新」,沒有也沒關係。
bin/serve.mjs 會啟動本地看板伺服器(預設 :8710),讓看板不只是唯讀快照。Joshua 可以直接在看板上補證據、裁決、填框定或丟新想法,這些輸入會寫進該 session 的 inbox。下一輪 session 啟動時,Claude 會先讀 inbox 裡尚未處理的項目,轉成節點或框定變更再繼續——對應 SKILL.md「操作協定」裡的中斷/注入步驟。
decision-iterator/
├── SKILL.md 引擎大腦:方法論 + 操作協定 + 打斷詞彙
├── README.md
├── schema/session-state.schema.json 狀態結構(單一事實來源)
├── assets/dashboard-template.html 自含看板模板(含 __STATE__ 注入點)
├── bin/
│ ├── render.mjs JSON → dashboard.html(重算分數、零依賴)
│ ├── new-session.mjs 建立新 session 骨架
│ ├── serve.mjs 即時看板伺服器(含 inbox 互動)
│ └── lib.mjs 共用工具
├── references/ 8 份方法參考(3 商業 + 5 職涯)+ INDEX.md
└── examples/sample-hybrid-decision/ hybrid 範例(可直接 render 看效果)
node bin/render.mjs examples/sample-hybrid-decision/session-state.json
# 然後雙擊 examples/sample-hybrid-decision/dashboard.htmlnode scripts/test-serve.mjs # 可寫看板伺服器:寫入正確性 + 跨站防護關於可寫看板的安全性:serve.mjs 只綁 127.0.0.1,但「本機」不等於「安全」——
你瀏覽的任何網頁都能對 localhost 發跨站請求。因此它有兩層防護:
- 強制
Content-Type: application/json—text/plain這類 CORS 安全清單類型不會觸發 preflight,是無聲跨站寫入的主要途徑。要求 JSON 就會強制 preflight,而我們不回任何 CORS 標頭,瀏覽器就會擋下。 - Host 白名單 — 擋 DNS rebinding(攻擊者把自己的網域解析到 127.0.0.1;此時 Origin 與
Host 會一致,單看 Origin 會被騙過)。這條擋在所有請求前面,因為
GET /session-state.json等於你整份決策內容。
零外部依賴,只用 Node 標準函式庫。
本專案採 Business Source License 1.1(source-available)。
| 你想做的事 | 可以嗎 |
|---|---|
| 自己用、改它、在公司內部用 | ✅ 可以 |
| Fork、研究、送 PR | ✅ 可以 |
| 把它包成付費產品或託管服務賣給別人 | ❌ 需要商業授權,請聯絡作者 |
| 2030-07-13 之後 | ✅ 自動轉為 Apache-2.0,隨你用 |
授權範圍包含 SKILL.md 與 references/ 的方法論內容,不是只有 bin/ 的程式碼。
想貢獻請先看 CONTRIBUTING.md —— 有一段關於著作權的重要說明。
Copyright © 2026 Joshua Wang.
整合 business-analysis 與 career-iteration 兩套方法為單一決策引擎。