前言¶
在金蝶雲星空(Kingdee Cloud Galaxy)上做二次開發,報表是最常碰的一塊,也是最容易反覆踩坑的一塊。同一張銷售彙總表,可以用直接 SQL 賬表做,也可以用單據報表、動態表單報表或 RDL 報表做,選型錯了後面全是返工;取數 SQL 寫出來跑不通、過濾條件和參數設計不合理、組織權限和數據範圍沒控制好導致越權或取不到數,這些問題在社區裏被反覆問。下面介紹的這個 Skill,就是把這類報表開發問題整理成結構化指導,供 AI 編程工具在開發或排查報表時調用。
這是什麼¶
金蝶雲星空報表開發助手,是一個面向金蝶雲星空二次開發者的報表開發指導技能(Skill),基於通用的 SKILL.md 格式發佈。
- 名稱:金蝶雲星空報表開發助手
- 座標:
@user_133a75db/kingdee-report-development - 版本:1.0.0
- 來源:community(社區發佈,非官方廠商出品)
- 發佈者:user_133a75db
- 分類:dev-programming
- 標籤:
requires_api_key=false,即使用時不需要 API Key
它解決的問題不是替你寫完整報表,而是在你開發或排查報表時給出開發指導:幫你選型、幫你理清取數 SQL 的寫法思路、提醒你權限和數據範圍的控制點、以及排查取不到數這類報錯。
截至 2026-10-30,SkillHub 頁面顯示評分 100000、下載 1702 次。
核心功能¶
根據官方簡介,這個 Skill 覆蓋的能力範圍如下。
1、報表類型選型。在直接 SQL 賬表、單據報表、動態表單報表、RDL 報表之間做選擇,這是後續所有工作的前提。
2、取數 SQL 編寫。針對賬表類報表,指導如何寫取數 SQL。
3、過濾條件與參數設計。報表上的過濾條件怎麼設計、參數怎麼傳遞。
4、組織權限與數據範圍控制。按組織維度控制報表可見範圍和數據範圍,這是星空報表最常見的權限訴求。
5、報表函數與取數插件。涉及報表函數以及取數插件的使用。
6、報錯排查。例如「報表取不到數怎麼辦」這類實際排錯場景。
安裝與啓用¶
官方頁面未公開提供 curl、npm 之類的一鍵安裝命令,因此這裏不編造命令。已覈實的信息只有座標、版本、來源、分類和標籤,你在 SkillHub 頁面上看到的就是這些。
該 Skill 以通用 SKILL.md 格式發佈,通常的啓用方式是把技能目錄放到所用客戶端的技能目錄下再重啓客戶端,具體目錄名和加載方式以你所用客戶端(Cursor、Codex CLI、Claude Code 等)的文檔爲準,使用前建議先在 SkillHub 頁面確認最新的安裝說明。
由於標籤爲 requires_api_key=false,啓用後不需要配置 API Key,這一點可以先確認掉,避免多餘配置。
典型用法¶
這個 Skill 的調用方式是:在開發報表遇到問題時,把訴求直接講給接入了該 Skill 的 AI 編程工具。以下示例均來自官方簡介中列出的典型問題。
1、選型與完整開發:
怎麼做一張銷售彙總表
2、取數 SQL 寫法:
賬表SQL怎麼寫
3、權限與數據範圍:
報表怎麼按組織控制權限
4、排錯:
報表取不到數怎麼辦
實際使用時,建議把背景講清楚再提問,例如說明報表用途、涉及的組織範圍、期望的過濾條件。信息越具體,得到的指導越貼近你的場景。
適用場景與注意¶
適合誰:在金蝶雲星空上做二次開發、需要開發或排查報表的開發者,尤其是對報表類型選型和數據範圍控制還不熟悉的人。
幾點注意:
1、它是指導型 Skill,輸出的是開發思路和檢查項,不是自動生成的成品報表,SQL 和配置仍需自己落地並測試。
2、來源標註爲 community,屬於社區發佈,不是金蝶官方出品,關鍵語法和版本行爲建議與你所處星空版本的官方文檔交叉確認。
3、當前版本爲 1.0.0,覆蓋範圍以官方簡介列出的六項爲準,超出這些範圍的問題(例如單據插件開發、UI 模板設計)不在其承諾範圍內。
4、標籤顯示不需要 API Key,但仍需確認你的客戶端支持 SKILL.md 格式的技能加載。
結尾¶
這個 Skill 的價值在於把金蝶雲星空報表開發裏高頻的選型、SQL、權限、排錯問題收斂成一套可調用的指導,省去在社區裏零散搜索的時間。如果你正在做星空報表開發,可以從選型問題開始試一次。
官方地址:https://api.skillhub.cn/user_133a75db/kingdee-report-development