菜单
Generate and validate task metadata for Ralph parallel execution. Use when creating tasks.yaml v1 files, validating task dependencies, or checking mutex usage. Triggers on: create task metadata, validate tasks yaml, check task dependencies.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generate a Product Requirements Document (PRD) for a new feature. Use when planning a feature, starting a new project, or when asked to create a PRD. The PRD should be detailed enough for execution by AI agents across tools (Amp, Cursor, Codex, etc.). Triggers on: create a prd, write prd for, plan this feature, requirements for, spec out.
Convert PRDs to prd.json format for the Ralph autonomous agent system. Use when you have an existing PRD and need to convert it to Ralph's JSON format. Ralph may run via Amp, Cursor, Codex, or similar tools, so keep output tool-agnostic unless required. Triggers on: convert this prd, turn this into ralph format, create prd.json from this, ralph json.
Build and validate task DAGs for Ralph parallel execution. Use when planning execution order, detecting cycles, or explaining why tasks are blocked. Triggers on: plan dag, check dependencies, why is task blocked, execution order.
Merge task branches and resolve conflicts for Ralph parallel execution. Use when merging completed task branches or resolving git conflicts. Triggers on: merge branches, resolve conflict, integration merge.
Guidelines for implementing tasks safely in parallel execution. Use when working on a task in Ralph parallel mode to avoid conflicts. Triggers on: implement task safely, parallel mode, avoid conflicts.
Review integrated code for semantic and design issues. Use after merging task branches to detect inconsistencies. Triggers on: review integration, semantic review, check design consistency.
| name | task-metadata |
| description | Generate and validate task metadata for Ralph parallel execution. Use when creating tasks.yaml v1 files, validating task dependencies, or checking mutex usage. Triggers on: create task metadata, validate tasks yaml, check task dependencies. |
Create and validate task metadata for parallel-safe execution in Ralph.
tasks.yaml v1 metadataDo NOT: schedule tasks, merge branches, or review design.
version: 1
tasks:
- id: US-001
title: "Short descriptive title"
completed: false
dependsOn: [] # Array of task IDs that must complete first
mutex: [] # Array of mutex names from catalog
touches: [] # Optional: paths/globs this task modifies
contracts: # Optional: interface contracts
produces: []
consumes: []
mergeNotes: "" # Optional: hints for conflict resolution
verify: [] # Optional: verification commands
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier (e.g., US-001, TASK-1) |
title | string | Human-readable task name |
completed | boolean | Task completion status |
dependsOn | array | Task IDs that must complete before this one |
mutex | array | Mutex names from the catalog |
Valid mutex names (check mutex-catalog.json):
db-migrations - Database schema changeslockfile - Package lock files (package-lock.json, yarn.lock, etc.)router - Route configuration filesglobal-config - Global configuration filescontract:* - Interface contracts (e.g., contract:auth-api)When validating tasks.yaml:
version: 1 is presentid, title, completed, dependsOn, mutexid values are uniquedependsOn references exist as task IDsmutex values exist in catalog✓ tasks.yaml v1 valid
- 5 tasks
- 3 unique mutex
- 2 dependency chains
✗ tasks.yaml validation failed:
- Line 12: Duplicate id "US-001"
- Line 25: dependsOn "US-999" not found
- Line 30: Unknown mutex "invalid-mutex"
- Cycle detected: US-002 → US-003 → US-002
Input request: "Create metadata for a user auth feature"
Output:
version: 1
tasks:
- id: AUTH-001
title: Add users table migration
completed: false
dependsOn: []
mutex: ["db-migrations"]
touches: ["db/migrations/**"]
- id: AUTH-002
title: Create auth middleware
completed: false
dependsOn: ["AUTH-001"]
mutex: ["contract:auth-api"]
touches: ["src/auth/**"]
contracts:
produces: ["contract:auth-api"]
consumes: []