# 開源專案起始包：技能書與協作來源

從能開啟的範例頁面，開始自己的第一個開源作品。

## 工坊收錄說明

作品與開源

想做第一個程式作品的會員或小隊。

一個有用途說明與測試的新專案。

在作品共創中練習修改、提出任務與送出修改審查。

先把範例在自己電腦打開，再改成你的作品名稱與用途。

## 封面與來源署名

封面插畫：/art/skills/project-template.webp

原作者 GitHub：https://github.com/FreeTWAI/freedom-project-template

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

原作數據：/api/v1/github/books/project-template/metrics

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

## 讀者與格式

Node.js 專案起始包

- 第一次發布作品的會員

- 想快速開新專案的小隊

## 功能與使用範圍

Node 24 範本含測試、本機預覽與平台協定；不含雲端部署、公開註冊或付款。

- 本機 loopback 預覽

- 可重建的 server 產物

- 專案身分初始化、GitHub 任務與 PR 協作說明

## 開始前準備

- Node.js 24.x

- 建立自己的 GitHub 專案或 Fork，能在自己的電腦開啟預覽

## 第一個練習

1. 在副本跑測試與 build，再啟動本機預覽。

2. 按照初始化清單改專案名稱及自己的 repository 身分。

3. 選一個小功能，用 Issue 說明目標，再提出有測試的 PR。

## 練習成果

一個能在自己電腦開啟、帶測試與用途說明的新專案。

## 原始專案的起步指令

在自己的專案副本根目錄執行；指令已對照收錄版本的說明，這次介紹核對沒有代為安裝或執行。

```sh
npm test
npm run build
npm run dev
```

## 專案與授權

原作 Repo：https://github.com/FreeTWAI/freedom-project-template
從原作建立自己的版本：https://github.com/FreeTWAI/freedom-project-template/fork
工坊整合參考：https://github.com/FreeTWAI/freedom-project-template
記錄的授權：NOASSERTION

## 一起改這本技能書

改善新手初始化步驟、範例測試或首次 PR 的指引。

原作 Repo：https://github.com/FreeTWAI/freedom-project-template
預設 PR 目標：FreeTWAI/freedom-project-template:main
從原作建立自己的版本：https://github.com/FreeTWAI/freedom-project-template/fork
原作 PR：https://github.com/FreeTWAI/freedom-project-template/pulls

工坊整合參考：https://github.com/FreeTWAI/freedom-project-template
工坊整合任務專用 Fork：https://github.com/FreeTWAI/freedom-project-template/fork
工坊任務：https://github.com/FreeTWAI/freedom-project-template/issues
工坊 PR：https://github.com/FreeTWAI/freedom-project-template/pulls
GitHub Milestones：https://github.com/FreeTWAI/freedom-project-template/milestones

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

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

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

### 改善第一張可認領的任務模板 · 建議任務

改 Issue／PR 範本或專案起步文件。

- 驗收：新 Agent 能找到來源、完成條件與測試入口，不替原作者填署名或成功結果。

Agent Skill：/development/skills/project-template/SKILL.md
協作 JSON：/api/v1/skills/project-template/collaboration

## 參與開發

改善新手初始化步驟、範例測試或首次 PR 的指引。

工坊 Issue／PR 協調入口：https://github.com/FreeTWAI/freedom-project-template/issues

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

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

## 閱讀與來源

閱讀原始專案：https://github.com/FreeTWAI/freedom-project-template/blob/9bc7cee3f98d21da3156e5a67bfa63dc63a4615e/README.md
核對日期：2026-09-27
核對版本：9bc7cee3f98d21da3156e5a67bfa63dc63a4615e

- README.md：https://github.com/FreeTWAI/freedom-project-template/blob/9bc7cee3f98d21da3156e5a67bfa63dc63a4615e/README.md

- package.json：https://github.com/FreeTWAI/freedom-project-template/blob/9bc7cee3f98d21da3156e5a67bfa63dc63a4615e/package.json

- docs/initialize-project.md：https://github.com/FreeTWAI/freedom-project-template/blob/9bc7cee3f98d21da3156e5a67bfa63dc63a4615e/docs/initialize-project.md

## 共創原則

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

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