用途:Ralph 是“队列运行器”,每次只从本地议题文件 docs/issues/<change-name> 中挑选并完成一个可自主执行的 AFK 任务。若应由用户直接指定议题执行,则使用独立的 execute-issue 技能。
主要能力:按优先级挑选任务,依次为关键缺陷修复、开发基础设施(测试、类型、构建脚本、本地工具)、新功能的“曳光弹”、打磨与快速收益、重构;仅处理标记为 AFK 的议题,不处理 HITL(需人工介入)议题。若没有可执行的 AFK 议题,输出 <promise>NO MORE TASKS</promise>。仅限指定的 docs/issues/<change-name> 目录,不搜索其他变更文件夹。
使用方式:由用户或包装脚本提供议题文件、最近几次提交与工作树。工作流为:阅读议题与近期提交了解上下文;探索仓库以明确实现边界与现有模式;涉及第三方框架、库、SDK、API、CLI、云服务、配置项或语法时,按仓库的文档查询流程获取最新文档,若工作区要求 ctx7 则用 npx ctx7@latest library <name> "<question>" 或 npx ctx7@latest docs <libraryId> "<question>";按仓库 TDD 流程实现,优先在公共边界写行为测试;提交前运行反馈循环,.NET 项目默认 dotnet build 与 dotnet test,非 .NET 项目从现有脚本和文档推断等价命令;提交前移动或更新议题文件,运行 git status --short、暂存所有任务相关文件并提交,提交信息需含关键决策、改动文件、阻塞或下一轮注意事项,提交后再次运行 git status --short。
议题更新:完成后将议题文件移动到 docs/issues/<change-name>/done/;未完成则在文件中补充已完成内容与剩余工作。
限制:只做单个任务,提交后不继续第二个议题;不启动 HITL 工作;除受阻外不跳过测试,受阻需在议题与最终回复中记录;不从日志、提示或环境文件复制密钥。技能目录可能含包装脚本:ralph/once.sh <change-name> [model]、ralph/afk.sh <iterations> <change-name> [model]、ralph/afk-nodock.sh <iterations> <change-name> [model]、ralph/once-codex.sh <change-name> [model]、ralph/afk-codex.sh <iterations> <change-name> [model]、ralph/afk-nodock-codex.sh <iterations> <change-name> [model];作为 Codex 在该技能内工作时直接遵循上述流程,除非用户明确要求,否则不调用这些脚本。