用途
Reengineering Vibe Code 面向已经存在、但结构混乱的 vibe-coded 原型,目标是在不破坏既有行为的前提下,把原型重构为更规范的架构。它是一条由路由(vibe-orchestrator-agent.md)驱动的多阶段工作流,路径记为 vibe-reengineering.mmd。
主要能力
- 浏览器审计:对运行中的应用进行审计,产出 exploration/captures/DISCOVERY_REPORT.md 一类的发现报告。
- 安全网:建立表征测试(characterization tests),逐字断言旧有行为,作为后续改动的回归保护。
- 需求与风险:整理并合并 specs/REQS.md,设置风险闸门;完整架构包为可选项。
- 领域抽取:抽取纯领域模型,并由 domain-purity-auditor 执行纯度审计。
- 目标脚手架:生成 ADR、端口(ports)与会话记忆等脚手架内容。
- 切片迁移:按切片迁移,并由 semantic-drift-auditor 做语义漂移审计、由 certification-verifier 负责切片认证。
- 交接:最后通过 handing-off-to-engineering 交给工程流程。
使用方式
资料给出的快速开始命令为:
test -f exploration/captures/DISCOVERY_REPORT.md || echo "start at phase 1" ls specs/REQS.md tests/characterization 2>/dev/null
工作流共七个阶段:浏览器审计、安全网、五个架构问题(逐个提问)、REQS 与风险闸门、领域抽取与纯度审计、目标脚手架、切片迁移与漂移审计和认证,最后交接给工程。运行时与模型通过 cli-agent 技能选择。破坏性操作应在隔离工作区(os-control-worktree 技能)中进行;仅在用户运行控制平面时,才通过 os-control-intake 登记任务。
约束与校验
事实来源优先级为:specs/REQS.md > tests/characterization/ > /domain > 派生规格 > 原型代码(规则)。出现冲突时标记 HUMAN_REQUIRED。禁止自主改写鉴权、计费、加密或合规日志,这些需要绑定哈希的 human-approval.json 人工审批。表征测试的夹具不得包含绝对路径或机密。只有四个独立智能体拥有决策权:domain-purity-auditor、semantic-drift-auditor、certification-verifier(slice-certified 的唯一权威)与 business-rule-audit-agent;同一问题被拒绝两次后升级给用户。校验时运行表征测试套件(要求 100% 一致)、纯度与漂移报告,以及 temp/ 下的认证报告;验收标准见 acceptance-criteria.md。
适用场景与限制
适用于已有可运行原型、希望补测试并逐步迁移到规范架构的项目。它不替代人工审批高风险模块,具体运行时、模型与费用等细节资料暂未提供。