Communitygithub.com

al-folio v1 遷移

當使用者要求代理程式將現有自訂的 al-folio 分支遷移至 v1.x 時使用此技能。

al-folio v1 遷移 是什麼?

此技能專為基於 Jekyll 的 al-folio 學術網站主題,從舊版自訂分支遷移至最新的 v1.x 系列而設計。它提供結構化的逐步工作流程,確保在遷移過程中僅移動站點自有的檔案(如 _config.yml、_data、_bibliography、內容集合和靜態資產),同時保留 v1 核心外掛程式(al_folio_core)及其捆綁的 Gem 與配置設定。此技能能自動識別並移除那些已被外掛程式接管的多餘執行時期檔案,僅保留使用者有意保留的覆蓋覆寫。透過內建的檢查指令(如 `al-folio upgrade audit`),它會比對本地檔案與上游外掛的校驗和,協助開發者提交 `.al-folio-overrides.yml` 來記錄並管理覆蓋覆寫。此技能支援 Claude Code、Cursort 等具備終端機存取能力的 AI 代理,建議在可拋棄的分支或複製環境中執行,以避免汙染原始網站。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/krishnendu-pain/krishnendu-pain.github.io/tree/HEAD/.agents/skills/al-folio-v1-migration

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

al-folio v1 遷移 是做什麼的?

當使用者要求代理程式將現有自訂的 al-folio 分支遷移至 v1.x 時使用此技能。

工作流程

  1. 在可拋棄的分支、複製或複製環境中操作。請勿覆蓋使用者的原始站點。
  2. 從 v1 入門合約開始,然後帶入站點自有的檔案:
    • _config.yml 的數值
    • _data
    • _bibliography
    • 內容集合
    • 站點資產
    • 刻意保留的本機 _includes、_layouts 和 _sass 覆蓋覆寫
  3. 保留入門合約中的 v1 外掛程式配線:
    • theme: al_folio_core
    • 在 Gemfile 中捆綁的 al_* 與 al_folio_* Gem
    • 在 _config.yml 中捆綁的外掛程式條目
  4. 移除現在由外掛程式擁有的過時複製執行時期檔案,除非是刻意保留的覆蓋覆寫。
  5. 執行升級檢查:
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
  1. 針對每個過時或未認可的覆蓋覆寫:
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
  1. 建立並檢查主要頁面:首頁、CV、論文、倉庫、專案、文章以及任何自訂路由。

遷移注意事項

當站點刻意保留本機覆蓋覆寫時,請提交 .al-folio-overrides.yml。它會記錄上次審查的上游外掛程式檔案校驗和,以便未來 Gem 更新時能明確標示差異。

交接

報告已移除的過時執行時期檔案、保留的本機覆蓋覆寫、未解決的視覺差異以及確切的驗證指令。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能