Communitygithub.com

本地商家落地页:从需求到上线的分关卡搭建

为真实的本地商家按审批阶段做一页式网站:需求调研、视觉方向、计划、搭建、审查、发布。每个阶段都要等一句明确的“同意”并写入磁盘,配套的 Node 工具包会检查对比度、基础无障碍、素材清单、缓存和可回滚发布。

本地商家落地页:从需求到上线的分关卡搭建 是什么?

「本地商家落地页」配方第 1 步(跑完整个项目),来自 FelipeStruchel/landing-page-skills(葡萄牙语,个人非商业许可)。criar-landing-page 是 7 个 Claude Code 技能的总调度:上一关没通过 check-gate.js,下一阶段就不开始;每份产出先以 aprovado: false 保存,等负责人点头,approve.js 会记下那句“同意”的原话。它源自三个真实客户站点(按摩工作室、定制毛巾 B2B、派对服务)。路径和名字是作者自己的,使用前要改好 CRIAR_SITE_ROOT 和工具包。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

创建落地页

编排阶段与门禁。磁盘是唯一真理源;对话记忆不是。 违反文字就是违反精神。

铁律

任何阶段不得在前一阶段门禁未批准的情况下开始
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 中,并一行列出适用于当前客户的规则。

门禁函数

在每个阶段之前:

  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 "<同意文本的摘录>"。高风险阶段(software-extra、publicacao):Felipe 运行 ! node approve.js ... --via comando。
阶段技能输出
发现landing-descoberta01-negocio-e-escopo.md, inventario-assets.md
视觉方向landing-direcao-visualdirecao-visual.md
计划superpowers:writing-plans, 保存到 <cliente>/plano.mdplano.md
执行superpowers:executing-plans; 如果 tem:software-extra 则用 landing-software-extra网站、03-decisoes.md
审查superpowers:requesting-code-review 加上工具包结果记录在 publicacao.md
发布landing-publicarpublicacao.md

在执行阶段,从模板复制 regras-site.json 和 pares-contraste.json,每次交付都运行工具包。

风险比例原则

风险示例要求
低文本、间距、已批准阶段内的局部缺陷直接执行,无需步骤 0 或门禁;仅做相关检查;仅在产生反应时记录
中视觉标识、章节、已批准决策影响范围短;approve.js --reabrir 受影响阶段
高基础设施、共享资源、数据、生产铁律强制;通过命令确认批准

修改已批准工件所声明的内容将重新触发其门禁;如有疑问,以上述分类为准。

红旗:立即停止

  • “我记得客户说过” · “已经批准了,我直接走” · “很快的,跳过问卷”
  • 手动写入 aprovado: true · 将实质性变更隐藏在 ## 待办事项 中
  • 未经询问就决定技术栈 · 为新落地页做原型设计(mockup)
理由现实
“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.

相关技能