Communitygithub.com

FelipeStruchel/landing-page-skills

用於當 Felipe 要求建立、組裝、重做或繼續為某個業務或客戶製作登陸頁面或單頁網站,或是在 criar-site/ 中開啟客戶資料夾時使用。不適用於重新設計技能本身(landing-evoluir-skill)。

landing-page-skills 是什麼?

這是一個用於建立登陸頁面的 AI 代理技能,專為 Felipe 的工作流程設計。它將整個流程組織成多個階段(如發現、視覺方向、計畫、執行、審查和發布),每個階段之前都必須通過嚴格的「閘門」(gate)檢查,確保前一階段獲得明確批准後才能繼續。該技能強調「磁碟是真相的唯一來源」,要求代理始終讀取檔案而非依賴對話記憶,並且維護一個鐵律:沒有任何階段可以在前一階段的閘門未獲批准的情況下開始。技能的嚴格程度與風險成正比:低風險的調整可以直接執行,中高風險的變更則需要重新打開閘門或獲得命令式批准。支援的平台包括 Claude Code 或其他配備 command 與 file I/O 能力的 AI 代理。此外,技能內建了「紅旗」警告機制,防止代理走捷徑或偽造批准狀態。

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

在你喜歡的 AI 中提問

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

說明文件

建立登陸頁面(Criar landing page)

協調多個階段與閘門。磁碟是真相的唯一來源;對話記憶不是。 違反文字即違反精神。

鐵律(Iron Law)

沒有任何階段可以在前一階段的閘門未獲批准的情況下開始
check-gate 的退出碼 ≠ 0,或沒有輸出,即視為未通過

資料目錄:~/projetos/criar-site/(CRIAR_SITE_ROOT)。工具包與命令:~/.claude/skills/criar-landing-page/assets/kit/README.md。模板目錄:assets/modelos/。必備子技能: landing-registrar-feedback 在所有階段均適用。

步驟 0(啟動或繼續處理客戶時必做;低風險調整且在已批准階段內可省略)

  1. test -f ~/projetos/criar-site/_regras-vivas.md
  2. 如果檔案不存在:停下來並詢問:「看起來初始遷移尚未完成。您希望我現在觸發 landing-evoluir-skill 來根據 criar-site/ 的歷史記錄產生 _regras-vivas.md 嗎?」如果回答「是」:必備子技能: 使用 landing-evoluir-skill(遷移模式),然後返回步驟 1。
  3. 如果檔案存在:完整讀取,定義專案標籤,執行 node check-regras.js --file <regras> --tags <tags> --listar,將 ID 記錄到 01 中,並用一行說明哪些規則適用於此客戶。

閘門函式(Gate Function)

在每個階段之前:

  1. node check-gate.js --cliente <nome> --antes-de <fase>
  2. 讀取該階段的輸入檔案(絕不依賴記憶)。
  3. 執行該階段。
  4. 用 frontmatter aprovado: false 儲存輸出。
  5. 顯示給 Felipe 並等待明確的「是」。
  6. node approve.js --file <arq> --fase <fase> --via conversa --citacao "<trecho literal do sim>"。高風險階段(software-extra、publicacao):由 Felipe 執行 ! node approve.js ... --via comando。
階段技能輸出
發現(descoberta)landing-descoberta01-negocio-e-escopo.md、inventario-assets.md
視覺方向(direcao-visual)landing-direcao-visualdirecao-visual.md
計畫(plano)superpowers:writing-plans,儲存於 <cliente>/plano.mdplano.md
執行(execução)superpowers:executing-plans;若 tem:software-extra 則使用 landing-software-extra網站、03-decisoes.md
審查(revisão)superpowers:requesting-code-review 搭配工具包結果寫入 publicacao.md
發布(publicação)landing-publicarpublicacao.md

在執行階段,從模板複製 regras-site.json 和 pares-contraste.json,並在每次交付時運行工具包。

嚴格程度與風險成正比(Rigor proporcional ao risco)

風險範例要求
低文字、間距、已批准階段中的局部缺陷直接執行,無需步驟 0 或閘門;只進行相關檢查;僅在有反應時才記錄
中視覺識別、章節、已批准的決策影響範圍有限;使用 approve.js --reabrir 重新打開受影響的階段閘門
高基礎設施、共用資源、資料、正式環境遵循本技能的鐵律;需透過命令方式批准

修改已批准成品所陳述的內容將重新打開該閘門;如有疑問,歸類為更高一級的風險。

紅旗:立即停止(Red Flags: pare)

  • 「我還記得客戶說的話」·「已經批准了,我直接來」·「很快,跳過問卷」
  • 手動寫入 aprovado: true · 將重大變更隱藏在 ## Pendências 中
  • 未經詢問就決定技術棧 · 為新登陸頁面做模型
合理化現實
「Felipe 很趕時間」趕時間也不能跳過閘門:請執行閘門檢查
「只是個小調整」分類風險;低風險可以直接執行
「記憶就夠了」讀取檔案;記憶是最不可靠的來源

Individual skills in this repo

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

FelipeStruchel/landing-page-skills

Use when começa um cliente novo de landing page sem 01-negocio-e-escopo.md aprovado, quando faltam dados do negócio, mídias, nomes ou perfis, ou quando o Felipe pede o questionário de entrada. Não use para escolher estilo visual (landing-direcao-visual).

FelipeStruchel/landing-page-skills

Use when o 01-negocio-e-escopo.md está aprovado e falta escolher o estilo visual de uma landing page, ou quando uma tela interna (agenda, painel) de um cliente precisa de visual. Não use para levantar dados do negócio (landing-descoberta).

FelipeStruchel/landing-page-skills

Use when o Felipe pede para redesenhar skills de landing page, revisar aprendizados acumulados, processar feedbacks pendentes, atualizar o _regras-vivas.md, fazer a migração inicial das regras, ou quando o Passo 0 oferece a migração. Não use durante a construção de um cliente.

FelipeStruchel/landing-page-skills

Use when uma landing page está pronta para ir ao ar: publicar, fazer deploy, configurar domínio ou Cloudflare, limpar cache, ou conferir o site já publicado. Não use para construir a página (criar-landing-page).

FelipeStruchel/landing-page-skills

Use when SEMPRE durante o trabalho em uma landing page de cliente: ao entregar qualquer coisa (texto, foto, tela, deploy) e ao receber reação, correção, elogio ou aprovação do Felipe ou do cliente.

FelipeStruchel/landing-page-skills

Use when uma landing page precisa de software além da página estática: agenda ou reserva, painel, API, banco, e-mail transacional, notificação, ou qualquer serviço que roda no servidor ao lado de outro sistema. Não use para páginas só de HTML, CSS e JS.

相關技能