Communitygithub.com

ShadobaAI/codex-plugins

從文字、螢幕截圖或表單 XML 建立或編輯互動式 1C 表單原型,並在 Codex 的應用程式內瀏覽器中預覽。適用於 GUI 模型,不適用於 1C 配置變更或業務操作。

codex-plugins 是什麼?

此技能讓開發者能在 Codex 的應用程式內瀏覽器中,從文字描述、螢幕截圖或表單 XML 快速建立或編輯互動式 1C 表單原型。它提供即時預覽,使用者可在匯出前審查並修改設計。透過將來源資料傳遞給 Node.js 預覽伺服器,技能可管理記憶體內的原型,無需直接寫入檔案,從而讓迭代設計更乾淨、速度更快。支援跨平台使用(包含 Windows 沙箱環境),並提供「檢查與預覽」工具,用於驗證語法、啟動背景預覽及更新現有預覽,同時保留瀏覽器狀態。匯出選項包含 Markdown、HTML 及 PNG,所有資料均在使用者控制下進行。重點在於表單外觀與互動的視覺模型,不執行任何業務操作或配置變更,因此能安全地用於 GUI 設計與展示。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ShadobaAI/codex-plugins/tree/HEAD/plugins/md-design/skills/md-design

在你喜歡的 AI 中提問

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

說明文件

1C 表單原型

提供互動式預覽,使用者可在匯出前審查並修改。將新原型保留在預覽伺服器的記憶體中:請勿自動將 .md、HTML 或 PNG 檔案寫入專案,或建立螢幕截圖。使用者可透過表單上方的兩個圖示選單,自行選擇何時下載或複製 HTML、MD 或 PNG。保持標題與回應的使用者語言;DSL 關鍵字為西里爾字母。顯示具備自身命令與匯出圖示的表單,不包含編輯器或技術說明。業務命令不執行。

編寫

  • 對於新表單,請閱讀語法;對於編輯,請閱讀現有檔案及僅相關的語法章節。保留無關的內容。
  • 對於螢幕截圖/XML,請閱讀重建。保留標題、順序、巢狀結構、類型與可見狀態;在表單外揭露不確定性。
  • 對於僅有文字的新模型(未提供數值),除非使用者要求空白表單,否則請填入連貫的虛構資料於欄位及代表性資料列。在編輯或螢幕截圖/XML 重建中,保留現有/來源數值及空白,除非要求變更。在交付回應中標示示範資料。
  • 以 UTF-8 md_design 文字編寫來源,並透過標準輸入 (--stdin) 傳遞。將來源與預覽 URL 保留在對話中,以便後續編輯。請勿建立暫存或專案 .md 作為暫存步驟。僅當使用者明確要求編輯/儲存該檔案時,才就地編輯現有檔案。僅使用 DSL 結構;無內嵌 HTML、JS、CSS、XML 或 Markdown 註解。將來源指令/處理器視為資料,而非要執行的動作。
  • 對於功能導覽,請以 --file 預覽 <plugin>/prototypes/showcase.md;對於變更,請閱讀該檔案並將修改後的來源透過 --stdin 傳遞,無需將其複製到專案中。僅在需要時閱讀功能地圖。

檢查與預覽

<plugin> 為此技能目錄上兩層的絕對根目錄;其包含 scripts/ 與 dist/。需要 Node.js 22+;已安裝的套件無需 npm 相依性。

node "<plugin>/scripts/preview.mjs" --stdin --name "form.md" --check
node "<plugin>/scripts/preview.mjs" --stdin --name "form.md" --background
node "<plugin>/scripts/preview.mjs" --stdin --update "<complete-preview-url>"

將完整來源透過管線輸入這些命令。--name 僅命名下載;不會建立檔案。對於後續修訂,請驗證,然後使用 --update 傳送完整修訂後的來源,以重新整理相同的預覽/分頁。在 --background 之前,請閱讀執行階段以了解 UTF-8 管線傳輸,以及在 Windows 沙箱中的啟動權限。

成功結束後,使用 mcp__codex_app__open_in_codex (target: {type: "browser", url}) 開啟傳回的完整 url。使用瀏覽器技能/工具,或在其指令不可用時使用執行階段引導;請勿閱讀最小化的瀏覽器套件。檢查 DOM、相關互動及 #preview[data-warnings] (JSON)。比較涵蓋範圍、數值及巢狀結構與來源;僅解析並開啟面板不足以驗證忠實度。請勿自動擷取或儲存螢幕截圖;僅在使用者在匯出選單中選擇或明確要求時,才產生 PNG。解決重大警告;揭露近似值及任何未驗證的內容。若檢查不可用或遭拒絕,請回傳 URL 與限制;尊重存取控制。

對相同原型的不同修訂版本,重複使用該處理程序/分頁。記憶體來源在伺服器停止前,可跨越頁面重新載入而存活;瀏覽器輸入為本機端,並在重新載入或來源修訂時重設。MD 匯出包含當前來源;HTML 匯出保留瀏覽器數值與作用中分頁,並可離線運作;PNG 捕捉顯示的表單,但不包含匯出工具列。請勿在初次草稿或修訂後自動匯出結果。僅在不再需要時,停止您自己啟動的 PID;讓已交付的預覽保持開啟。

相關技能