傳說，西天王母生了二十三個女兒，其中最小的女兒名為叫瑤姬，她是最二十三個裡最優美和最伶俐的一個，因此深得父王母后及眾仙們的喜歡。

王母娘娘怕瑤姬在外受了委屈，便禁絕她外出嬉戲，要她留在西天瑤池中。但生性活躍的瑤姬卻不甘寥寂，時常的偷偷出外游山玩水，唱歌舞蹈，王母娘娘雖然多番教訓她，但瑤姬卻絕不剖析，於是王母娘娘便決議把瑤姬送往紫清闕，交給三元仙君管教。

三元仙君見到瑤姬標緻可人、且又聰穎過人，融會性高，十分喜悅，於是將轉變無限的仙術所有教給了她。瑤姬學成仙術，被王母娘娘封為雲華上宮夫人，主管教訓金童玉女的事情，並有一群侍女和六位侍臣伴在身旁。瑤姬不只把仙術全數授予金童玉女和眾侍臣，更經常與他們出外嬉戲。

一天，瑤姬率領着金童玉女與眾侍女婢臣出外嬉戲，他們來到巫山上空，忽見巫山上天昏地暗，飛沙走石；巫山一帶衡宇損毀，人畜着死傷無數。瑤姬仔細一看，原來是巫山上十二條惡龍在興波作浪。瑤姬瞥見惡龍胡作非為，便輕身上了雲頂，施放轟雷之術，把十二條惡龍打得筋骨碎裂，墜入山澗。

后羿射日 嫦娥奔月

於是，巫山又回復鎮靜。但，十二條惡龍的屍骸卻堵塞了長江裡頭的水道，釀成了三峽兩岸的崇山峻岭，云云，江水匯積了三峽，引致水災頻生。在人世的大禹聞訊趕來，指揮人們開道疏水，但山高石堅，水勢十分勐烈，治水方式絕不奏效，大禹苦無對策，只好坐在山上，看着滔滔洪水嘆息。

瑤姬見狀，便派遣了六位侍臣下界來輔助大禹。六位侍臣與大禹相見后，告明緣故原由，和大禹提出對策，便施法召換來天兵天將，用雷去炸開山石，用電去推來泥沙，用火去燒掉海藻，而大禹則泒遺屬下去挖河床。終於，鑿成了三峽河流，使滯留的洪水得以消退。

大禹為了答謝瑤姬的恩義，為向她討教治水的方式，便來到巫山參見瑤姬。瑤姬瞥見大禹言辭恭謹，又充滿了拯救萬民於水災的熱誠，便取出了一本黃綾寶卷送給大禹，書中不只紀錄了疏渠鑿道的方式，更有驅使虎豹、制服蛟龍的竅門，瑤姬又派遣了兩位侍臣助大禹治理洪水。

瑤姬在巫山停留多時，正想繼續西去嬉戲，豈料王母娘娘駕到，要瑤姬回宮成就終身大事。瑤姬不願依從，立意留在人世為眾人造福，她更化作了一座山峰，王母娘娘見委屈不來，只好獨自返回天庭。而瑤姬所化成的山峰，被後人稱作神女峰，她的侍臣亦釀成了巫山十二峰的其他諸峰，永遠守衛着瑤姬。