Communitygithub.com

Gyschuaner/从创意到个人网站

编排个人网站技能套件,用于创建、重建、个性化、添加内容、验证、编辑或准备静态个人网站或博客。当智能体需要在主题搜索、样式参考调研、原创构建、网站样式重建、个性化、文章导入、审查、本地编辑或发布准备之间做出选择,或者用户询问现有网站构建工作流中的下一步时使用。

从创意到个人网站 是什么?

这是一个编排型技能,而非实现型技能,旨在将个人网站技能套件整合为可靠的工作流。它负责路由到正确的子技能、强制执行质量门控,并推动工作流持续前进,直到当前请求达到自然停止点。该技能明确规定了输入(用户请求、网站文件夹、参考资料、身份材料、内容材料以及可选的发布目标)和输出(选定的工作流路由、已执行的子技能、本地静态站点、验证结果或交接摘要)。它强调“先路由后执行”,根据用户意图选择最短的链(例如,从样式参考到原创构建,或从参考网站重建到个性化),并且仅在明确请求时才进行发布。支持的子技能包括主题搜索、样式参考调研、网站创建、样式复制、个性化、文章添加、局部编辑、静态网站审查以及发布到 GitHub Pages、Cloudflare Pages、Netlify 或 Vercel。

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

在你喜欢的 AI 中提问

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

文档

构建个人网站

目标

将个人网站技能套件协调为可靠的工作流。

这是一个编排技能,而非实现技能。它应路由到正确的专门技能,强制执行质量门控,并推动工作流持续前进,直到当前请求达到其自然停止点。

不要重复子技能中的详细实现规则。在到达其步骤时加载并遵循子技能。

对于面向用户的“从创意到个人网站”或一键启动请求,优先使用 from-idea-to-personal-site。当下一步或子技能选择是主要问题时,使用本技能作为较低级别的路由协调器。

契约

输入:

  • 用户请求、网站文件夹或所需输出文件夹、参考资料、身份材料、内容材料以及可选的发布目标。
  • 当用户询问下一步时,提供当前工作流状态。

输出:

  • 选定的工作流路由和已执行的子技能。
  • 根据请求,输出本地静态站点、已验证的现有站点、导入的内容、聚焦的编辑或发布准备。
  • 交接摘要,包含网站文件夹、预览/发布状态、已执行的验证以及剩余的 manual 步骤。

边界:

  • 当有专门的子技能适用时,不要直接实现子技能的细节。
  • 不要默认运行所有子技能;选择满足请求的最短链。
  • 除非明确请求,否则不要发布、推送、创建项目、绑定域名或更改 DNS。
  • 在生成、重建、个性化、文章导入或广泛编辑之后,不要跳过 review-static-site。

成功门控:

  • 选定的子技能链达到用户的自然停止点:方向已选择、网站已构建、内容已添加、网站已验证、编辑已完成或部署已准备/执行。
  • 必需的质量门控已通过,或者用户明确接受已记录的局限性。

如果门控失败:

  • 将失败的门控路由到最小责任的子技能。
  • 重新运行受影响的验证。
  • 仅当缺少用户内容、缺少凭据、资源不可用或外部帐户操作阻止进展时,停止并报告障碍。

子技能

将这些技能用作工作流构建块:

  • search-blog-theme:发现并比较个人网站/博客主题方向。
  • find-style-references:搜索并检查所选方向的真实网站/模板/截图,并生成可构建的参考简报。
  • make-personal-site:创建原始的零依赖静态个人网站。
  • copy-website-style:重建特定参考网站的样式、布局、动效和页面类型。
  • personalize-site:用用户自己的内容替换占位符/演示/源身份。
  • add-blog-posts:将 Markdown、Obsidian 笔记、Word 草稿、旧 HTML 文章、图片、数学内容、链接和其他写作内容导入现有网站。
  • edit-site-part:对特定部分、组件、文本块、样式细节或交互进行聚焦的本地更改。
  • review-static-site:验证静态输出,检查链接、页面类型、浏览器渲染、编码、占位符残留、直接打开兼容性和路径正确性。
  • publish-static-site:准备或执行部署到 GitHub Pages、Cloudflare Pages、Netlify 或 Vercel。

如果子技能名称发生变化,优先使用本地安装的具有相同用途的技能。

子技能契约矩阵

使用此矩阵来决定交接和修复循环:

