Communitygithub.com

FelipeStruchel/landing-page-skills

使用场景:当落地页需要静态页面之外的软件功能时,例如日程安排或预订、后台面板、API、数据库、交易邮件、通知或任何与另一系统一起在服务器上运行的服务。不适用于仅包含 HTML、CSS 和 JS 的页面。

landing-page-skills 是什么?

此技能为需要集成服务器端软件(如数据库、API、邮件服务或通知)的落地页项目提供严格的架构决策流程。它强调了在实施前必须获得所有堆栈、网络和共享资源决策的明确批准,降低高风险阶段的出错风险。该技能适用于各种 AI 编码助手,通过一系列强制性的'门控函数'步骤来记录决策、获取批准、以 TDD 方式实施,并通过邻居系统的健康检查和代理日志验证部署效果。它内置了一系列硬性规则和红旗警告,防止常见错误,例如未经咨询就选择数据库、使用冲突的服务名称或跳过备份。

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

在你喜欢的 AI 中提问

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

文档

Landing:额外软件

架构决策权归项目所有者所有。违背文字即违背精神。

铁律

未经事先询问,不得做出任何关于堆栈、网络或共享资源的决策。高风险阶段:仅接受 Felipe 的指令。

首要行动: node check-gate.js --cliente <名称> --antes-de software-extra;阅读 01 和 plano.md;如果有预订,阅读 references/agendamento.md。

门控函数

  1. 列出所有待决策项(堆栈、数据库、运行位置、共享内容、邮件、通知、备份)。
  2. 对每一项:列出选项,给出推荐及其理由,说明错误代价。询问;不要自行选择。
  3. 记录在 03-decisoes.md 中(格式为 D)。如果违反全局规则,则记录 override: R-nnn 并附带 Felipe 的批准。
  4. Felipe 执行 ! node approve.js --file <03> --fase software-extra --via comando。之后才可实施。
  5. 以 TDD 方式实施。完成后由独立审核人审核。
  6. 部署后:检查一个邻居的真实路径(例如,另一系统的 GET /api/health)并执行 docker logs <proxy> --since 2m | grep -c "502\|refused"。

固定规则

  • 项目前缀必须用于所有服务、容器和共享网络别名(例如 agenda-api、agenda-db)。在加入网络前,列出邻居解析的名称(如 set $api、upstream、proxy_pass)。
  • 机密仅存储在服务器上的 .env 文件中,权限为 600;曾通过聊天传递的机密建议更换。
  • 时间、服务和价格来自一个来源(数据库);静态 HTML 仅作为后备。
  • 选项名称和持续时间是不同的字段;界面通过显式规则决定显示内容。
  • 内部界面需经过 landing-direcao-visual 和 frontend-design 审核;新增项需有模拟图并逐项确认。
  • 生产环境:先备份,重载前执行 nginx -t,选择不中断业务的窗口,编写回滚说明。需要 root 权限的操作转换为一行命令交给 Felipe。

红旗警告:立即停止

  • 因为“是最好的”而选择数据库 · 重用名称 api · 无备份的部署
  • 在服务器上执行一份你自己本应执行的 5000 行计划
  • 未测试邻居就认为“本地运行正常”
合理化现实
“选择显而易见”如果 Felipe 通过代码发现,他会惊讶吗?那么请询问
“短名称更简洁”在 edge 网络中名为 api 的服务因 502 错误导致邻居宕机
“已获得落地页批准”一个上下文的批准不适用于另一个上下文

Individual skills in this repo

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

FelipeStruchel/landing-page-skills

Use when o Felipe pede para criar, montar, refazer ou retomar uma landing page ou site de uma página para um negócio ou cliente, ou abre uma pasta de cliente em criar-site/. Não use para redesenhar as próprias skills (landing-evoluir-skill).

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.

相关技能