前言¶

在 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