build-forward
dmlin7777777/build-forward
Protocolo anti-reescrita para agentes: classifique antes de reescrever
Ver no GitHubAgent que implementa um protocolo de decisão em cinco passos para evitar que ideias novas causem reescrita desnecessária de código. Classifica mudanças como correção (A), otimização (B) ou expansão (C), avalia impacto destrutivo e consulta o desenvolvedor antes de alterar pontos críticos. Compatível com Claude Code, WorkBuddy e Cursor.
Instalação
npx convez-ai dmlin7777777/build-forward1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Evitar que o agent reescreva código durante ideação de novas funcionalidades
- Avaliar impacto de mudanças em schemas de banco de dados e APIs públicas
- Gerenciar priorização de features com período de resfriamento de 24h
Veredito

Skill bem pensado que traz disciplina real ao fluxo de desenvolvimento com IA. O protocolo de cinco regras é prático e endereça um problema concreto (agent reescreve código sem necessidade). Recomendado para equipes que trabalham com agentes de forma iterativa.
README
A tradução para o português deste README ainda está na fila.
build-forward
这是什么?
AI Agent 在新想法出现时的默认行为是推倒重写。build-forward 阻止这件事。
它是一个五步决策协议,以 Skill 形式加载。当你在开发中途说"我突然想到……"时,Agent 不再推平你的已有代码,而是暂停、分类、评估影响范围,并在动手前征求你的意见。控制权始终在你手里,已有代码保持完好。
加载前后对比
就是一个 Skill 的区别。详见
test-prompts.json中的 8 个可复现验证场景。
为什么需要 build-forward?
每个 AI 辅助开发者都踩过同一个坑:正在做功能 A,脑子里蹦出功能 B 的想法,Agent 为了"给 B 腾地方"重写了半个代码库,结果全崩了。这不是工具问题——是纪律问题。Agent 没有纪律。
build-forward 给它加了一套协议:
| 痛点 | build-forward 怎么做 |
|---|---|
| Agent 不思考直接动手改代码 | 先分类——改一行代码之前,每个想法先标 A/B/C |
| Agent 为"腾地方"推平已有功能 | 消费者审计——先数清楚有几个调用方再决定建不建 |
| Agent 不区分改动大小,一视同仁 | 评估破坏性——单向门改动必须暂停等确认 |
| Agent "为未来"过度抽象 | 数清楚再抽象——0 个消费者 = 不建;1 个 = 内联 |
| Agent 反复写同样的模式 | 重复报警——≥3 次触发 stop-and-ask |
快速开始
1. 安装
# OpenClaw / WorkBuddy
openclaw skills install build-forward
# npx(Claude Code / Codex / 任意 runtime)
npx skills add dmlin7777777/build-forward
# 或直接 clone
git clone https://github.com/dmlin7777777/build-forward.git ~/.workbuddy/skills/build-forward
2. 正常开发。 当你说以下关键词时,Skill 自动触发:
| 触发词(中文) | 触发词(English) |
|---|---|
| "我突然想到…" | "I just thought of…" |
| "要不要顺便…" | "can we also…" |
| "能不能改成…" | "what if we change…" |
| "加个功能…" | "let's also add…" |
3. 装完第一句话。 对 Agent 说:
我突然想到,要不要顺便加个支付系统?
Agent 应该暂停、输出 C 类分类 + 24 小时冷却建议——而非直接开始写支付代码。
4. 更多验证场景 见 test-prompts.json 和 examples/。
工作原理
五铁律速查卡
五条铁律概要
铁律一 — 先分类,不动手
| 类型 | 标准 | 默认处置 |
|---|---|---|
| A — 堵漏 | 当前主路径断裂,必须修 | 立即处理 → 铁律二 |
| B — 优化 | 体验更好,但当前能用 | 问用户:现在做还是进 inbox? |
| C — 扩展 | 全新功能/场景 | 进 inbox + 24h 冷却 |
24 小时冷却是有意设计:大多数功能冲动要么消散,要么沉淀为真实需求。
铁律二 — 评估破坏性
| 门类型 | 例子 | 处置 |
|---|---|---|
| 双向门(可逆) | UI 微调、新字段、新函数、新路由 | 继续 |
| 单向门(难反悔) | DB schema、公开 API、文件删除、全局状态、核心依赖升级 | 🔴 CHECKPOINT — 输出影响矩阵,等用户确认 |
铁律三 — 消费者审计
动手前先数调用方。
| 消费者数 | 处置 |
|---|---|
| 0 | 不建 |
| 1 | 最简内联 — 不抽象 |
| 2 | 可提取 — 不泛化 |
| ≥3 | 可考虑抽象层 |
从源头杜绝"为未来而建"。
铁律四 — 选接入模式
按破坏性从低到高:
Wrap → Extend → Branch → Replace(最后手段)
铁律五 — 重复报警
同一逻辑 ≥3 次重复 → 🔴 CHECKPOINT。问用户:现在统一,还是进 inbox?
完整协议(含边界场景和自纠正规则)见
SKILL.md。
安全声明
本 Skill 是决策协议,不是执行引擎。 它不会删除文件、修改数据库、执行 shell 命令、自动 commit、发送网络请求、或替你决定单向门操作。最大破坏半径:略微降低开发节奏——这是设计意图,不是 bug。
Skill 生态
build-forward 填补了"要做什么?"和"怎么安全地做?"之间的空白。
| Skill | 角色 | 时机 |
|---|---|---|
brainstorming / grill-me | 需求澄清 | 写代码之前 |
build-forward | 新想法防火墙 | 开发中途新想法到达时 |
ideas-inbox | B/C 类归档 + 冷却跟踪 | 分类完成后 |
vibecoding-workflow | 执行纪律 | 接入路径确定后 |
incremental-implementation | 分步稳妥实现 | 已知需求,如何安全执行 |
完整链路:brainstorming → build-forward → ideas-inbox → vibecoding-workflow / incremental-implementation
优化记录
| 日期 | 版本 | 过尺评分 | 方法 |
|---|---|---|---|
| 2026-06-15 | v1.2.0 | 81(独立验收) | 鲁班过尺·方案B精雕 |
| 2026-06-15 | v1.1.0 | 82(预估) | 鲁班八步打磨 |
| 2026-05-31 | v1.0.0 | 79.6 → 85.0 | Darwin Skill 九维优化 |
参与贡献
- 发现边界场景? 提 Issue 附上场景描述
- 有测试用例? 加到
test-prompts.json - 想改进协议? 先读
SKILL.md,再提 PR
许可证
MIT © dmlin7777777