Community生产力与协作github.com

umairmsm/wp-kickoff

WordPress 网站启动第一阶段:从需求评估、技术选型、项目创建到凭证清单,为全新搭建或接手现有站点奠定基础。

wp-kickoff 是什么?

本技能是 wp-site-kit WordPress 构建流程的启动阶段。它适用于开始一个全新的 WordPress 网站、接手或重建现有站点。技能的核心目标是创建一份关于业务的“唯一真相文档”,以及一个包含方法所期望的所有文件的空项目(尚未进行任何设计或构建)。它首先通过爬取现有站点(如果有)来清点所有 URL、表单、支付步骤等内容,并将业务视为正在运营的实体而非挂起域名。接着,通过预设的需求简报模板引导用户进行深度业务调研,记录所有决策及其理由。然后,利用 wp-site-kit 提供的脚手架工具(bin/wp-site-new)创建本地项目,并完成 AGENTS.md(锁定决策、硬性规则)、私有远程仓库、凭证清单(仅名称)等初始化工作。该技能明确适用于 Claude Code、Cursor 等 AI 编码助手,并详细列出了常见的陷阱(如不当的 DNS 切换、API 密钥泄露、忽略源站限流等)以辅助代理人避免典型错误。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-kickoff

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

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

文档

第 1 阶段:启动

目标:生成一份关于业务的“唯一真相文档”,以及一个包含方法所期望的所有文件的空项目。尚未进行任何设计或构建。

步骤

  1. 是否已有在线站点? 如果是,将其视为正在运营的业务,而非挂起域名。首先进行清点(references/discovery-brief.md,“现有站点”部分):
    • 所有 URL(通过站点地图)、表单、支付步骤、博客文章和联系信息;
    • 其 Search Console 数据(如果所有者可以分享);
    • 当前哪些功能在赚钱。重建时必须保证所有功能继续正常工作。 礼貌爬取:先阅读使用条款(robots.txt 并非许可),每次请求之间至少等待 2 秒。
  2. 需求简报。 按 references/discovery-brief.md 中的问题提问,并将答案写入 docs/BRIEF.md。每个事实需标注来源(所有者、文档、爬取)。如果某个事实未知,写为 PENDING-<谁>。切勿猜测。
  3. 技术选型。 从 references/stack.md 中的默认配置开始。仅在有令人信服的理由时才更改某一层,并将改动记录在 DECISIONS.md 中。
  4. 创建项目 使用工具包的脚手架(位于此技能所在文件夹的上两级):
    bash <kit>/bin/wp-site-new --name "Acme Tours" --slug acme-tours --prefix acme \
         --domain example.com --dir ~/sites/acme-tours --git
    
    • slug:小写字母和连字符。用于命名 DDEV 项目、文件夹和文本域。
    • prefix:2 到 12 个小写字母或数字。所有函数、选项、文章类型、元键、钩子和 nonce 都以 <prefix>_ 开头。
  5. 填写 AGENTS.md:
    • 网站是什么;
    • 谁批准设计和客户文案;
    • 已锁定的决策;
    • 特定于该业务的硬性规则,例如受监管的声明、需要展示的许可证,或所有者不希望出现的词汇。
  6. 私有远程仓库,第 1 天设置。 所有者创建私有仓库并推送。一旦本地站点存在(第 3 阶段),运行 scripts/backup.sh 并在另一台机器上保留一份副本。
  7. 凭证清单(docs/reference/CREDENTIALS_INVENTORY.md):
    • 列出每个账户(域名注册商、DNS、主机、SMTP、分析工具、Search Console、支付、CDN);
    • 写明每个密钥的存放位置;
    • 仅列出名称,切勿写值。
  8. 在 SITE_STATUS.md 中勾选启动门禁,并附上证据:简报的批准日期、首次提交的 SHA、远程仓库名称。

门禁

  • docs/BRIEF.md 已获所有者批准(日期)
  • 已锁定的决策和业务硬性规则已写入 AGENTS.md
  • 项目已创建并提交;私有远程仓库已存在
  • 凭证清单已开始填写(仅名称)
  • 替换在线站点时:URL 和功能清单已保存在 docs/data/legacy/ 中(或填写“不适用” n/a)

我们曾遇到的陷阱

  • 将“切换”视为简单的 DNS 更改,而旧站点当天仍在处理付费预订。
  • 旧站点的评论数量(“1,118 条评论”)经查是编造的。请勿迁移这些虚假数据。
  • 通过 Cloudflare 代理域名,而旧主机按 IP 限速。主机仅看到 Cloudflare 的 IP,导致真实访客收到 429 错误。在启用代理前,请检查源站的主机限制。
  • 轻信其他代理的备注说“已解决”。修复方案未推送、未测试、未部署。请验证真实情况。
  • 有人在代理聊天中粘贴了 API 密钥。代理见过的密钥必须轮换。

Individual skills in this repo

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

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-design

Stage 2 of a wp-site-kit WordPress build - design direction, a static HTML/CSS prototype with design tokens, owner sign-off with screenshots, self-hosted fonts, and porting the approved look into a swappable WordPress skin. Use for "design the site", "new look", "redesign", "change colours or fonts", "make a new skin", "port the prototype to WordPress".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-seo

Stage 5 of a wp-site-kit WordPress build - titles and descriptions, canonical URLs, one schema owner and JSON-LD, sitemaps, robots.txt and llms.txt, AI crawler access, redirects (301 vs 302), legacy URL maps, Search Console, and adding languages one pilot at a time with Polylang (hreflang, .po/.mo strings, native review). Use for "SEO", "schema", "redirect", "old URLs", "translate the site", "add French/Spanish", "hreflang", "canonical".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

umairmsm/wp-site

Start here for any WordPress website built with wp-site-kit, from an empty folder to a live site. Use when someone says "build a WordPress site", "new website for a client", "where are we on the site", "what is next before launch", or asks to continue a site project. Finds the current stage from SITE_STATUS.md, applies the hard rules, and hands over to the right stage skill.

相关技能