Communitygithub.com

GiantClam/shpitto

针对个人作品集和博客网站的类型化生成合约。适用于简历、创作者网站、顾问简介以及以写作为导向的个人网站。

shpitto 是什么?

GiantClam/shpitto 技能定义了一个严格的类型化生成合约,专门用于构建个人作品集和博客网站。该技能的核心在于区分个人创作者网站与企业 B2B 网站,强调个人身份、视角和写作能力在首页的主导地位。它规定了首页必须是一个个人简介主导的编辑型页面,包含介绍人物及其专业判断的模块,而非通用的营销英雄区或文章目录。技能要求采用特定的编辑型技术期刊美学,使用暖色调、一种强调色和可读性强的长文排版,避免使用企业或通用主题。技能包含对博客路由的详细约定,要求生成完整的博客归档页面而非全部详情页,并支持独立的详情页生成工作流。此外,它还严格定义了共享壳(header、footer 和导航)的结构,要求一致且避免实现细节暴露,并提供了媒体选择的指导原则,偏好真实的操作或上下文图像而非装饰性占位符。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GiantClam/shpitto/tree/HEAD/apps/web/skills/portfolio-blog-site

在你喜欢的 AI 中提问

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

文档

作品集博客网站

当网站代表个人、创作者、顾问或以写作为导向的个人简介时,请使用此技能。

核心合约

  • 个人身份和观点可以主导首页。
  • 博客或写作可以作为一级路由和叙事展现面。
  • 在此处允许叙事、编辑节奏和个人简介故事讲述,这些在 corporate-b2b-site 中是不允许的。
  • 不要将企业公司外壳的期望强加于真正的作品集/博客网站。

首页合约

  • 首页必须介绍具名人物、其技术判断力,以及为什么观众应信任其写作或服务,然后将访问者引导至 /blog。
  • 将 / 视为以个人简介为主导的编辑型首页,而不是通用的营销主视觉区,也不是压缩的文章目录。
  • 推荐的首页顺序:
    • 个人简介主导的报头(masthead)
    • 专长或编辑支柱
    • 精选写作/证明条带
    • 简洁的行动号召或联系条带
  • 不要让首页看起来像归档说明、路由顺序注释或“从这里开始”的机械面板。
  • 如果首页开头或第一个支持条带使用了可视插槽,该插槽必须是以下之一:
    • 真实的操作者/出版物上下文图像,或
    • 包含特定文章、服务或可信内容的密集型写作/证明模块。
  • 不要输出信息量低的视觉填充物,例如浅渐变矩形、空白的上下文卡片、薄弱的右侧栏、装饰性占位框或几乎不携带真实证据的“特色上下文”面板。
  • 如果没有可信的图像,请用有实质内容的写作聚焦、编辑证明堆栈或操作者证据模块替换媒体插槽,而不是输出装饰性占位表面。
  • 当首页或支持条带使用左右版式时,文本块和媒体块必须对齐成一个精心配对的布局。不要将高文本板块与高度不匹配或基线不相关的小浮动图像块并排放置。
  • 如果布局使用了侧边图像,将该图像制作成合适的配套面板或卡片,具有稳定的宽高比、共享的垂直对齐以及足够的视觉重量来平衡文本列。

视觉身份合约

  • 作品集/博客表面不得重复使用与公司、文档或机构内容中心网站相同的视觉系统。
  • 首选编辑型技术期刊美学:温暖的纸张或石墨中性色、一种克制的强调色、可读性强的长文排版以及强的文章卡片层次结构。
  • 不要默认使用通用的绿白圆角卡片主题。
  • 主导版式应感觉像一本精良的个人出版物:个人简介报头、文章卡片、文章引导、编辑证明和简洁的联系时刻。

