# 平台工具接入包：技能書與協作來源

用現成範例，練習讓 AI 工具讀取平台狀態。

## 工坊收錄說明

作品與開源

想研究工坊工具串接、能操作程式環境的人。

一個能跑測試的本機查詢小改動。

適合平台工程與 AI 公會研究工具接入；目前先用本機示範練習。

照準備步驟啟動本機範例，先看懂一次查詢的輸入與輸出。

## 封面與來源署名

封面插畫：/art/skills/agent-kit.webp

原作者 GitHub：https://github.com/FreeTWAI/freedom-agent-kit

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

原作數據：/api/v1/github/books/agent-kit/metrics

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

## 讀者與格式

開發接入範例

- 平台整合開發者

- 想為自己的 AI CLI 增加狀態查詢工具的人

## 功能與使用範圍

目前 CLI 只提供本機示範會員查詢；真實 Agent device flow、短效授權和 MCP server 仍待實作。

- 固定版本的平台 DTO 與共用 client

- 本機 demo 查詢完成後登出

- 協定來源與摘要核對工具

## 開始前準備

- Node.js 24

- 要執行狀態查詢需另有本機 Freedom Platform 示範服務

## 第一個練習

1. 先讀 README，分清現有 demo 查詢與尚未提供的正式代理授權。

2. 在副本跑測試，查看 CLI 如何呼叫共用 client。

3. 挑一項純讀取摘要改善輸出，不在工具內另建會員或任務真相。

## 練習成果

一個通過測試的本機狀態摘要小改動，附輸入、輸出與限制。

## 原始專案的起步指令

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

```sh
npm ci
npm test
```

## 專案與授權

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

## 一起改這本技能書

補充不同 CLI 的讀取範例、錯誤處理或正式授權需求。

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

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

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

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

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

### 補客戶端撤銷與版本不相容案例 · 建議任務

在既有 adapters 或 client 測試處理授權失效。

- 驗收：可重現無權限及契約版本錯誤；不直接改中央資料庫或擴充 token 範圍。

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

## 參與開發

補充不同 CLI 的讀取範例、錯誤處理或正式授權需求。

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

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

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

## 閱讀與來源

閱讀原始專案：https://github.com/FreeTWAI/freedom-agent-kit/blob/201fdab8017e2850bafc7b2f1e8dec7e4c0d6233/README.md
核對日期：2026-09-27
核對版本：201fdab8017e2850bafc7b2f1e8dec7e4c0d6233

- README.md：https://github.com/FreeTWAI/freedom-agent-kit/blob/201fdab8017e2850bafc7b2f1e8dec7e4c0d6233/README.md

- package.json：https://github.com/FreeTWAI/freedom-agent-kit/blob/201fdab8017e2850bafc7b2f1e8dec7e4c0d6233/package.json

## 共創原則

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

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