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

ralph-specum-design

GitHub

协调软件设计阶段，解析需求并委托子代理生成架构设计文档。负责状态管理、进度更新及用户审批流程，确保设计输出涵盖架构、接口与测试策略等关键要素。

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

Trigger Scenarios

用户显式请求使用 $ralph-specum-design 要求 Ralph Specum 运行设计阶段

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.