SODA 个人网站搭建
帮助一个人把「我是谁 → 我经历过什么 → 我如何思考和做事 → 我创造了什么」做成可持续更新的个人网站。
默认交付可运行代码、用户自己的内容、桌面与手机验证证据和维护说明。只被要求规划、审查或改文案时,交付相应结果,不擅自生成新项目。
必须保留的判断
- 先读工作区规则、已有网站和用户材料。新建目录才用附带模板;已有网站先判断所需页面与组件,保留其技术栈、路由和现有功能。
- 参考站是结构与视觉来源,不是内容库。不得复制原作者的身份、履历、照片、文章、联系方式、二维码、项目证据或音乐,也不需要访问原作者的私有仓库。
- 所有成就、合作、评价和经历必须来自用户。材料不足时隐藏对应模块、保留空状态或标成演示;不得自动补造可信度。
- 默认保留暖纸面、深墨色、橙色点缀、杂志式大标题、细线分隔与克制动态。具体取舍见 设计与来源。
- 默认首页只含首屏、关于、作品、文章与联系,不显示 S/O/D/A、四房间入口或原作者的个人品牌。
rooms默认为空;只有使用者明确需要独立档案时才添加相应配置,不要求凑齐四项。 - 本地生成、安装依赖、Git 同步、Preview、正式上线是不同动作;依照用户和工作区授权分别执行。不得自动购买域名、接入收费服务或发布。
1. 判断当前需要推进什么
| 当前情况 | 动作 |
|---|---|
| 空目录,想搭建个人站 | 收集最小资料,用起步模板生成 |
| 已有头像、简历、作品、文章 | 只提取用户同意公开的事实,组织为配置 |
| 没有材料,想先看效果 | 使用明确标注的演示资料,保持 demo=true、publish=false |
| 已有个人网站 | 先读代码,按需要移植结构/组件,不能重新覆盖整个站 |
| 只问如何搭建或要求方案 | 解释对应步骤与成本,不执行创建或发布 |
| 要电商、会员支付或管理后台 | 说明模板覆盖个人展示,另行明确这些业务,不冒充已有支持 |
优先从当前对话与获授权文件恢复信息。只有缺失会实质影响页面内容时,合并问一次:公开称呼、最想被谁认识、对方看完后希望做什么、可公开作品/文章/联系方式。已有答案不重复问。照片、MBTI、星座、地域和音乐均不必提供。
2. 把个人材料组织成站点
读取 内容与配置。用一句话说明网站让谁认识这个人的哪条主线,再按实际材料组织:
- 首屏:公开名字、一句真实方向、简短说明、一个主要入口。
- 关于:具体经历与当下方向,不自动添加原作者的品牌框架。
- 作品:为谁做、解决什么、当前状态、可见成果。内部项目不生成公开访问链接。
- 思考与实践:观点文章放 Orbit,做法与复盘放 Digest;不要求固定字数或数量。
- 联系:只放本人选择公开的邮箱与社交链接。
不要把用户提供的整份简历、私密复盘或原始文档无差别写进网页。先提取已授权公开的内容;配置也是源码,不能存放密钥或私密资料。
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 不要求建站者提供账号密码,不承诺托管永久免费,不默认启用分析或收集访客数据。网站可以在本地运行;是否发布到哪个平台,由建站者决定。