Ralph Prompt Generator: Single Task 是一个面向单一、聚焦任务的提示词生成技能,用于生成针对 Ralph Wiggum 技术优化的结构化提示词。
用途 该技能适合为单个实现任务生成提示词,典型场景包括:具有明确成功标准的缺陷修复、单一功能实现、重构任务、为现有代码添加测试、特定模块的文档编写,以及具有可量化目标的性能优化。其核心理念是:失败是确定性的、可修复的,每次迭代都从上一轮学习,不必惧怕失败,失败是预期内的,并为通过提示词调优改进提供数据。
主要能力 生成的提示词包含清晰的完成标准、自动验证(测试)、自我纠正循环以及正确的 <promise> 完成标签。生成流程分为四步:
- 分析任务:识别动作(需要完成的具体工作)、范围(受影响的文件/模块)、验证方式(如何自动验证成功)以及边界情况(可能出错的地方)。
- 定义完成标准:好的标准应可度量(测试通过、无错误、特定输出)、可自动验证(非主观)、二值化(明确完成或未完成)。例如缺陷修复的好标准是“测试通过,缺陷不再复现”,坏标准是“缺陷已修复”;功能的好标准是“所有 CRUD 端点返回 200,测试通过”,坏标准是“功能可用”;重构的好标准是“所有测试通过,代码使用新模式”,坏标准是“代码更整洁”。
- 组织提示词:使用模板,包含任务标题、目标、上下文、需求、成功标准、验证步骤、TDD 方法、完成条件与“卡住时”指引。
- 添加验证命令:包含用于验证成功的具体命令,如 npm test、pytest tests/、npm run lint、ruff check .、curl 请求等。
使用方式 输入需要三项内容:任务描述(需要做什么)、成功标准(如何验证完成)、完成承诺文本(表示完成的短语)。生成提示词时使用如下形式: Generate a Ralph prompt for: [task description] Success criteria: [how to verify] Promise: [completion phrase]
生成的提示词模板结构为:
Task: [Clear Task Title]
Objective
[1-2 sentence clear description of what needs to be accomplished]
Context
[Brief background - what exists, why this is needed]
Requirements
- [Specific requirement 1]
- [Specific requirement 2]
- [Specific requirement 3]
Success Criteria
- [ ] [Measurable criterion 1]
- [ ] [Measurable criterion 2]
- [ ] [Measurable criterion 3]
Verification Steps
- [How to verify criterion 1]
- [How to verify criterion 2]
- [How to verify criterion 3]
TDD Approach
- Write/identify failing tests for the requirement
- Implement the solution
- Run tests:
[test command] - If tests fail, analyze output and fix
- Repeat until all tests pass
Completion
When ALL of the following are true:
- All success criteria met (checklist above)
- All tests passing
- No regressions introduced Output: <promise>[COMPLETION_PHRASE]</promise>
If Stuck
After multiple iterations without progress:
- Document what's blocking progress
- List approaches attempted
- Identify specific error or issue
- Do NOT output false promise - continue iterating or wait for max-iterations
验证命令部分示例:
Verification Commands
# Run tests
npm test
# or
pytest tests/
# Check for errors
npm run lint
# or
ruff check .
# Verify specific functionality
curl -X GET http://localhost:3000/api/endpoint
资料中提供了三个示例提示词:缺陷修复(修复认证令牌刷新竞态条件,承诺 AUTH_FIX_COMPLETE)、功能实现(为 /api/users 端点添加分页,承诺 PAGINATION_DONE)、重构任务(将数据库模块的回调转换为 async/await,承诺 ASYNC_REFACTOR_COMPLETE)。每个示例均包含目标、上下文、需求、成功标准、验证步骤、TDD 方法、完成条件与“卡住时”指引。
与 Ralph Loop 集成 运行生成的提示词: /ralph-wiggum:ralph-loop "[paste generated prompt]" --completion-promise "YOUR_PROMISE" --max-iterations 30
推荐设置:缺陷修复 --max-iterations 15-20;功能 --max-iterations 25-35;重构 --max-iterations 20-30。
最佳实践 应做:使用具体、可度量的成功标准;包含实际测试命令;为每条标准添加验证步骤;包含用于自我纠正的 TDD 方法;设置清晰的完成条件;提供“卡住时”指引。 不应做:使用模糊标准(如“让它工作”);跳过验证命令;忘记边界情况;制定主观成功标准;允许未真正完成就退出。
使用前验证清单 任务具有单一、聚焦的目标;成功标准可度量;验证命令具体且可运行;已定义 TDD 方法;完成承诺清晰具体;“卡住时”部分提供指引。
相关技能 多任务提示词参见 ralph-prompt-multi-task;项目级提示词参见 ralph-prompt-project;研究/分析提示词参见 ralph-prompt-research。
限制 资料未提供该技能的收费、价格、平台支持范围或具体效果数据,这些信息暂未提供。