SuperAPI AI 工具集

ralphify-spec

智能体与模型

查看项目

更新于 10-16 03:16

技能介绍

用途:把用户用自然语言描述的迭代型工作,翻译成符合 ralphify 规范、可直接运行的 ralph 目录,包含带 YAML frontmatter 的 RALPH.md、命令块和遵循 Ralph Wiggum 方法的提示正文。用户无需了解 ralphify 内部机制。

适用场景:每次迭代能取得增量进展、且有明确停止条件的工作,例如把测试覆盖率提升到阈值、清理 lint 或类型检查错误、把文件从一种语言或框架移植到另一种、逐条解决 PR 评审意见、处理队列直到清空。若任务是一次性的(如“给页面加个按钮”),该技能会建议单次实现并停止。

主要流程:先用最多 2-3 个问题确认意图(完成标准、语言与工具、硬性约束),从 pyproject.toml、Cargo.toml 或 package.json 推断技术栈;取 kebab-case 名称,默认放在当前仓库的 ralphs/NAME/;用 ralph init ralphs/NAME 从官方模板脚手架后重写;设计 frontmatter(agent、commands、args、credit 等);把 shell 特性放进脚本,因为 commands[].run 由 shlex.split 解析,不支持管道、&&、重定向或 $(...);编写提示正文,包含角色与循环感知、上下文重置说明、命令输出段、任务段、<promise>COMPLETE</promise> 停止哨兵、规则与提交约定;用校验脚本验证;把 run.sh 包装器复制到 ralph 目录;最后报告文件树、单次迭代说明和建议首次运行命令。

限制与约束:不得编造 ralphify 不支持的 frontmatter 字段;不得在 run: 中管道或链式命令;不得留下未声明的占位符;首次运行不要无上限,建议 -n 50;必须包含 COMPLETE 哨兵;burn-down-todos 型 ralph 的任务块必须互斥,逐项工作与 closer 不能在同一迭代触发。校验命令为 uv run --with pyyaml python scripts/validate.py PATH/TO/RALPH.md,退出码 0 表示干净、1 表示错误、2 表示环境问题。运行包装器示例:scripts/run.sh PATH/TO/RALPH_DIR -n 50 -t 1800 -s -l PATH/TO/RALPH_DIR/logs。