将新网页接入既有站点
输入包括页面用途、所属项目、公开范围与数据源。读取已有 AGENTS.md、规格、共用组件以及生成和发布流程。根据实际共用实现组装页面,不要求用户指定某个旧页面作为基础。
页面契约
在所属模块文档中简要记录公开 URL、源文件与分发目标的对应关系,公开与认证边界,可被搜索的正文,首批数据范围,更新来源,以及失败时的显示方式。复用既有文档结构,不为简单页面增加不必要的服务或定时任务。
- 固定说明放在初始 HTML 的普通正文中。文章、分析和列表选择希望被搜索的实际内容;图表和计算工具选择用途与必要概述;大型历史记录和交互保留在 JS 侧。可以使用 JSON 作为原始数据。
- 不将
noscript作为唯一可搜索正文。初始正文与应用管理同一位置时,明确各自负责的范围,避免 JS 启动就清空正文。具体生成和交接方式须在项目中验证,不强制所有页面使用 SSR。 - Sidebar、Header、Footer、语言、字体和认证复用共用实现。不继承复制来源的业务或隐藏旧菜单。如果采用共享执行文件方式,应遵守其加载契约,不在页面主体嵌入另一套实现。
- 将界面菜单显示与服务器访问权限分开。修改共享组件前检查实际依赖方,避免不必要的全站页面重新生成。
仅使用所需技能
| 条件 | 技能与应取得的结果 |
|---|---|
| 页面用于搜索或分享 | public-page-seo-assist:初始正文、元信息、URL 与验证结果 |
| 需要确认首次或再次获取的成本 | web-performance-slimming:实际传输量、请求数以及必要的压缩和加载设计 |
| 数据、日志或备份增长 | data-growth-guard:原始数据与派生产物的区分,以及保存和清理边界 |
| 存在定时生成或外部采集 | cron-crawler-safety:时间表、请求限制,以及失败和发布的处理 |
| 存在静态分发或服务器生成物 | static-deploy-refresh-check:分发顺序、保护对象与更新确认 |
仅在需要时读取随包或已安装的目标 SKILL.md。若尚未安装,说明哪些需要获取,或使用项目等价流程。不强制执行所有技能,也不将仅阅读技能视为已经验证。
SSH、邮件、认证和秘密配置复用既有基础设施。仅在需要新建且属于请求范围时,使用对应的 sakura-*-setup / sakura-api-secrets-deploy。
完成确认
检查初始 HTML、JS 启动后、首次数据获取失败和直接打开 URL 的情况。验证桌面和移动端共用组件与语言、所需数据加载,以及发布后的生成物;分别报告实现、发布和搜索收录状态。
既有页面或自动生成器仅产出新文章时,不因此启动本技能的迁移流程。各个独立技能也可单独用于改进既有页面。这是对既有经验整理出的创建流程,不是保证尚未验证的新页面一定正常运行的模板。