Agent Skills
返回列表
💻

网站规范标准

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/specification-website-skill。

技能介绍

你在审什么、缺什么标准

上线前或接手旧站时,常见问题不是「有没有 checklist」,而是同一条规则在不同文档里说法不一:SEO 同事强调 canonical,安全同事强调 CSP,无障碍又单独列 WCAG——最后 agent 或工程师只能凭经验猜「这条算不算硬要求」。更麻烦的是把 recommended 当成 required 去压排期,或漏掉标为 avoid 的惯习(例如 soft-404、空链接按钮)。

本技能把 specification.website 的 128 个主题打包为本地 references/topics/**/*.md,并约定每条主题的四态标签:required / recommended / optional / avoid。审计时应原样报告 status,不得为强调而「升级」级别。

核心能力与典型用法

十个分类覆盖 foundations、SEO、accessibility、security、well-known、agent-readiness、performance、privacy、resilience、i18n。常见工作流包括:

  • 审计 URL:从 references/checklist.md 的 Required 段起步,对照抓取到的 HTML、响应头、robots.txt、sitemap.xml、/.well-known/*,缺项则打开对应 topic,引用 frontmatter 里的 WHATWG / W3C / IETF / WCAG 等一手来源再提修复建议。
  • 「X 是否必选?」:在 topics 中检索 slug,读 status: 字段并引用 sources[],而不是只复述规范页摘要。
  • Agent 就绪:读 references/categories/agent-readiness.md,按 status 排序逐项核对(如 llms.txt、结构化数据、稳定 URL 等)。

每条 topic 建议结构为 What / Why / How / Common mistakes / Verification;回答时优先 sources[].url,描述结果而非某框架的配置文件名(平台无关)。规范正文使用英式拼写(internationalisation 等)。若 bundled 内容过旧,可按 references/mcp-and-fetch.md 走 MCP 或 HTTP 拉取最新 Markdown。

边界与诚实约束

这是合成规范 + 本地语料,权威依据在各 topic 引用的标准文档,不是 skill 作者的个人偏好。required 的门槛是「平台契约破裂或明确伤害某类用户」,不是「我们强烈建议」。涉及实现细节(例如 Next.js 的某个 config 片段)应落在你的栈里自行映射,技能只说明应达成的行为与验证方式。

使用场景

  • 上线前对照 `checklist.md` 的 Required 段,抓取生产 URL 的 HTML、响应头与 `robots.txt`,逐项标记缺失的必选 topic。
  • 发布争论某响应头或 meta 是否阻塞上线时,在 `references/topics/` 检索 slug,读取 `status` 并引用 frontmatter 中的一手标准链接作答。
  • 建设面向 AI 爬虫的文档或产品站时,按 `agent-readiness` 分类核对 `llms.txt`、结构化数据、稳定 URL 与爬虫规则。
  • 接手遗留站点做 broad audit:先 Required 再 Recommended,每缺一项打开对应 `.md` topic,按 cited sources 写修复与验证步骤。

适合人员

  • 负责上线门禁的平台或全栈工程师,需要把「阻塞发布」与「建议优化」用 required/recommended 说清口径。
  • 维护公开站点的技术 SEO,要对照本地 topic 核查 sitemap、canonical、结构化数据与 robots 相关条目。
  • 承担无障碍交付的前端或 QA,需按 accessibility 分类查 WCAG 对齐的 required 规则及 Verification 段。
  • 建设可被 LLM/MCP 发现的产品或文档站的后端,要落实 well-known 路径与 agent-readiness 清单里的具体行为。