AgentSkillsCN

ralph-driven-development-linear

Ralph Driven Development 工作流，通过 Linear MCP 拉取 Linear 项目中的问题，并借助 Codex 依次执行这些问题。当您需要从 Linear 项目中自动化任务执行，或希望有一套能够自动推进问题进展、并自动提示下一任务的运行器时，可使用本技能。

SKILL.md
--- frontmatter
name: ralph-driven-development-linear
description: Ralph Driven Development workflow that pulls Linear project issues via the Linear MCP and runs them sequentially with Codex. Use when automating task execution from a Linear project and when you need a runner that advances issues and asks for the next task automatically.

Ralph Driven Development (Linear)

Description and Goals

This skill provides a Ralph Driven Development workflow that pulls Linear project issues via the Linear MCP and runs them sequentially with Codex. It automates task execution from a Linear project and advances issues automatically.

Goals

  • •Automate development workflow using Linear project issues
  • •Integrate with Linear MCP for issue management
  • •Run Codex agents sequentially against Linear issues
  • •Track progress and handle retries automatically
  • •Support customizable runner configuration

What This Skill Should Do

When automating task execution from a Linear project, this skill should:

  1. •Connect to Linear - Authenticate with Linear MCP and resolve project
  2. •Fetch issues - Pull issues from the specified Linear project
  3. •Execute sequentially - Run Codex against each issue in order
  4. •Track progress - Monitor completion and handle retries
  5. •Advance issues - Automatically move to the next issue after completion

Use this skill when automating task execution from a Linear project and when you need a runner that advances issues and asks for the next task automatically.

Information About the Skill

Prerequisites

  • •codex is on PATH.
  • •Linear MCP is authenticated: codex mcp login linear
  • •Provide a project via --project or AGENTS.MD.

Run

bash
python scripts/ralph-linear.py --project "Project Name"

Flags

  • •--project Linear project name or ID. If omitted, reads Linear Project: under ## PROJECT in AGENTS.MD.
  • •--agents-path Path to AGENTS.MD. Default: AGENTS.MD.
  • •--codex-exe Codex executable name or path. Default: codex.
  • •--codex-args Space-separated Codex args string. Default: exec --dangerously-bypass-approvals-and-sandbox.
  • •--codex-timeout Seconds before killing a Codex run; 0 = unlimited. Default: 0.
  • •--max-tasks Max issues to process; 0 = unlimited. Default: 0.
  • •--max-attempts-per-task Retries per issue. Default: 5.
  • •--log-path Log file path (repo-relative or absolute). Default: docs/logs/linear.log.
  • •--dry-run Resolve project and exit without running Codex.

Examples

bash
python scripts/ralph-linear.py --project "VisionOS Agents" --max-tasks 3
bash
python scripts/ralph-linear.py \
  --project "VisionOS Agents" \
  --codex-args 'exec --full-auto -m gpt-5.2-codex'