# 裂潮卡牌：網頁卡牌遊戲 Skill：技能書與協作來源

從一款可玩的卡牌遊戲學習前端、狀態與規則設計。

## 工坊收錄說明

作品與開源

想用 AI 一起製作網頁遊戲的人。

一項經規則與畫面驗證的小改版。

在 AI 開發公會交流遊戲規則與 Agent 協作實作。

先跑原作並完成一局，再挑一個小問題修改。

## 封面與來源署名

作者：阿軒哥哥（阿軒割割）

封面插畫：/art/skills/web-card-game-skill.webp

原作者 GitHub：https://github.com/mars-tw/web-card-game-skill

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/web-card-game-skill/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

原生網頁卡牌遊戲與開發 Skill

- 想做網頁遊戲的人

- 以 Agent 學習前端與遊戲規則的開發者

## 功能與使用範圍

MIT 原始碼，遊戲執行期無外部依賴；本機開發及測試另需工具。AI 美術生成可選，需自行準備服務與費用，素材依 CREDITS 核對。

- 回合制卡牌對戰與電腦對手

- 開卡包、收藏、牌組與本機存檔

- SKILL、資料模型與美術生成流程

## 開始前準備

- Node.js 20 以上、npm 與原作要求的靜態伺服器環境

- 閱讀 SKILL.md、AGENTS.md 與卡牌資料格式

- 修改素材前核對 CREDITS 與個別授權

## 第一個練習

1. 依 README 從 repo 根目錄啟動，先玩一局並匯出測試存檔。

2. 請 Agent 閱讀 SKILL.md，選一項卡牌規則或手機操作問題。

3. 用既有規則及瀏覽器測試核對修改，再回饋原作。

## 練習成果

一個可重現的規則或介面改進，附測試存檔與驗證結果。

## 專案與授權

原作 Repo：https://github.com/mars-tw/web-card-game-skill
從原作建立自己的版本：https://github.com/mars-tw/web-card-game-skill/fork
工坊整合參考：https://github.com/mars-tw/web-card-game-skill
記錄的授權：MIT

## 一起改這本技能書

改善卡牌規則、存檔相容性或手機無障礙；保留阿軒哥哥與原作素材來源，向 mars-tw 的原作送 PR。

原作 Repo：https://github.com/mars-tw/web-card-game-skill
預設 PR 目標：mars-tw/web-card-game-skill:main
從原作建立自己的版本：https://github.com/mars-tw/web-card-game-skill/fork
原作 PR：https://github.com/mars-tw/web-card-game-skill/pulls

工坊整合參考：https://github.com/mars-tw/web-card-game-skill
工坊整合任務專用 Fork：https://github.com/mars-tw/web-card-game-skill/fork
工坊任務：https://github.com/mars-tw/web-card-game-skill/issues
工坊 PR：https://github.com/mars-tw/web-card-game-skill/pulls
GitHub Milestones：https://github.com/mars-tw/web-card-game-skill/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 改善原生網頁卡牌遊戲與開發 Skill的第一個案例 · 建議任務

改善卡牌規則、存檔相容性或手機無障礙；保留阿軒哥哥與原作素材來源，向 mars-tw 的原作送 PR。

- 驗收：一個可重現的規則或介面改進，附測試存檔與驗證結果。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。

Agent Skill：/development/skills/web-card-game-skill/SKILL.md
協作 JSON：/api/v1/skills/web-card-game-skill/collaboration

## 參與開發

改善卡牌規則、存檔相容性或手機無障礙；保留阿軒哥哥與原作素材來源，向 mars-tw 的原作送 PR。

工坊 Issue／PR 協調入口：https://github.com/mars-tw/web-card-game-skill/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/mars-tw/web-card-game-skill/blob/d690b88ea23333d53d9126c51127ded6b24b4927/README.md
核對日期：2026-09-24
核對版本：d690b88ea23333d53d9126c51127ded6b24b4927

- README.md：https://github.com/mars-tw/web-card-game-skill/blob/d690b88ea23333d53d9126c51127ded6b24b4927/README.md

- SKILL.md：https://github.com/mars-tw/web-card-game-skill/blob/d690b88ea23333d53d9126c51127ded6b24b4927/SKILL.md

- LICENSE：https://github.com/mars-tw/web-card-game-skill/blob/d690b88ea23333d53d9126c51127ded6b24b4927/LICENSE

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map