AI 很會寫 code,但這從來不是問題。問題是流程與管理。
人在 main / master / production 上時,它寫不進檔案 —— 不是提醒你,是動作直接失敗,並告訴你怎麼開 branch。密鑰檔一樣寫不進去,沒有例外通道。
每個請求它會先讀相關檔案,判斷這是修 bug 還是做新功能、以及改動有多大,然後用一張選單跟你確認。要點選項才算數,回「好」不算。
改樣式前,它會先去讀這一區現在用的顏色與字級,照抄既有的值,不憑印象自己配一組新的。做新頁或改版時會先給三個方向讓你挑。
自己寫的 code 自己看都合理,因為記得每一行的來由。所以 review、安全檢查、e2e 一律交給另外開的 agent —— 它們只看得到成品,看不到寫的過程。
每輪回覆最後都標明現在走到哪一步、這次改動算多大。比較大的改動開完 PR 後,會另外寫一份「為什麼改、改了什麼」貼回 PR。
| tier | 量體 | brainstorm | plan | tdd | review | security | pr-explain |
|---|---|---|---|---|---|---|---|
| T0 | 1 行 / typo / 設定 | 跳 | 跳 | 跳 | 跳 | 跳 | 跳 |
| T1 | ≤2 檔 / 單模組小改 | 對話釐清 | 跳 | 1-2 關鍵測試 | self | 跳 | 跳 |
| T2 | 3-10 檔 / 單模組 feature | 完整 | 施工清單寫在 spec 內,≤8 列 | 紅綠循環 | 內建 code-review medium + 對 spec 自檢 | 涉認證 / 授權 / 資料層 / API 邊界 / payment / 上傳 / PII 才 audit | 跳 |
| T3 | >10 檔 / 跨模組 / 架構 / DB schema | 完整 | plan.md + review-plan(1-3 視角) | 紅綠、80% 目標 | code-review high + 對齊 subagent | audit + checklist + db-reviewer | 用 |
前置兩件:node 要在啟動 Claude Code 或 Codex 的 PATH 內(hook 需要),以及 git。Claude Code 與 Codex 裝的是同一份 plugin,指令不同而已。
推薦專案層級:把 templates/project-settings.json 複製成你專案的 .claude/settings.json;沒自動裝就手動跑這兩行。
/plugin marketplace add fujiei22/bstack
/plugin install bstack@bstack
裝完開新 session 跑 /hooks 信任 hook,否則 branch 保護不生效;一站式改跑 scripts/install-codex.ps1。
codex plugin marketplace add fujiei22/bstack
codex plugin add bstack@bstack
statusLine、唯讀權限白名單、Agent Teams 開關,三項各選裝到使用者層級、目前專案或跳過;playwright MCP 隨 plugin 自帶,mysql MCP 含帳密只印範本讓你填。不選就什麼都不寫。
pwsh -File scripts/extras.ps1
Codex plugin 帶不了 agents,也不會幫你開 tools.update_plan:這支把六個 agent 的 TOML 複製到 ~/.codex/agents/、在 config.toml 開任務追蹤,順便做完 01 的兩行。不跑也能用:subagent 退成內建 explorer、任務追蹤退成勾 checkbox。做過什麼有記錄,-Uninstall 只拆自己加的。
pwsh -File scripts/install-codex.ps1
既有 session 不會載入新 plugin。載入成功的第一行是「已載入守則」。
裸 /devwork 目前也可以,沒反應再改用帶前綴的寫法。
/bstack:devwork 要做的事
一律帶 $bstack: 前綴。
$bstack:devwork 要做的事