Communitygithub.com

GiantClam/shpitto

用於個人作品集與部落格網站的類型特定生成合約。適用於履歷、創作者網站、顧問簡介及以寫作為導向的個人網站。

shpitto 是什麼?

這個技能為開發者提供了一套嚴謹的合約,用於生成個人作品集或部落格網站,特別適合個人、創作者、顧問或寫作主導的簡介網站。它明確區分了個人網站與企業網站(如 corporate-b2b-site)的設計模式,禁止套用企業慣例,並要求首頁以人物介紹、專業判斷與信任建立為主軸,引導訪客進入部落格。技能支援所有主流 AI 代理平台(如 Claude Code、Cursor、Codex),透過 SKILL.md 文件定義詳細的視覺樣式、共享頁面外殼與部落格路由規範。視覺上偏好編輯式科技期刊美學,避免預設的綠白圓角卡片主題,並強調真實圖像與紮實內容,而非低資訊的裝飾性佔位元素。此外,它嚴格規範部落格存檔頁面的生成順序(先建立存檔頁,再逐一產生文章明細),並對共享頁頭、頁尾與導航系統的一致性提出強制要求,確保最終產出是一個可實際部署的、高品質的個人出版品。

相容平台~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。
  • 將 / 視為以個人簡介為導向的編輯式首頁,而非一般的行銷英雄區,也非壓縮的文章目錄。
  • 偏好的首頁順序:
    • 以個人簡介為主的大標題區
    • 專業領域或編輯支柱
    • 精選寫作/證明帶
    • 簡潔的 CTA 或聯絡條
  • 不要讓首頁看起來像存檔說明、路由順序備註或「從這裡開始」的機制面板。
  • 如果首頁開場或第一個支援帶使用視覺插槽,該插槽必須是:
    • 真實的運營者/出版背景圖像,或
    • 包含具體文章、服務或可信度實質內容的密集寫作/證明模組。
  • 不要輸出低資訊的視覺填充物,例如淺色漸層矩形、空白的內容卡片、薄弱的右側欄、裝飾性的佔位方塊,或幾乎沒有真實證據的「精選內容」面板。
  • 如果沒有可信的圖像,請用實質的寫作亮點、編輯證明堆疊或營運者證據模組取代媒體插槽,而不是輸出裝飾性的佔位表面。
  • 當首頁或支援帶使用左右並排構圖時,文字區塊與媒體區塊必須對齊為一個有意的配對佈局。不要渲染一個高大的文字板塊旁邊漂浮著一個高度不匹配或基準線無關的小圖像拼貼。
  • 如果佈局使用側邊圖像,請確保該圖像是一個適當的配套面板或卡片,具有穩定的長寬比、共享的垂直對齊,以及足夠的視覺重量來平衡文字欄。

視覺識別合約

  • 作品集/部落格表面不得重複使用與企業、文件或機構內容中心網站相同的視覺系統。
  • 偏好編輯式科技期刊美學,使用溫暖的紙張或石墨中性色、一個有紀律的重點色、可讀的長篇文章排版,以及強烈的文章卡片層級。
  • 不要預設使用通用的綠白圓角卡片主題。
  • 主要構圖應感覺像一份精緻的個人出版品:個人簡介大標題、文章卡片、文章引言、編輯證明,以及緊湊的聯絡時刻。

