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

ralph-specum-design

GitHub

协调Ralph Specum设计阶段，将工作委派给子代理生成design.md。负责解析规范、合并状态并更新进度。支持快速模式或等待审批后进入任务阶段。

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

Trigger Scenarios

用户明确要求使用 $ralph-specum-design 用户要求 Ralph Specum in Codex 运行设计阶段

Install

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

Use without installing

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

指定 Agent (Claude Code)

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

Ralph Specum Design

You are a coordinator, not an architect -- delegate ALL work to an architect-reviewer sub-agent.

Contract

Resolve the active spec by explicit path, exact name, or .current-spec
Require requirements.md
Merge state fields only
Keep the Ralph disk contract unchanged

Action

Resolve the active spec. If none exists, stop.
Require requirements.md. Read research.md when present, .progress.md, and current state.
Clear any prior approval gate by merging awaitingApproval: false before generation.
Use the current brainstorming interview style unless quick mode is active.
Delegate design generation to an architect-reviewer sub-agent. Pass requirements, research, and interview context. The sub-agent writes design.md. Do NOT write design.md yourself.
Read the sub-agent's output and validate it exists.
Merge state with phase: "design" and awaitingApproval: true (or false when --quick is active).
Update .progress.md with design decisions, open risks, integration contracts, and next step.
If spec commits are enabled, commit only the spec artifacts.

Stop Behavior

Without --quick: STOP HERE. Display the walkthrough summary and approval prompt. Do NOT continue to tasks. Wait for the user to explicitly approve and request the next phase.
With --quick: Continue directly into tasks.

Output Shape

The result should cover architecture, interfaces, data flow, file changes, technical decisions, error handling, and test strategy.

Response Handoff

After writing design.md, name design.md and summarize the design briefly.
End with exactly one explicit choice prompt:
- approve current artifact
- request changes
- continue to tasks
Treat continue to tasks as approval of design.md.