子技能必需输入预期输出成功门控如果门控失败
search-blog-theme用户品味、目的、参考资料或关键词3-5 个方向、已验证的参考 URL、一个推荐方向足够具体以进行构建搜索更多参考资料、完善隐喻或提出一个偏好问题
find-style-references所选样式方向、网站类型、情绪词或示例4-8 个真实参考、浏览器观察、可构建设计简报尽可能从多个搜索角度检查至少 3 个强参考扩大搜索范围、检查更强的参考或返回 search-blog-theme
make-personal-site方向、内容/个人资料提示、页面范围、输出文件夹包含代表性页面、资产、EDITING.md 的纯静态网站必需的页面类型、相对路径、UTF-8 源文件、本地预览修复结构/路径/资产,然后 review-static-site
copy-website-style目标 URL/截图/模板和范围包含页面地图、占位符/用户内容、EDITING.md 的静态样式重建标志性布局/动效/页面类型与请求的保真度匹配重新检查目标、迭代重建,然后 review-static-site
personalize-site现有网站加上用户身份/内容已替换的身份、链接、元数据、资产、占位符/源清理用户内容可见且残留已移除重新盘点内容位置或使用 edit-site-part 处理布局适配
add-blog-posts现有网站加上源文章/资产新文章页面、更新后的索引/数据、复制的资产、编辑笔记文章正确渲染,链接/资产/数学内容/富内容正常工作修复转换/索引/资产或使用 edit-site-part 处理本地展示问题
edit-site-part现有网站加上目标页面/区域/更改小的、范围限定的代码/内容/样式/交互编辑同一浏览器区域显示所请求的更改且未引起无关破坏重新映射源并进行更小的修正性编辑
review-static-site静态根目录、预期范围、可选禁止字符串/参考发现或修复、审计/浏览器结果、通过/失败状态不存在阻碍性障碍将障碍路由到最小责任的子技能
publish-static-site已验证的部署根目录加上所选平台/模式部署设置/配置、可选实时 URL、部署后检查正确的文件夹已部署且实时 URL 正常工作修复本地障碍、部署设置或帐户/DNS 步骤

操作原则

  • 先路由,后执行。在进行广泛编辑之前决定正确的链。
  • 确保每一步的输出可被下一步使用。
  • 除非用户明确请求其他技术栈,否则在此版本中优先使用纯 HTML/CSS/JS 和零依赖。
  • 不要将个人网站或博客转变为营销着陆页。
  • 当缺少用户数据时,不要编造详细的个人事实。
  • 在样式重建中默认替换复制的源网站身份。
  • 默认使用页面相对链接和资产;避免根绝对路径的网站本地路径,例如 /assets/... 或 /posts/...。
  • 在任何生成、重建、个性化、文章导入或广泛编辑之后,使用 review-static-site 进行验证。
  • 除非用户明确请求,否则停留在本地已验证的网站。
  • 除非用户明确请求,否则不要创建仓库、推送代码、部署、绑定域名或更改 DNS。

接收

仅收集下一步决策所需的信息。不要过度询问用户。

有用输入:

  • 所需输出文件夹或现有网站文件夹。
  • 用户是否想要新网站、重建参考、导入内容、个性化、本地编辑、验证或发布。
  • 参考 URL、截图、模板或主题词。
  • 用户身份材料:姓名、简介、链接、简历、项目、头像/标志、旧主页、GitHub 个人资料。
  • 内容材料:Markdown、Obsidian 笔记、Word 文档、旧文章、图片文件夹或粘贴的文本。
  • 发布目标:GitHub Pages、Cloudflare Pages、Netlify、Vercel 或仅提供指导。

如果请求足够清晰,则继续。仅在多个路由会产生截然不同的工作时才提出一个简洁的问题。

路由

根据用户当前状态选择工作流:

  • 模糊的想法或“给我找个样式”:使用 search-blog-theme,然后在原创构建之前使用 find-style-references。
  • 已选择方向但无特定目标网站:使用 find-style-references,然后使用 make-personal-site。
  • 指定了要紧密匹配的目标 URL/截图/模板:使用 copy-website-style。
  • 现有生成的网站仍包含占位符或复制的身份:使用 personalize-site。
  • 现有网站加上新文章/笔记/文档:使用 add-blog-posts。
  • 现有网站加上一个小的视觉/文本/布局/交互更改:使用 edit-site-part。
  • “检查这个网站”、“这个够好吗”、“发布前”:使用 review-static-site。
  • “部署”、“发布”、“GitHub Pages”、“Cloudflare Pages”、“Netlify”、“Vercel”:使用 publish-static-site,并在之前使用 review-static-site。

当用户请求完整的一键构建时,选择处理实际输入的最短链。不要仅仅因为存在就运行所有子技能。

路由示例

使用这些示例来稳定路由:

