Communitygithub.com

itda-rs/skills

用於視覺化杜拜房地產數據(來自「부동산 실거래」/realty MCP 工具)— 圖表、表格、地圖、比較、趨勢、市場摘要。當使用者要求繪製杜拜行情、實價登錄、比較、趨勢、地圖,或需要將 realty MCP 工具結果(get_market, compare_places, screen_communities, get_monthly_trend, get_boundaries, search_transactions)轉換為圖形時使用。

skills 是什麼?

這是一個為 AI 代理(如 Claude Code、Cursor、Codex)設計的專業技能,專門用於將杜拜房地產市場數據(透過「부동산 실거래」/realty MCP 工具取得)轉換為視覺化圖形。它能處理包括市場比較、社區篩選、月趨勢、邊界地圖和交易搜尋在內的多種資料。核心原則是嚴格依賴工具回應中的原始數字,不得自行計算中位數、平均值或比率,並在樣本不足時以灰色佔位符明確標示。支援多種輸出格式:Claude.ai 的 HTML/SVG 或 React 成品、Claude Code/Codex 的獨立 HTML 檔案,以及僅文字環境的 Markdown 表格。此外,技能強制執行資料來源歸屬、禁止投資建議陳述,並區分預售(offplan)與成屋(ready)數據,確保視覺化的準確性與合規性。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/itda-rs/skills/tree/HEAD/plugins/realty-dubai/skills/realty-dubai-viz

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

杜拜實價登錄視覺化 (realty MCP)

realty MCP 提供數字,而此技能定義繪製方法。圖形只是表達方式,不會改變數值。

絕對規則

  1. 數字僅使用工具回應的值。 不重新計算中位數、平均數、比率或總和。僅允許顯示用四捨五入。
    • 例外:允許進行軸範圍、條形長度等繪圖用座標計算。但不得將這些計算結果寫成數字。
  2. 若值為 null 或 low_sample=1/true,則繪製為「樣本不足」:灰色(#46534e)區塊、空白條形、斷裂線條。不得用其他期間或區域的值填補或內插。n 值照常顯示。
  3. 所有圖形必須附上標題(以靜態 HTML 文字撰寫。不使用 JS 繪製 — 即使圖形失敗,來源資訊也必須保留):來源:DLD 實價登錄(data.dubai, <source.sales_dataset>) · 基準日 <source.data_as_of> · n=<值> · 期間 <filters.months> 個月 + 「非杜拜政府官方服務 · 非投資建議」。地圖需加上 attribution(DM Communities 邊界 · © OpenStreetMap contributors)。
  4. 預售(offplan)與成屋(ready)分開繪製。 行情工具需分別以 registration="offplan" 和 "ready" 呼叫。 若有理由合計(registration=all)繪製,需在標題註明「預售·成屋合計」,並在同一處以表格同時呈現預售與成屋的值。 對於不是分開發布的月趨勢(get_monthly_trend),需註明「非按預售·成屋區分發布」。
  5. 實價登錄·租賃·層級(管理費·屋齡等)·使用者出價不得混在同一個軸或同一列中。 若出現估價,則以「估價」另行繪製。
  6. unavailable_dimensions 中的維度應標示為「未發布」,不得用其他值替代。
  7. 禁止投資判斷表述:不得使用「便宜·低估·推薦·買進」,應僅陳述發布值如「每平方公尺中位數較低·變動率 +x%」。排名需說明為使用者自訂的排序標準。
  8. 繪製後進行自我對照:逐一核對圖形·表格中的數字與工具回應,若不一致則修正。在回應結尾新增一行「數字對照:N 個一致」。

哪種工具 → 哪種圖形

  • compare_places / get_market 多處 → 水平條形圖:條形 = med_aed_sqm,細線 = p25_aed_sqm~p75_aed_sqm,條形末端標籤 n=…。預售/成屋以並列雙條形表示(而非顏色)。
  • get_monthly_trend → 折線圖:available=false 或 null 的月份斷線並使用灰色點 + 「樣本不足」。包含 partial_days 的最後一個月以虛線 + 「部分月份(1日~基準日)」表示。
  • screen_communities → 先顯示表格,再顯示條形圖。在表格下方標示篩除數量(excluded_low_sample、excluded_no_value)。
  • get_boundaries (+ 同一區域的值) → SVG 面量圖。遵循 references/choropleth.md。不使用外部圖磚、字型或 CDN。
  • search_transactions → 表格(交易 ID·日期·面積·價格·每平方公尺單價)。最多 20 行。不得完整轉錄原始資料(禁止重新分發)。
  • 市場摘要一頁 → references/one-pager.md。

顏色(與網頁地圖 realty.rs.itda.work 一致)

  • 順序(單價·收益率):#dcebd7 → #a6c9ad → #598f76 → #23594b(4 區間)。樣本不足·無值 #46534e。
  • 變動率(發散):下跌 #386fa4 · 持平 #edf0e9 · 上漲 #b64c39。
  • 區間邊界使用回應中的 p25·中位數·p75 等發布值。若回應中無此類值,不重新計算四分位數,而是在標題中註明「區間:以此圖數值範圍四等分(繪圖用)」。

格式

  • claude.ai:HTML/SVG 或 React 成品。無外部資源,自含完整。
  • Claude Code·Codex:一個自含完整 HTML 檔案(內嵌 SVG)。告知儲存路徑。
  • 僅文字環境:Markdown 表格 + 來源註腳。
  • 單位:預設 AED/㎡,必要時附上 AED/sqft(med_aed_sqft)。不使用貨幣符號,直接使用「AED」。
  • 不使用計數動畫(count-up)·3D 條形·雙軸。

傳送給其他 AI 時(資訊圖表等)

附上一張完整轉錄所用數字的 Markdown 表格,包含「來源 · 基準日 · n」欄位,並在表格最下方註明「以實價登錄登記為準 · 非掛牌價 · 非投資建議 · 禁止更改數值」。

相關技能