Communitygithub.com

astriaai/skills

用於編輯、更新或迭代工作區登陸頁面 HTML(雜誌風格的 /w/:slug 頁面)。支援增量編輯 — 擷取當前 HTML,進行局部修改,再寫回。不適用於初次生成 — 初始生成來自透過伺服器端 `LANDING_PAGE_PROMPT` 對 Gemini 提交的 `brief`。

skills 是什麼?

此技能提供「工作區登陸頁面編輯器」,用於編輯、更新或迭代 Astria 平台中工作區的雜誌風格登陸頁面(路由為 `/w/:slug`)。登陸頁面儲存在單一的 HTML blob 中,透過 `brief` 欄位提交時,伺服器端的 `LANDING_PAGE_PROMPT` 會從頭生成整個頁面。此技能專注於不重新生成完整頁面的情況下進行增量修改,例如調整排版、佈局、新增區塊、修改文案、更換圖片或修正標語。所有操作都透過 `astria` 命令列界面進行,使用 `-w <workspace_id>` 指定目標工作區。技能強調保持嚴格的約束條件,例如輸出僅為 body 內 HTML、使用 Tailwind 工具類別、正確處理套件/模型連結,以及保留 `__TUNES_JSON_PAYLOAD__` 伺服器端佔位符。工作流程包含三個步驟:擷取當前 HTML、執行局部編輯、寫回更新後的 HTML,最後透過瀏覽 `/w/{slug}` 驗證變更。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/astriaai/skills/tree/HEAD/landing-page-editor

在你喜歡的 AI 中提問

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

預覽

來自技能 README

說明文件

工作區登陸頁面編輯器

工作區登陸頁面(渲染在 /w/:slug)是儲存在 workspace.landing_page_html 中的單一自包含 HTML blob。當提交 brief 時,伺服器端的 LANDING_PAGE_PROMPT 會從頭生成它 — 該路徑會完全覆蓋 HTML。

對於任何不應重新生成整個頁面的變更(排版調整、佈局編輯、新增區塊、修改文案、更換圖片、修正標語),請直接編輯 HTML 並將其寫回。除非使用者希望完全重新生成,否則不要發送 brief。

所有命令都使用 astria 命令列界面(請參閱 astria-api 技能)。使用 -w <workspace_id> 來指定目標工作區。

從 LANDING_PAGE_PROMPT 繼承的約束條件

編輯時,請保留這些不變項(即時 /w/:slug 頁面依賴於它們):

  • 輸出是 body 內 HTML — 不要包含 <html>、<head>、<body> 或 <!DOCTYPE> 標籤
  • 樣式使用 Tailwind 工具類別(已載入在頁面上)。僅針對 Tailwind 無法表達的懸停/動畫效果使用 <style>
  • 套件連結格式為 /p/{slug};模型/參考連結直接使用 tunes JSON 中的 link 欄位(不要重新編碼 %5B/%5D)
  • 每個圖片/影片都包裹在 <a> 標籤中
  • 圖片和影片 URL 必須是已存在的 — 不要憑空發明 URL
  • 影片使用 <video autoplay muted loop playsinline poster="POSTER_URL"><source src="VIDEO_URL" type="video/mp4"></video>
  • 在 <script type="application/json" id="tunes-data">…</script> 中的字串 __TUNES_JSON_PAYLOAD__ 是一個伺服器端佔位符。伺服器在渲染時會用實際的 tunes JSON 替換它。永遠不要用實際 JSON 取代它 — 這樣會凍結演員陣容,新加入的 tunes 將不會顯示
  • 編輯風格:襯線標題、寬裕的空白、細線規則、人像圖片使用 object-cover object-[center_top]、主視覺跨頁使用 max-h-[70vh]、人像容器使用 aspect-[4/5] 或 aspect-[3/4]

工作流程

1. 擷取目前的登陸頁面 HTML

astria landing get -w <workspace_id> --html > /tmp/landing_page.html

astria landing get -w <workspace_id>(不加 --html)會傳回完整的工作區 JSON — title、slug、brief、url、public_at、unlisted_at — 當你需要這些資訊時使用。在 /w/{slug} 預覽渲染後的頁面。

2. 拉取工作區資料(當編輯需要參考實際的套件/提示/tunes 時)

astria packs list -w <workspace_id> --limit 100
astria tunes list -w <workspace_id> --limit 200            # 在頁面上渲染的「演員陣容」
astria prompts list -w <workspace_id> --limit 100 --offset 0   # 使用 --offset 分頁直到無資料
astria prompts list -w <workspace_id> --pack-id <pack_id>      # 較節省資源,一次一個區塊

列表端點透過 --limit/--offset 進行分頁(預設排序為 id 降冪)。使用 --offset 迴圈,直到某個分頁回傳空數據。

3. 執行增量編輯

在本機編輯 /tmp/landing_page.html。保持修改精確 — 生成器產生了數千位元組的版面配置,其中大部分應保持不變。在儲存之前,請重新閱讀上述的約束條件章節。

4. 將頁面寫回

astria landing set -w <workspace_id> --html-file /tmp/landing_page.html

這裡不要傳遞 --brief — 那樣會捨棄你的編輯並透過 Gemini 從頭重新生成。

5. 驗證

開啟 /w/{slug} 並視覺確認變更。__TUNES_JSON_PAYLOAD__ 佔位符會在渲染時由伺服器端替換 — 如果渲染後的頁面上仍然顯示一個類似 JSON 的字串,表示佔位符被意外刪除或重新命名了。

從頭重新生成

僅當使用者明確要求完全重新設計時 — 提交一個 brief,伺服器會對 Gemini 執行 LANDING_PAGE_PROMPT,覆寫 HTML:

astria landing set -w <workspace_id> \
  --brief "Editorial fashion lookbook, AW26, dark moody palette, emphasize the womenswear packs"

相關技能