博客路由合约

  • /blog 可以是一级归档,但它必须保持为真正的网站路由,与网站其余部分共享相同的 header、footer、CSS 系统和导航合约。
  • 默认的首次网站生成必须保证一个强大的 /blog/index.html 归档页面,而不是一套完整的 /blog/{slug}/index.html 文章页面。
  • 如果归档显示了入门文章主题,在首次生成时将它们保留为归档就绪的卡片、摘要或集合条目。不要强制主要工作流预先完成每个详情页面。
  • 博客详情生成是一个独立的工作流阶段。在部署就绪后、自定义域名绑定前,或用户手动触发文章生成时运行它。
  • 当专用的 blog-detail-fill-workflow 激活时,每个请求的 /blog/{slug}/ 路由必须成为一个稳定的、由 slug 对齐的详情页面,具有真正的长文结构:一个路由拥有的 H1、一个强有力的引言、多个实质性的 H2 部分,以及足够的正文内容以读起来像完成的专业写作。
  • 除非确认的清单明确包含,否则不要发明归档-分类、标签或作者索引路由。
  • /blog 不得以一个大文本板块加上一个空白或薄弱的视觉边栏的形式打开。如果路由使用了支持性的归档上下文面板,该面板需要真实的归档证据:精选文章、出版线索、阅读主题或路由拥有的视觉实质内容。
  • 当有可信的支持图像时,归档和列表表面应优先使用图文文章卡片。如果路由已有空间放置配对的编辑缩略图或证明图像,不要默认为纯文本块。
  • 产品般的展示、文章分类账、精选写作条带和证明展示架应优先使用集成的图文卡片,而不是分离的文本行加上一个脱节的视觉占位符。

共享壳合约

  • Header、导航顺序、footer 目的地以及共享样式表/脚本引用必须在 /、/blog、/about、/contact 以及任何显式的 /blog/{slug}/ 路由之间保持一致。
  • 对于诸如 Home / Blog / About / Contact 的紧凑路由集,桌面和平板 header 应直接渲染主要链接。当链接已经适合一行时,不要留下可见的文本“菜单”按钮在桌面导航中。
  • 如果为窄宽度使用了折叠触发器,它必须是仅移动端可见的,并有匹配的 CSS 和 JavaScript 支持。不要交付一个 toggle 可见但导航从未折叠的 header。
  • 内部路由在开头模块和编辑节奏上可能有所不同,但不得将 footer 折叠成一个扁平的法定行或偏离到一次性的壳标记中。
  • 共享壳的文案必须保持面对访问者。不要在可见文案中暴露实现说明、文章计数指令、发布工作流文本或设计系统理由。
  • 博客详情页面必须继承与首页和博客索引相同的共享 footer 目的地集合。
  • Footer 必须使用结构化的 footer 壳,而不是裸 pagefoot 行或扁平的链接流。最小形状:
    • 一个与主要内容有明显视觉分隔的 footer 条带
    • 一个身份/品牌区域
    • 一个导航/链接区域
    • 一个支持/元/操作区域
  • 如果共享 CSS 定义了诸如 site-footer__inner、footer-grid、footer-brand、footer-links、footer-nav、footer-meta、footer-actions、footer-bottom 或等效的 BEM/footer 列类,HTML footer 必须使用这些相同的结构化区域,而不是折叠成一个单一的行内行。
  • Footer 分组必须保持清晰。不要在多个标题下重复相同的路由集,例如同时有“主导航”和“关键部分”;每个 footer 组需要独立的工作。

文案排除项

  • 不要暴露路由处理机制的措辞,例如“从这三篇文章开始”、“本页面收集”、“阅读顺序”或“继续到下一页”。
  • 不要暴露内部 QA 或布局标签,例如 Responsive layout、Shared shell、Desktop and mobile review、homepage groups 或 visual system keeps。
  • 不要在可见的博客详情正文中使用占位文章填充、TODO 标签、lorem ipsum 或抽象的内容策略评论。

媒体偏好

  • 当简报是技术型个人网站、顾问简介或以写作为导向的出版物时,只要路由已经预留了视觉空间,优先在 / 和 /blog 上使用真实的操作者/编辑上下文图像。
  • 好的匹配包括工作区、写作桌、会议桌、笔记本、编辑、研究或实现上下文的摄影,以强化路由目的。
  • 当有可信的上下文图像可用时,不要用抽象渐变、空卡片、通用图标拼贴或薄弱支持栏来填充这些插槽。

Individual skills in this repo

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

相关技能