部落格路由合約

  • /blog 可以是一級存檔,但它必須保持為一個真實的網站路由,與網站其他部分共享相同的頁頭、頁尾、CSS 系統和導航合約。
  • 預設的首次網站生成必須保證一個強大的 /blog/index.html 存檔頁面,而不是一整套 /blog/{slug}/index.html 文章頁面。
  • 如果存檔頁顯示了入門文章主題,請在第一次生成時將它們保留為存檔就緒的卡片、摘要或集合條目。不要強迫主要工作流程立即完成每個細節頁面。
  • 部落格詳細頁面生成是一個獨立的工作流程階段。請在部署就緒之後、自訂網域綁定之前執行,或是當使用者手動觸發文章生成時執行。
  • 當專用的 blog-detail-fill-workflow 啟用時,每個被請求的 /blog/{slug}/ 路由都必須變成一個穩定的、使用短網址對齊的詳細頁面,具有真正的長篇文章結構:一個路由擁有的 H1、一個強而有力的引言、多個實質的 H2 章節,以及足夠的真實內文,使其讀起來像一篇完成的技術寫作。
  • 除非已確認的網站清單明確包含,否則不要發明存檔分類、標籤或作者索引路由。
  • /blog 不得以一個巨大的文字板塊加上一個空白或薄弱的視覺欄開啟。如果該路由使用支援性的存檔背景面板,該面板需要真實的存檔證據:精選文章、出版提示、閱讀主題,或路由擁有的視覺實質內容。
  • 當有可信的支援圖像時,存檔和列表表面應偏好使用圖文並茂的文章卡片。如果路由已經有空間容納配對的編輯縮圖或證明圖像,不要預設將存檔改為純文字區塊。
  • 產品式的展示、文章分類帳、精選寫作帶和證明架,應偏好整合的圖文卡片,而非分離的文字行加上一個獨立的視覺佔位符。

共享頁面外殼合約

  • 頁頭、導航順序、頁尾目的地,以及共享樣式表/腳本引用,必須在 /、/blog、/about、/contact 和任何明確的 /blog/{slug}/ 路由之間保持一致。
  • 對於像「首頁 / 部落格 / 關於 / 聯絡」這樣的精簡路由集,桌面和平板電腦的頁頭應直接呈現主要連結。當連結已可在一行內顯示時,不要在桌面導航中留下一個可見的文字「選單」按鈕。
  • 如果為窄螢幕使用了揭露觸發器,它必須僅限行動裝置使用,並有匹配的 CSS 和 JavaScript 支援。不要出貨一個切換按鈕可見但導航從未收合的頁頭。
  • 內部路由可以在開場模組和編輯節奏上有所變化,但不得將頁尾收合為一個平坦的法律資訊列,或偏離為一次性外殼標記。
  • 共享外殼的文案必須保持面向訪客。不要在可見文案中暴露實作說明、文章計數指示、發佈工作流程文字或設計系統理由。
  • 部落格詳細頁面必須繼承與首頁和部落格索引相同的共享頁尾目的地集合。
  • 頁尾必須使用結構化的頁尾外殼,而非裸露的 pagefoot 列或平坦的錨點串流。最低形狀:
    • 一個與主要內容有明顯分隔的頁尾帶
    • 一個識別/品牌區
    • 一個導航/連結區
    • 一個支援/元資料/動作區
  • 如果共享 CSS 定義了頁尾外殼工具類,例如 site-footer__inner、footer-grid、footer-brand、footer-links、footer-nav、footer-meta、footer-actions、footer-bottom 或等效的 BEM/頁尾欄位類別,那麼 HTML 頁尾必須使用這些相同的結構化區域,而不是收合為單一內嵌行。
  • 頁尾分組必須保持明確。不要在「主要導航」和「關鍵章節」等多個標題下重複相同的路由集合;每個頁尾群組需要一個獨立的工作。

文案排除清單

  • 不要暴露路由機制用語,例如「從這三篇文章開始」、「此頁面收集」、「閱讀順序」或「繼續到下一頁」。
  • 不要暴露內部 QA 或佈局標籤,例如「響應式佈局」、「共享外殼」、「桌面和行動裝置審查」、「首頁群組」或「視覺系統保留」。
  • 在可見的部落格詳細散文中,不要使用佔位文章填充、TODO 標籤、Lorem Ipsum 或抽象的內容策略評論。

媒體偏好

  • 當簡報是技術個人網站、顧問簡介或寫作主導的出版品時,只要路由已保留視覺空間,請在 / 和 /blog 偏好使用真實的營運者/編輯背景圖像。
  • 良好的匹配包括強化路由目的的工作空間、寫作桌、會議桌、筆記本、編輯、研究或實作背景攝影。
  • 當有可信的背景圖像可用時,不要用抽象漸層、空白卡片、通用圖示馬賽克或薄弱的支援欄來填充這些插槽。

Individual skills in this repo

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

相關技能