Agent Skills
› tzachbon/smart-ralph
› spec-workflow
spec-workflow
GitHub规范驱动开发工作流技能，支持从需求到实现的全流程。涵盖单功能规格生成、大型功能分解（Epic）、多阶段执行及状态管理，提供快速原型与引导式开发模式。
Trigger Scenarios
构建功能
创建规格说明
启动规范驱动开发
运行研究阶段
生成需求
创建设计
规划任务
实施规格
检查规格状态
分类功能
创建史诗故事
分解大型功能
Install
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
SKILL.md
Frontmatter
{
"name": "spec-workflow",
"version": "0.2.0",
"description": "This skill should be used when the user asks to \"build a feature\", \"create a spec\", \"start spec-driven development\", \"run research phase\", \"generate requirements\", \"create design\", \"plan tasks\", \"implement spec\", \"check spec status\", \"triage a feature\", \"create an epic\", \"decompose a large feature\", or needs guidance on spec-driven development workflow, phase ordering, or epic orchestration."
}
Spec Workflow
Spec-driven development transforms feature requests into structured specs through sequential phases, then executes them task-by-task.
Decision Tree: Where to Start
| Situation | Command |
|---|---|
| New feature, want guidance | /ralph-specum:start <name> <goal> |
| New feature, skip interviews | /ralph-specum:start <name> <goal> --quick |
| Large feature needing decomposition | /ralph-specum:triage <goal> |
| Resume existing spec | /ralph-specum:start (auto-detects) |
| Jump to specific phase | /ralph-specum:<phase> |
Single Spec Flow
start/new -> research -> requirements -> design -> tasks -> implement
Each phase produces a markdown artifact in ./specs/<name>/. Normal mode pauses for approval between phases. Quick mode runs all phases then auto-starts execution.
Phase Commands
| Command | Agent | Output | Purpose |
|---|---|---|---|
/ralph-specum:research |
research-analyst | research.md | Explore feasibility, patterns, context |
/ralph-specum:requirements |
product-manager | requirements.md | User stories, acceptance criteria |
/ralph-specum:design |
architect-reviewer | design.md | Architecture, components, interfaces |
/ralph-specum:tasks |
task-planner | tasks.md | POC-first task breakdown |
/ralph-specum:implement |
spec-executor | commits | Autonomous task-by-task execution |
Epic Flow (Multi-Spec)
For features too large for a single spec, use epic triage to decompose into dependency-aware specs.
triage -> [spec-1, spec-2, spec-3...] -> implement each in order
Entry points:
/ralph-specum:triage <goal>-- create or resume an epic/ralph-specum:start-- detects active epics, suggests next unblocked spec
File structure:
specs/
_epics/<epic-name>/
epic.md # Triage output (vision, specs, dependency graph)
research.md # Exploration + validation research
.epic-state.json # Progress tracking across specs
.progress.md # Learnings and decisions
Management Commands
| Command | Purpose |
|---|---|
/ralph-specum:status |
Show all specs and progress |
/ralph-specum:switch <name> |
Change active spec |
/ralph-specum:cancel |
Cancel active execution |
/ralph-specum:refactor |
Update spec files after execution |
Common Workflows
Quick prototype
/ralph-specum:start my-feature "Build X" --quick
# Runs all phases automatically, starts execution
Guided development
/ralph-specum:start my-feature "Build X"
# Interactive interviews at each phase
# Review and approve each artifact
/ralph-specum:implement
Large feature
/ralph-specum:triage "Build entire auth system"
# Decomposes into: auth-core, auth-oauth, auth-rbac
/ralph-specum:start # Picks next unblocked spec
References
references/phase-transitions.md-- Detailed phase flow, state transitions, quick mode behavior, phase skipping
Version History
- 1b33202 Current 2026-07-05 09:17
