Agent Skills › tzachbon/smart-ralph › ralph-specum-implement

ralph-specum-implement

GitHub

协调器技能，仅在显式请求时触发。负责解析规范、重新计算任务计数并合并状态，随后将任务委托给 spec-executor 子代理执行，处理批处理、验证及状态持久化，直至完成或中断。

plugins/ralph-specum-codex/skills/ralph-specum-implement/SKILL.md tzachbon/smart-ralph

Trigger Scenarios

用户明确要求使用 $ralph-specum-implement 要求 Ralph Specum 在 Codex 中运行已批准任务的实现、快速模式或继续请求

Install

npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -g -y

More Options

Non-standard path

npx skills add https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-implement -g -y

Use without installing

npx skills use tzachbon/smart-ralph@ralph-specum-implement

指定 Agent (Claude Code)

npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -a claude-code -g -y

安装 repo 全部 skill

npx skills add tzachbon/smart-ralph --all -g -y

预览 repo 内 skill

npx skills add tzachbon/smart-ralph --list

SKILL.md

Frontmatter

{
    "name": "ralph-specum-implement",
    "metadata": {
        "action": "implement",
        "surface": "helper"
    },
    "description": "This skill should be used only when the user explicitly asks to use `$ralph-specum-implement`, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an explicit continue request."
}

Ralph Specum Implement

You are a coordinator, not an executor -- delegate each task to a spec-executor sub-agent.

Contract

Resolve the active spec by explicit path, exact name, or .current-spec
Require tasks.md
Recompute task counts from disk before execution
Merge state fields only
Remove .ralph-state.json only when all tasks are complete and verified

Action

Resolve the active spec. If none exists, stop.
Require tasks.md. Read .progress.md, current state, and current task markers.
Recompute task counters from disk: total, completed, and next_index.
Merge state for execution:
- phase: "execution"
- awaitingApproval: false
- totalTasks: total
- taskIndex: next_index
- preserve taskIteration, maxTaskIterations, globalIteration, maxGlobalIterations, commitSpec, and relatedSpecs
Delegate each task to a spec-executor sub-agent. Pass the task description, file targets, success criteria, and context from .progress.md. The sub-agent implements the task and outputs TASK_COMPLETE. Do NOT implement tasks yourself. Execute tasks in order until complete or blocked.
[P] tasks may batch only when file sets do not overlap and verification is independent.
[VERIFY] tasks stay in the same run and must produce explicit verification evidence.
Marker syntax must be explicitly present in tasks.md. If markers are absent, treat tasks as non-batchable by default.
VE tasks are valid quality tasks when the spec includes autonomous end-to-end verification.
Native task sync metadata should be preserved when present.
After each task or safe batch:

mark the checkbox
update .progress.md
merge the state update
use the task Commit line unless commits were explicitly disabled

On failure or interruption, persist the current state and stop with a resumable summary.
On full completion, remove .ralph-state.json and report completion.

Resume Rules

Resume from the persisted task state when execution was already in progress.
If disk state and task checkboxes disagree, prefer tasks.md for completion and repair state to match.
If approval is still pending for tasks, stop and get approval unless quick mode or explicit user direction says to continue.