Communitygithub.com

Soda Personal Site

Design skill. Turns a personal brand, portfolio, and writing site into a runnable Next.js page with a hero, about, work, articles, and contact, without carrying over the original author's brand.

Was ist Soda Personal Site?

Soda Personal Site is a Claude Code agent skill that design skill. Turns a personal brand, portfolio, and writing site into a runnable Next.js page with a hero, about, work, articles, and contact, without carrying over the original author's brand.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sucrush912-commits/soda-personal-site/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SODA 个人网站搭建

帮助一个人把「我是谁 → 我经历过什么 → 我如何思考和做事 → 我创造了什么」做成可持续更新的个人网站。

默认交付可运行代码、用户自己的内容、桌面与手机验证证据和维护说明。只被要求规划、审查或改文案时,交付相应结果,不擅自生成新项目。

必须保留的判断

  • 先读工作区规则、已有网站和用户材料。新建目录才用附带模板;已有网站先判断所需页面与组件,保留其技术栈、路由和现有功能。
  • 参考站是结构与视觉来源,不是内容库。不得复制原作者的身份、履历、照片、文章、联系方式、二维码、项目证据或音乐,也不需要访问原作者的私有仓库。
  • 所有成就、合作、评价和经历必须来自用户。材料不足时隐藏对应模块、保留空状态或标成演示;不得自动补造可信度。
  • 默认保留暖纸面、深墨色、橙色点缀、杂志式大标题、细线分隔与克制动态。具体取舍见 设计与来源。
  • 默认首页只含首屏、关于、作品、文章与联系,不显示 S/O/D/A、四房间入口或原作者的个人品牌。rooms 默认为空;只有使用者明确需要独立档案时才添加相应配置,不要求凑齐四项。
  • 本地生成、安装依赖、Git 同步、Preview、正式上线是不同动作;依照用户和工作区授权分别执行。不得自动购买域名、接入收费服务或发布。

1. 判断当前需要推进什么

当前情况动作
空目录,想搭建个人站收集最小资料,用起步模板生成
已有头像、简历、作品、文章只提取用户同意公开的事实,组织为配置
没有材料,想先看效果使用明确标注的演示资料,保持 demo=true、publish=false
已有个人网站先读代码,按需要移植结构/组件,不能重新覆盖整个站
只问如何搭建或要求方案解释对应步骤与成本,不执行创建或发布
要电商、会员支付或管理后台说明模板覆盖个人展示,另行明确这些业务,不冒充已有支持

优先从当前对话与获授权文件恢复信息。只有缺失会实质影响页面内容时,合并问一次:公开称呼、最想被谁认识、对方看完后希望做什么、可公开作品/文章/联系方式。已有答案不重复问。照片、MBTI、星座、地域和音乐均不必提供。

2. 把个人材料组织成站点

读取 内容与配置。用一句话说明网站让谁认识这个人的哪条主线,再按实际材料组织:

  1. 首屏:公开名字、一句真实方向、简短说明、一个主要入口。
  2. 关于:具体经历与当下方向,不自动添加原作者的品牌框架。
  3. 作品:为谁做、解决什么、当前状态、可见成果。内部项目不生成公开访问链接。
  4. 思考与实践:观点文章放 Orbit,做法与复盘放 Digest;不要求固定字数或数量。
  5. 联系:只放本人选择公开的邮箱与社交链接。

不要把用户提供的整份简历、私密复盘或原始文档无差别写进网页。先提取已授权公开的内容;配置也是源码,不能存放密钥或私密资料。

3. 生成或实施

新建站点前读取 工程与验收。附带模板沿用来源站的 Next.js / React 技术栈,不要求其他 Skill 或 MCP。

模板在 assets/starter,内含演示配置、页面、交互和维护说明。先把用户资料整理成 JSON,字段以 site.config.json 为准;保留字段结构,不需要的数组留空。

在安装后 Skill 的实际目录执行(用工具定位目录,不猜测本机路径):

node scripts/create-site.mjs --profile /path/to/profile.json --output /path/to/new-personal-site

只看演示时省略 --profile。生成器拒绝已有目标目录,不执行网络请求、依赖安装、Git 操作或部署。不要删除目标文件以绕过保护,也不要添加强制覆盖选项。

生成后进入站点目录,按照生成的 README 安装并运行。用户图片复制到生成站点的 public/images/,不得写进 Skill 安装目录;路径只能用本地 /images/ 图片。改 site.config.json 即更新姓名、文案、房间、作品、文章和链接。

已有网站只实施当前需要的最小改动,保留 SEO 锁定、权限、业务与内容。技术栈不兼容时移植设计与结构,不把整个模板生硬嵌入。

4. 验证真实可用

  • 运行配置校验、lint、生产构建与类型检查;检查输出与退出码。
  • 用新生成的站点验证至少一条完整路径:认识作者 → 查看作品/文章 → 找到联系入口。
  • 在 1440px 与 390px 查看中英文和明暗模式。检查文字实际绘制范围,不能用 overflow-x:hidden 遮住错误。
  • 检查文章筛选、弹窗滚动/展开/Esc/焦点返回、独立文章链接与主题跨页刷新。没有素材的模块应有真实留白,链接不得指回来源作者。
  • 默认禁止索引。用户确认正式域名、真实内容和发布操作后,再设置 demo=false、自己的 siteUrl 与 publish=true;重新构建并复验 canonical、robots、sitemap、分享图与 404。
  • 不运行未做过的步骤就宣称已通过;无网络、无浏览器或依赖失败时,明确报告已完成和未验证部分。

5. 交付

向用户提供:生成站点的绝对路径、启动方式、内容维护入口、实际验证结果、可预览位置、未完成事项,以及 Git/Preview/生产发布的真实状态。

本 Skill 不要求建站者提供账号密码,不承诺托管永久免费,不默认启用分析或收集访客数据。网站可以在本地运行;是否发布到哪个平台,由建站者决定。

Verwandte Skills