循环工程协议
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_11fe2a93/loop-engineer。
技能介绍
痛点:一次性回答往往跑不通
修 bug、配环境、从零写脚本时,模型常只给一版代码或猜测性建议,缺少跑命令、看 stderr、再改一版的闭环。你手头有验收条件(测试要绿、容器要能起),但对话仍停在「应该会好」的推断上,浪费来回澄清。
工作方式:五步循环 + 外部验证
本技能把助手切到循环工程模式,每轮严格走:目标(Goal) → 行动(Action) → 观察(Observation) → 评估(Evaluation) → 失败时修正(Revision)。
- 目标:本轮要达成什么、怎样算成功(如
pytest全过),必须可判定。 - 行动:一轮只做一件事——改一个文件、跑一条命令,并尽量可回溯。
- 观察:以终端输出、测试结果、文件内容为准;禁止没有外部信号就宣布成功。
- 评估 / 修正:对照目标判成败;失败则做根因分析再进入下一轮。
协议里还区分修复型(有明确报错)、构建型(从零搭 MVP)、排查型(原因不明、逐步缩小范围)等策略,并配合作用域锁定:只动与任务直接相关的文件。
边界与注意点
- 连续自主迭代最多 5 轮,之后需暂停汇报、等人工确认。
- 连续两轮完全相同错误会强制停止,避免死磕同一方案。
- 需要本地可执行环境(Shell/终端);不适合纯闲聊、单次生成、无法命令行验证的主观需求。
- 不提供账号密码等私密凭证操作;不可逆操作(如
git push --force)须先获授权。
使用场景
- 本地 Python 脚本报错,需要反复运行并根据 traceback 修到能正常执行
- pytest 或单元测试失败,要按失败用例逐轮改代码直到全部通过
- Docker Compose 启动失败,需改配置并多次 `docker compose up` 验证容器能稳定起来
- 服务偶发崩溃且原因不明,要通过复现、加日志或二分注释逐步缩小故障范围
适合人员
- 维护遗留单体服务的后端,常被「跑不起来」挡住,希望助手按测试或运行结果自动迭代修
- 正在搭数据清洗流水线,要把 CSV 读入、清空空值并输出文件,且必须用样例数据验收
- 负责 CI 的同学,流水线里编译/测试红了一片,需要有人按日志修配置或代码而非只给建议
- 自建脚本工具的作者,环境问题多、报错杂,需要限定文件范围的多轮排查而不是一次性补丁