convez.ai
AgenteProdutividadeIntermediário
dmlin7777777

build-forward

dmlin7777777/build-forward

Protocolo anti-reescrita para agentes: classifique antes de reescrever

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent 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-forward

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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-inboxB/C 类归档 + 冷却跟踪分类完成后
vibecoding-workflow执行纪律接入路径确定后
incremental-implementation分步稳妥实现已知需求,如何安全执行

完整链路:brainstorming → build-forward → ideas-inbox → vibecoding-workflow / incremental-implementation


优化记录

日期版本过尺评分方法
2026-06-15v1.2.081(独立验收)鲁班过尺·方案B精雕
2026-06-15v1.1.082(预估)鲁班八步打磨
2026-05-31v1.0.079.6 → 85.0Darwin Skill 九维优化

参与贡献

  1. 发现边界场景? 提 Issue 附上场景描述
  2. 有测试用例? 加到 test-prompts.json
  3. 想改进协议? 先读 SKILL.md,再提 PR

许可证

MIT © dmlin7777777

Ver o original no GitHub

Bom para

Relacionados