用户请求模式路由
“我想要一个独特的个人博客,帮我选个样式”search-blog-theme
“在构建前为这个选定的样式找到真实参考”find-style-references
“在这个选定的方向上给我建一个个人网站”find-style-references -> make-personal-site -> review-static-site
“从头构建一个完整的个人博客”如果需要则 search-blog-theme -> find-style-references -> make-personal-site -> 如果内容存在则 personalize-site -> review-static-site
“使用这个 URL 作为参考并重建它”copy-website-style -> personalize-site -> review-static-site
“复制这个网站但将其内容替换为我的”copy-website-style -> personalize-site -> review-static-site
“这是我生成的网站,用我的简历/项目/链接替换占位符”personalize-site -> review-static-site
“将这篇 Markdown/Obsidian/Word 文章添加到网站”add-blog-posts -> review-static-site
“更改这一部分/颜色/标题/卡片/菜单”edit-site-part;仅当共享结构或资产更改时才添加 review-static-site
“检查这个网站是否准备好”review-static-site
“将其部署到 Cloudflare Pages/GitHub Pages/Netlify/Vercel”review-static-site -> publish-static-site
“它在本地通过 HTTP 工作,但双击 index.html 不行”review-static-site;在发布前修复路径门控失败

标准流水线

从创意到原创网站

当用户只有粗略目标或样式偏好时使用。

  1. 如果视觉方向不明确,使用 search-blog-theme。
  2. 使用 find-style-references 将所选方向锚定在真实网站/模板/截图中。
  3. 使用 make-personal-site 创建静态网站。
  4. 如果用户提供了身份/内容或网站有应填充的占位符,使用 personalize-site。
  5. 使用 review-static-site 作为硬 QA 门控。
  6. 除非请求了发布,否则提供本地预览说明后停止。

从参考到个人网站

当用户提供目标 URL、截图、v0 模板、Figma 设计或要匹配的现有网站时使用。

  1. 使用 copy-website-style 重建布局、动效、页面类型和交互。
  2. 使用 personalize-site 替换目标身份和占位符内容。
  3. 如果用户提供了写作内容,使用 add-blog-posts。
  4. 使用 review-static-site 作为硬 QA 门控。
  5. 除非请求了发布,否则提供本地预览说明后停止。

内容优先的博客

当用户最强的输入是文章、笔记、Markdown、Word 文件或旧的写作档案时使用。

  1. 仅当没有网站/主题存在时,使用 search-blog-theme。
  2. 如果需要新的原创视觉系统,使用 find-style-references。
  3. 如果尚不存在静态网站,使用 make-personal-site。
  4. 使用 add-blog-posts 将内容导入现有网站的文章系统。
  5. 如果身份/个人资料内容仍为通用内容,使用 personalize-site。
  6. 使用 review-static-site 作为硬 QA 门控。
  7. 除非请求了发布,否则提供本地预览说明后停止。

现有网站改进

当用户已有生成的网站文件夹时使用。

  1. 检查网站和 EDITING.md(如果存在)。
  2. 使用 personalize-site 进行身份/内容替换。
  3. 使用 add-blog-posts 进行文章导入。
  4. 使用 edit-site-part 进行聚焦的设计或文本更改。
  5. 当更改影响导航、页面类型、资产、编码、发布就绪性或超过一个页面时,使用 review-static-site。

发布就绪的网站

当用户请求发布或部署时使用。

  1. 首先使用 review-static-site。
  2. 如果审查发现问题,修复障碍或路由到相关的子技能。
  3. 仅当网站通过必要的本地检查或用户接受已知风险后,使用 publish-static-site。
  4. 部署完成后验证实时 URL。

质量门控

在相关门控通过或用户接受明确限制之前,工作流未完成。

主题门控:

  • 视觉方向或参考足够具体以进行构建。
  • 如果构建是原创的且基于品味词,已从多个角度搜索真实的样式参考,并尽可能检查了至少 3 个强参考,或者用户明确放弃了该步骤。
  • 所选方法与用户的网站类型匹配:博客、作品集、研究主页、数字花园、笔记、链接或混合型。

结构门控:

  • 必需的页面类型存在,而不仅仅是主页。
  • 类似博客的网站至少包含一个文章/详情页面和一个列表/归档入口。
  • 导航指向真实生成的页面。

内容门控:

  • 用户提供的身份/内容出现在预期位置。
  • 仅含占位符的内容被明确标记或替换。
  • 在样式重建中,复制的源网站身份已被移除,除非用户拥有它或拥有权限。

路径门控:

  • 网站本地链接和资产默认使用页面相对路径。
  • 嵌套页面使用正确的 ../ 深度。
  • HTML、CSS url(...)、JavaScript 生成的链接、数据文件、封面图片、字体和供应商资产避免意外的根绝对路径。
  • 直接打开 index.html 不应丢失 CSS、JS、图片或导航。

编码门控:

...

[为翻译而截断]

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

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 to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

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.

相关技能