setup-ralph
npx skills add https://github.com/melvynx/aiblueprint --skill setup-ralph
Agent 安装分布
Skill 文档
This skill ONLY sets up Ralph – you run the commands yourself.
<quick_start> Setup Ralph interactively (recommended):
/setup-ralph -i
Setup for specific feature:
/setup-ralph -f 01-add-authentication
What this does:
- Creates
.claude/ralph/structure in your project - Runs setup script to create all Ralph files
- (If -i): Brainstorms PRD with you interactively
- Transforms PRD into user stories (prd.json)
- Shows you the command to run Ralph (you run it yourself)
After setup, you run:
bun run .claude/ralph/ralph.sh -f <feature-name>
</quick_start>
<critical_rule> ð NEVER run ralph.sh or any execution commands automatically ð NEVER execute the loop – only set up files and show instructions â ALWAYS let the user copy and run commands themselves â ALWAYS end by showing the exact command to run </critical_rule>
<when_to_use> Use this skill when:
- Starting a new feature that can be broken into small stories
- Setting up Ralph in a new project
- Creating a new feature PRD interactively
Don’t use for:
- Simple single-file changes
- Exploratory work without clear requirements
- Major refactors without acceptance criteria </when_to_use>
Examples:
/setup-ralph /path/to/project -i # Interactive PRD creation
/setup-ralph . -f 01-add-auth # Setup for specific feature
/setup-ralph -i -f 02-user-dashboard # Interactive with specific name
<state_variables>
| Variable | Type | Description |
|---|---|---|
{project_path} |
string | Absolute path to target project |
{ralph_dir} |
string | Path to .claude/ralph in project |
{feature_name} |
string | Feature folder name (e.g., 01-add-auth) |
{feature_dir} |
string | Path to task folder |
{interactive_mode} |
boolean | Whether to brainstorm PRD interactively |
{prd_content} |
string | PRD markdown content |
{user_stories} |
array | User stories extracted from PRD |
{branch_name} |
string | Git branch for the feature |
| </state_variables> |
<entry_point>
Load steps/step-00-init.md
</entry_point>
<step_files>
| Step | File | Purpose |
|---|---|---|
| 00 | step-00-init.md |
Parse flags, run setup script, create structure |
| 01 | step-01-interactive-prd.md |
Interactive PRD brainstorming and creation |
| 02 | step-02-create-stories.md |
Transform PRD into user stories (prd.json) |
| 03 | step-03-finish.md |
Show run command (user runs it themselves) |
| </step_files> |
<execution_rules>
- Progressive Loading: Load one step at a time
- Script Execution: Use scripts/setup.sh to create files atomically
- Interactive Mode: If -i flag, run brainstorming conversation
- State Persistence: Track progress in feature_dir/progress.txt
- Resume Support: Detect existing PRD.md and resume from there
- NEVER RUN RALPH: Only setup and show commands – user runs them </execution_rules>
<success_criteria> â Ralph structure created at {project_path}/.claude/ralph â Feature folder created with PRD.md, prd.json, progress.txt â User stories properly formatted in prd.json â Clear run command provided to user (they run it themselves) </success_criteria>