前言¶

在 DSH 裏讓智能體「把項目改好一點」，常見做法是寫一句籠統的 improve 提示。這樣往往只能得到單次改動：沒有固定 brainstorm、沒有跨輪記憶，改動範圍也容易失控。make-it-a-bit-better 是 Lumos-789 維護的工作流類 DSH 插件，用 skill 驅動一套自治打磨循環：每輪強制重新 brainstorm、只落地一個小改動、驗證通過再提交，並把記錄寫入目標倉庫內的 ledger。理念是名稱本身——不做大重寫，一輪一點，累積變更好。

下面介紹它是什麼、每輪在做什麼、如何安裝與調用，以及使用時需要注意的邊界。

這是什麼¶

make-it-a-bit-better 是一個 skill 插件（純 skill，無 MCP server、無額外 runtime 依賴）。它在目標 Git 倉庫根目錄上運行自主產品打磨循環：每輪開啓 mandatory fresh brainstorm（默認 3 個帶不同視角的 subagent），選一個角度，實現、驗證並 commit，同時寫入 per-project ledger；過大的想法進入 icebox，而不是硬塞進單輪上限。

維護者：Lumos-789。社區目錄頁：https://www.skillhub.cn/plugins/Lumos-789/make-it-a-bit-better。源碼與說明：https://github.com/Lumos-789/make-it-a-bit-better。許可證：MIT（見倉庫 LICENSE）。

與臨時提示相比的結構保證¶

README 明確對比了 ad-hoc「improve it」與本循環的三點差異：

1. 每輪 fresh brainstorm — 3 個強制視角生成候選，與 ledger 去重，避免重複上一輪的框架。
2. 一個小且已驗證的改動 — 單輪約 ≤3 個文件 / ≈100 行；必須通過倉庫自有檢查；紅燈則 revert，不帶着未驗證改動交付。
3. 跨輪記憶 — ledger 記錄已觸達的維度，icebox 存放過大想法，避免第 17 輪重複第 3 輪的角度。

核心功能：一輪的七個階段¶

每輪大致遵循以下步驟（細節以倉庫 README 爲準）：

1. Ground — 讀產品、近期 commit 與 ledger；未觸達維度優先。目標必須是 Git 倉庫根；非 Git 或嵌套在其他 repo 內會在開工前拒絕。無 README/docs 時以入口代碼與目錄樹 grounding，並在輪次報告中說明，不臆造產品摘要。
2. Brainstorm（強制） — 3 個 subagent 各戴不同 lens（首次用戶、挑剔日常用戶、六個月後的維護者等）；與 ledger 去重。無 subagent 工具時退化爲三次 in-session、強制 lens 的 pass。focus 會在每個 lens 的 grounding 中 spotlight 指定區域； brainstorm 仍偏薄時，可從 icebox promoted 可切片進輪次上限的想法。
3. Select one — 按 felt-impact × freshness ÷ cost 選一個，受 ≤3 文件 / ≈100 行約束；更大想法進 icebox；有 focus 時 in-focus 候選優先排序。
4. Implement — 遵循目標倉庫慣例，改動完整，不留 TODO/mock。
5. Verify — 跑倉庫自有 tests / build / lint / smoke；工具鏈缺失時誠實標註 verification pending；完全無可跑表面時做最小手動 smoke 或標註 verification pending (no runnable surface)。紅燈在本輪上限內修不好則本輪不交付：先 commit mabb #N: <angle>，再立刻 mabb #N: revert，ledger 記 failed，不把未驗證 diff 當成果 ship。
6. Record — 成功時每輪一個 commit（mabb #N: <angle>）加 ledger 條目。寫入 ledger 前確認 .agents/ 已被 gitignore（git check-ignore；缺規則則在本輪內追加），避免 agent 工作態進 commit。
7. Loop — 默認 ask-to-continue；指定 rounds N 則連續跑 N 輪。連續兩輪 thin brainstorm 會 self-stop。每輪結束有六字段報告；整次 run 結束有四字段 run summary。self-stop 會在 ledger 寫入帶日期的 stalled 行。

Ledger 與 icebox¶

循環記憶文件位於目標倉庫：

.agents/mabb/ledger.md

ledger 用於防重複角度、展示 coverage，引導 brainstorm toward 未觸達維度。icebox 存 good-but-too-big 想法；某輪落地後刪除對應條目。icebox 條目有穩定短 id（IB-1、IB-2 …），便於報告與 promotion 引用。

輸入參數¶

安裝與啓用¶

需要 DSH 0.2.1-rc.2 或更新版本（package.json 中 engines.dsh 爲 >=0.2.1-rc.2 <0.3.0）。插件包版本在資料中爲 0.2.2；peer 依賴 @deepseek-ai/dsh-skill-filesystem（範圍見 package.json）。

從本地 checkout 安裝：

dsh plugin add /path/to/make-it-a-bit-better

發佈後（README 原文）：

dsh plugin add make-it-a-bit-better

同一倉庫也可作爲 ZCode 插件（.zcode-plugin/plugin.json + skills/），從列出它的 marketplace 安裝；DSH 側以上述命令爲準。

安裝前建議閱讀倉庫源碼與 MIT 許可證；插件以當前 dsh 進程權限運行，會對目標 repo 寫文件與做本地 commit。

典型用法¶

插件安裝後，對 executor 用自然語言指明倉庫與輪次即可。README Quick start 示例：

Run 3 rounds of make it a bit better on /path/to/repo

帶 steering（輪次 + focus）：

Run 5 rounds of make it a bit better on /path/to/repo, focusing on the checkout flow

預期：每輪一條 ledger 記錄，最多 N 個小改進 commit——最多，因爲連續兩輪 thin brainstorm 會 self-stop（ledger 出現 dated stalled），或驗證失敗會 revert（failed, reverted 行，無未驗證交付）。commit 數少於 N 是循環按規則誠實停止，不是故障。僅當 brainstorm 產生超單輪上限的想法時纔會出現 icebox。

副作用與適用注意¶

README「Side effects」節披露的行爲 worth 在安裝前瞭解：

• Model calls：每輪約 3 次 brainstorm subagent（或等價的 in-session pass）；N 輪約 ≈3N 次調用。
• Files：改動寫在目標 repo；ledger 在 <target>/.agents/mabb/。
• Git：每輪最多一個本地 commit（失敗時兩個：改動 + revert）；團隊共享 repo 會先提議分支，不直接改 main。除非用戶明確要求 push，否則不會 push 遠程。
• Network：除 model API 外無額外網絡。
• Context：skill 文本每輪整包加載，軟上限約 150 行，超出會通過 distill 既有內容控制體積。

適合：已有 Git 根目錄、希望持續小步改進而非一次性大改的產品或 side project；需要可審計的輪次記錄與 icebox backlog 的團隊或個人。

不適合或需慎用：非 Git 目錄、嵌套子目錄當 target、或不允許本地 commit 的倉庫策略——插件會在 ground 階段拒絕或走分支提案流程。

DSH 生態理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文不將其描述爲官方應用商店。

結尾¶

make-it-a-bit-better 把「改好一點」收成可重複的工作流：fresh brainstorm、單輪小改動、驗證與 ledger、icebox 承過大想法。若要在本地試跑，先滿足 DSH 版本與 Git 根目錄要求，再用 README 中的 dsh plugin add 安裝，並對目標倉庫用 Quick start 中的句式發起 N 輪打磨。

• 目錄頁：https://www.skillhub.cn/plugins/Lumos-789/make-it-a-bit-better
• GitHub：https://github.com/Lumos-789/make-it-a-bit-better