编辑网站局部
目标
针对现有静态网站的某个部分进行定向改进,同时保留网站的其他部分不变。
此技能适用于网站已存在后的迭代打磨。它应当像细致的局部编辑,而非一次新的生成过程。
契约
输入:
- 现有的静态网站文件夹、目标页面、截图/本地URL,或对目标区域的自然语言描述。
EDITING.md以及相关的 HTML/CSS/JS 文件。- 期望的前后对比文本、样式、响应行为或小型交互变更。
输出:
- 针对受影响页面区块、组件、文案块、样式规则或轻量交互的聚焦编辑。
- 仅在将来的编辑说明需要更改时更新
EDITING.md。 - 简要报告:更改位置、更改的文件以及执行的验证。
边界:
- 不要重建整个网站、更改主题方向、导入文章、个性化多个字段或发布。
- 不要触及无关的页面/资源。
- 不要引入依赖、构建步骤或根绝对路径的站点本地路径。
成功条件:
- 请求的局部更改在编辑前确认的同一浏览器区域中可见。
- 针对受影响表面的桌面/移动或交互检查通过。
- 没有引入无关的布局或导航更改。
如果条件未通过:
- 重新将浏览器区域映射到源代码,并进行最小的修正编辑。
- 当问题影响到共享导航、多个页面、资源、编码或发布就绪性时,运行或建议
review-static-site。
何时使用
当用户要求进行以下操作时使用此技能:
- 更改一个区块、卡片、块、组件或页面区域。
- 让视觉细节变得更小、更冷静、更密集、更干净、更有趣、更技术性或更不分散注意力。
- 修复移动端布局问题、文本溢出、间距问题或不自然的对齐。
- 调整小型交互,如悬停、主题切换、菜单行为、复制按钮、筛选、标签或动画。
- 重写或缩短特定的可见文本。
- 针对局部区域匹配截图或用户评论。
不要将此技能用于全站生成、主题搜索、紧密复刻新参考网站、大量个人内容替换、文章迁移、部署或框架转换。
输入
使用用户提供的任何内容:
- 网站根文件夹和目标页面。
- 截图、浏览器视图、本地URL或问题的自然语言描述。
- 要更改的确切文本、区块名称、类名或视觉区域。
EDITING.md(如果存在)。- 现有的 HTML/CSS/JS 文件。
- 任何期望的前后对比措辞或风格方向。
如果目标区域不明确,检查网站并做出最合理的解释。仅在多个可能的编辑会产生截然不同结果时,提出简短的澄清问题。
工作流
- 编辑前,使用浏览器确认目标页面和目标区域。
- 读取
EDITING.md(如果存在),然后检查相关的 HTML/CSS/JS。 - 使用搜索找到匹配的可见文本、ID、类、数据块或类似组件的标记。
- 将已确认的浏览器区域映射到相关的源文件、选择器、数据块或事件处理程序。
- 做出满足请求的最小一致性编辑。
- 除非用户明确要求更改,否则保持现有的设计语言。
- 编辑后,返回浏览器中的同一页面和区域,验证更改。
- 报告更改了什么,并提及任何需要后续验证的内容。
范围控制
保持编辑的局部性。
- 优先编辑现有的区块、类或数据对象,而不是创建并行副本。
- 避免在区块级更改足够的情况下重写整个页面。
- 除非用户希望进行全站样式更改,否则避免更改共享的 CSS 变量。
- 避免触及无关的页面、资源或内容。
- 保留导航、页面映射、占位策略和
EDITING.md约定。 - 保留网站的路径策略;在局部编辑期间,不要引入根绝对路径的站点本地路径,例如
/assets/...、/posts/...、/images/...或/data/...。 - 如果一个小请求暴露出更大的结构性问题,在做出广泛更改之前解释权衡。
当用户要求跨多个页面的广泛视觉转变时,建议使用更大的生成或重新设计技能,而不是勉强使用此技能。
定位正确位置
使用分层查找:
- 搜索可见文本或附近标签。
- 搜索
EDITING.md中的区块/页面映射。 - 检查导航链接和页面文件名。
- 检查语义标签,如
header、main、section、article、aside和footer。 - 检查 CSS 选择器和 JavaScript 事件钩子。
- 当源代码位置不明显时,使用浏览器开发者工具或截图。
如果重复内容是从数据渲染的,编辑源数据而不是仅看起来像是生成的标记。
设计保存
使编辑适应当前网站。
- 重用现有的间距、排版、颜色、边框、阴影、图标和运动模式。
- 确保文本在桌面和移动端都保持在其容器内。
- 避免装饰效果干扰阅读。
- 修改动画时尊重
prefers-reduced-motion。 - 保持文章/详情页面比高度风格化的首页更冷静,除非用户另有要求。
- 不要在个人网站或博客中添加营销风格的英雄区或无关的装饰区块。
更改文案时,匹配现有的语气和用户的语言。
交互编辑
针对 JavaScript 或交互更改:
- 在添加新的事件监听器和状态约定之前,先找到现有的。
- 如果网站是纯静态的,保持使用原生 JavaScript。
- 避免引入依赖或构建步骤。
- 在 JavaScript 中生成链接、搜索结果、图像 URL 或导航项时,使用从受影响页面深度起作用的页面相对路径。
- 在相关时测试点击、键盘、移动和重复使用状态。
- 保留可访问性基础,如焦点、标签和减少运动行为。
响应式修复
针对布局或移动端问题:
- 检查桌面和移动端宽度。
- 优先选择在保持桌面布局的同时修复窄屏的 CSS 更改。
- 使用稳定的尺寸、换行、最小/最大宽度、网格/弹性调整和溢出控制。
- 不要为了适应布局而隐藏移动端上的重要内容。
编辑指南
如果更改影响到将来如何进行编辑,请更新 EDITING.md。
当以下情况时更新:
- 引入了新的区块、类、数据字段或交互模式。
- 内容存储移动到了新文件或数据对象。
- 用户请求了未来代理可能需要保留的更改。
对于微小的文案或间距更改,不要更新 EDITING.md,除非指南因此变得具有误导性。
验证
验证受影响表面,不一定是整个网站。
在编辑前使用实际可用的交互式浏览器工具确认目标页面和区域。“可用”意味着它暴露在当前轮的可用工具列表中。在 Codex 中,可能是路由到本轮中的 Browser/in-app browser 插件;在其他代理中,可能是等效的可视浏览器、browser-use 工具或基于开发者工具的浏览器。编辑后,在交互式浏览器中返回到同一页面和区域验证结果。
如果没有可调用的交互式浏览器工具,不要假装前后浏览器确认已经完成。如果编辑依赖于视觉区域映射,请要求用户启用或调用浏览器工具;对于 Codex,这可能意味着发送一个明确提到 @browser 的请求。如果用户没有重新路由或客户端没有此类工具,则回退到 Playwright、截图或源代码检查,并说明限制。
当交互式浏览器工具实际可调用时,不要默认使用 Playwright、仅截图验证或仅源代码检查。仅当没有交互式浏览器工具可调用、用户明确要求使用、或特别需要可重复脚本化回归时,才将 Playwright 作为后备方案。
对于视觉、响应式或交互式编辑,在相关的桌面/移动视口中检查更改的区域,并测试更改后的交互。
仅当编辑影响共享导航、全局布局、多个页面、资源路径、源代码编码或发布就绪性时,才运行或建议 review-static-site。
如果编辑涉及 href、src、CSS url(...)、图像、字体、favicon、数据文件或 JavaScript 生成的 URL,请验证受影响的页面仍然可以使用页面相对路径工作,并且直接打开静态文件不会丢失 CSS、JS 或图像。
输出
对于局部编辑,仅报告:
- 更改的位置。
- 哪些文件发生了变化。
- 进行了哪些验证。
仅在确实推荐时提及更广泛的 review-static-site 验证。不要重复报告或过度解释整个代码库。