Communitygithub.com

Francixco90/metodologia-frames-agent-os

當使用者要求「建立研討會路線登陸頁面」、「編譯多語言研討會漏斗」、「建置八區塊訓練登陸頁面」、「產生可列印無JS路線頁面」或「根據規格驗證研討會登陸頁面」時,應使用此技能。

metodologia-frames-agent-os 是什麼?

此技能專門用於根據結構化規格編譯通用的培訓路線登陸頁面。它遵循嚴格的八區塊順序(entry、tension、route、method、resources、outcomes、trust、invitation),並支援 ES(西班牙語)、EN(英語)和 PT(葡萄牙語)三語對等。技能會從規格中計算出唯一的 hash 值,然後產生完全自包含的 HTML,內嵌 SVG 作為 CTA 裝飾,不使用 JavaScript、外部資源、追蹤或表單。最後透過 schema 驗證、hash 比對、區塊數量檢查、語言對等性、資源狀態以及跨處理程序位元組一致性來確保輸出正確。此技能在 Cursor、Claude Code 和 Codex 等 AI 代理平台上運作,適合需要快速建立符合規範、無依賴且離線可用的培訓路線登陸頁面的開發人員。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Francixco90/metodologia-frames-agent-os/tree/HEAD/03_artefactos/skills/metodologia-workshop-route-landing-html

在你喜歡的 AI 中提問

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

說明文件

MetodologIA 研討會路線登陸頁面 HTML

從結構化規格編譯通用的培訓路線登陸頁面。 將課程內容保留在技能之外:此能力提供契約、合成渲染器和驗證,而非實際的活動或發布權限。

運作流程

  1. 規格 (Spec)。建立 workshop-route-landing-spec-v1,包含正好八個區塊,ES/EN/PT 語言對等,design-system 鎖定為 hash-bound,CTA 為一至三個詞,資源宣告為 available 或 pending。透過 sha256-canonical-json-v1 計算 specSha256,僅排除該欄位。
  2. 編譯 (Compile)。僅使用驗證通過的規格。跳脫所有內容,保留宣告順序,產生自包含的 HTML、manifest 和 receipt。在 CTA 中使用內嵌 SVG;不使用網路、時鐘、隨機性、追蹤、表單或遠端依賴。
  3. 驗證 (Verify)。驗證 schema、hash、八個區塊、語言對等、資源狀態、相對連結、無 JavaScript、可列印、原生鍵盤支援以及兩次跨處理程序位元組一致的編譯結果。
  4. 審查 (Review)。保留 RENDERED_DRAFT 和 candidate。記錄 coverage_gap,直到 Verifier、Guardian 和 H01 完成獨立的閘門檢查。不發布。

不變條件

  • 僅使用:entry、tension、route、method、resources、outcomes、trust、invitation,依此順序。
  • 在 ES、EN 和 PT 之間保持等價的 ID 和順序;翻譯文字,絕不翻譯 ID。
  • 將每個可見 CTA 限制為一、二或三個詞,並搭配內嵌的 SVG 裝飾性動作連結。
  • 僅為 available 的資源顯示連結;pending 的資源應呈現無 href 且無虛假動作。
  • 不使用 JavaScript 的情況下保留內容、導覽和可用資源。使用具備可見焦點的原生 HTML 連結和控制項。
  • 列印時隱藏導覽和 CTA,但不遺失八個區塊的內容。
  • 阻擋絕對路徑、私有定位器、編輯 URL、無權限的素材、表單、遙測以及任何 READY 或 PUBLISHED 的意圖。
  • 從規格重新產生;絕不手動修正已編譯的 HTML。

指令

node skills/metodologia-workshop-route-landing-html/scripts/compile-fixture.mjs \
  skills/metodologia-workshop-route-landing-html/fixtures/positive/valid-spec.json \
  <輸出目錄>
node skills/metodologia-workshop-route-landing-html/scripts/check-skill.mjs

在調整渲染器之前,請先閱讀 references/operating-contract.md。 查閱 references/capability-boundary.yml 以了解執行限制。 此技能不會請求網路或發布。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能