Communitygithub.com

Gyschuaner/from-idea-to-personal-site

使用此技能对生成的静态网站、个人博客、作品集、数字花园或风格复现进行精准、小范围的局部编辑。适用于用户只想调整某个页面区块、组件、视觉细节、文案、响应式问题或轻量交互,而不需要重建整个网站的场景。

from-idea-to-personal-site 是什么?

此技能专注于对已有静态网站进行局部、精准的编辑,而非大规模重建。它帮助开发者或AI代理在一次编辑会话中仅改动一个页面区块、组件、样式规则或交互行为,同时保持网站其余部分的完整性和一致性。技能支持多种定位方式,包括自然语言描述、截图、本地URL等,并通过浏览器工具确认前后效果。它强调编辑的范围控制,避免引入新的依赖、构建步骤或全局性变化。适用于个人博客、作品集、数字花园等静态网站,支持Claude Code、Codex、Cursor等主流AI编程代理。工作流程包括目标区域确认、源代码定位、最小化编辑、浏览器验证以及编辑报告输出。若编辑涉及共享导航、全局布局或多页影响,技能会建议使用更全面的审查工具。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/edit-site-part

在你喜欢的 AI 中提问

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

文档

编辑网站局部

目标

针对现有静态网站的某个部分进行定向改进,同时保留网站的其他部分不变。

此技能适用于网站已存在后的迭代打磨。它应当像细致的局部编辑,而非一次新的生成过程。

契约

输入:

  • 现有的静态网站文件夹、目标页面、截图/本地URL,或对目标区域的自然语言描述。
  • EDITING.md 以及相关的 HTML/CSS/JS 文件。
  • 期望的前后对比文本、样式、响应行为或小型交互变更。

输出:

  • 针对受影响页面区块、组件、文案块、样式规则或轻量交互的聚焦编辑。
  • 仅在将来的编辑说明需要更改时更新 EDITING.md。
  • 简要报告:更改位置、更改的文件以及执行的验证。

边界:

  • 不要重建整个网站、更改主题方向、导入文章、个性化多个字段或发布。
  • 不要触及无关的页面/资源。
  • 不要引入依赖、构建步骤或根绝对路径的站点本地路径。

成功条件:

  • 请求的局部更改在编辑前确认的同一浏览器区域中可见。
  • 针对受影响表面的桌面/移动或交互检查通过。
  • 没有引入无关的布局或导航更改。

如果条件未通过:

  • 重新将浏览器区域映射到源代码,并进行最小的修正编辑。
  • 当问题影响到共享导航、多个页面、资源、编码或发布就绪性时,运行或建议 review-static-site。

何时使用

当用户要求进行以下操作时使用此技能:

  • 更改一个区块、卡片、块、组件或页面区域。
  • 让视觉细节变得更小、更冷静、更密集、更干净、更有趣、更技术性或更不分散注意力。
  • 修复移动端布局问题、文本溢出、间距问题或不自然的对齐。
  • 调整小型交互,如悬停、主题切换、菜单行为、复制按钮、筛选、标签或动画。
  • 重写或缩短特定的可见文本。
  • 针对局部区域匹配截图或用户评论。

不要将此技能用于全站生成、主题搜索、紧密复刻新参考网站、大量个人内容替换、文章迁移、部署或框架转换。

输入

使用用户提供的任何内容:

  • 网站根文件夹和目标页面。
  • 截图、浏览器视图、本地URL或问题的自然语言描述。
  • 要更改的确切文本、区块名称、类名或视觉区域。
  • EDITING.md(如果存在)。
  • 现有的 HTML/CSS/JS 文件。
  • 任何期望的前后对比措辞或风格方向。

如果目标区域不明确,检查网站并做出最合理的解释。仅在多个可能的编辑会产生截然不同结果时,提出简短的澄清问题。

工作流

  1. 编辑前,使用浏览器确认目标页面和目标区域。
  2. 读取 EDITING.md(如果存在),然后检查相关的 HTML/CSS/JS。
  3. 使用搜索找到匹配的可见文本、ID、类、数据块或类似组件的标记。
  4. 将已确认的浏览器区域映射到相关的源文件、选择器、数据块或事件处理程序。
  5. 做出满足请求的最小一致性编辑。
  6. 除非用户明确要求更改,否则保持现有的设计语言。
  7. 编辑后,返回浏览器中的同一页面和区域,验证更改。
  8. 报告更改了什么,并提及任何需要后续验证的内容。

范围控制

保持编辑的局部性。

  • 优先编辑现有的区块、类或数据对象,而不是创建并行副本。
  • 避免在区块级更改足够的情况下重写整个页面。
  • 除非用户希望进行全站样式更改,否则避免更改共享的 CSS 变量。
  • 避免触及无关的页面、资源或内容。
  • 保留导航、页面映射、占位策略和 EDITING.md 约定。
  • 保留网站的路径策略;在局部编辑期间,不要引入根绝对路径的站点本地路径,例如 /assets/...、/posts/...、/images/... 或 /data/...。
  • 如果一个小请求暴露出更大的结构性问题,在做出广泛更改之前解释权衡。

当用户要求跨多个页面的广泛视觉转变时,建议使用更大的生成或重新设计技能,而不是勉强使用此技能。

定位正确位置

使用分层查找:

  1. 搜索可见文本或附近标签。
  2. 搜索 EDITING.md 中的区块/页面映射。
  3. 检查导航链接和页面文件名。
  4. 检查语义标签,如 header、main、section、article、aside 和 footer。
  5. 检查 CSS 选择器和 JavaScript 事件钩子。
  6. 当源代码位置不明显时,使用浏览器开发者工具或截图。

如果重复内容是从数据渲染的,编辑源数据而不是仅看起来像是生成的标记。

设计保存

使编辑适应当前网站。

  • 重用现有的间距、排版、颜色、边框、阴影、图标和运动模式。
  • 确保文本在桌面和移动端都保持在其容器内。
  • 避免装饰效果干扰阅读。
  • 修改动画时尊重 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 验证。不要重复报告或过度解释整个代码库。

Individual skills in this repo

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

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

相关技能