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

ralph-specum-help

GitHub

用于解释 Codex 中 Ralph Specum 的工作流与技能体系。在用户显式请求帮助或提及 `$ralph-specum-help` 时触发，指导用户选择入口、理解审批流程及阶段控制。

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

Trigger Scenarios

用户明确询问 Ralph Specum 的帮助或命令指南用户显式调用 `$ralph-specum-help`

Install

npx skills add tzachbon/smart-ralph --skill ralph-specum-help -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-help -g -y

Use without installing

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

指定 Agent (Claude Code)

npx skills add tzachbon/smart-ralph --skill ralph-specum-help -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-help",
    "metadata": {
        "action": "help",
        "surface": "helper"
    },
    "description": "This skill should be used only when the user explicitly asks to use `$ralph-specum-help`, or explicitly asks Ralph Specum in Codex for help or command guidance."
}

Ralph Specum Help

Use this to explain the Ralph Specum surface in Codex.

Cover

Primary skill: $ralph-specum
Helper skills: $ralph-specum-start, $ralph-specum-triage, $ralph-specum-research, $ralph-specum-requirements, $ralph-specum-design, $ralph-specum-tasks, $ralph-specum-implement, $ralph-specum-status, $ralph-specum-switch, $ralph-specum-cancel, $ralph-specum-index, $ralph-specum-refactor, $ralph-specum-feedback, $ralph-specum-help
Normal flow: start, stop, research, approval, requirements, approval, design, approval, tasks, approval, implement
Large effort flow: triage, then start each unblocked spec
Quick mode: generate missing artifacts and continue into implementation in one run only when the user explicitly asks for quick or autonomous flow
Disk contract: ./specs or configured roots, .current-spec, optional .current-epic, per-spec markdown files, .ralph-state.json

Guidance

Recommend $ralph-specum as the default entrypoint.
Recommend $ralph-specum-triage when the user describes a large, multi-part, or dependency-heavy effort.
Mention helper skills when the user wants explicit phase control.
Explain that Ralph does not self-advance by default. The user must approve the current artifact, request changes, or explicitly continue to the next step.
Mention optional bootstrap assets only when the user wants repo-local guidance.