# 小主腦：本機 AI 任務系統：技能書與協作來源

讓任務從交辦、背景執行到交回檔案形成完整流程。

## 工坊收錄說明

作品與開源

想拆解 Agent 系統、親手加一項能力的人。

一筆模擬任務及其可核對的本機成果。

在 AI 開發與 AI 導入與驗證公會交流任務處理及驗收方法。

先跑免費模擬模式，確認任務與結果的檔案位置。

## 封面與來源署名

作者：隊長

封面插畫：/art/skills/aiwff-runtime.webp

原作者 GitHub：https://github.com/zaxardery8011-design/aiwff-runtime

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

原作數據：/api/v1/github/books/aiwff-runtime/metrics

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

## 讀者與格式

本機 Agent 任務執行系統

- 想入門 Agent 的開發者

- 需要整理檔案或資料處理流程的人

## 功能與使用範圍

MIT 開源；預設 mock 模擬模式不需 API key。真實任務可選自己的 Claude CLI，或實驗性且預設關閉的 OpenAI 相容端點；後者沒有檔案工具，適合短分類與摘要。Gemini 與 Codex 這版沒有接成 worker。WebUI 建立任務要點開終端機印出的一次性登入連結。接外部模型或 Telegram 時，資料會傳往相應服務。

- WebUI 以一次性登入連結建立任務並追蹤背景 worker

- 以本機檔案保存任務、進度與成果

- 先用模擬模式驗流程，再自行選擇 Claude CLI 或無工具的相容端點

## 開始前準備

- Node.js 18 以上及自己的測試資料夾

- 閱讀繁中安裝文件與 AGENTS.md，限定可操作範圍

- 真實 Claude、相容模型端點與 Telegram 需自行設定

## 第一個練習

1. 依原作安裝文件啟動預設 mock 模式，先不接 Claude 或外部模型。

2. 用終端機印出的一次性登入連結開啟 WebUI，建立示範任務，找到進度與 data/artifacts 成果檔。

3. 核對成功與失敗結果後，再自行決定是否接真實 Claude worker。

## 練習成果

一筆可由 WebUI 追蹤、能找到本機成果檔的模擬任務。

## 專案與授權

原作 Repo：https://github.com/zaxardery8011-design/aiwff-runtime
從原作建立自己的版本：https://github.com/zaxardery8011-design/aiwff-runtime/fork
工坊整合參考：https://github.com/zaxardery8011-design/aiwff-runtime
記錄的授權：MIT

## 一起改這本技能書

改善原作任務失敗提示、成果檔檢查或新手文件；提交可重現紀錄，區分模擬與真實 Claude 結果。

原作 Repo：https://github.com/zaxardery8011-design/aiwff-runtime
預設 PR 目標：zaxardery8011-design/aiwff-runtime:master
從原作建立自己的版本：https://github.com/zaxardery8011-design/aiwff-runtime/fork
原作 PR：https://github.com/zaxardery8011-design/aiwff-runtime/pulls

工坊整合參考：https://github.com/zaxardery8011-design/aiwff-runtime
工坊整合任務專用 Fork：https://github.com/zaxardery8011-design/aiwff-runtime/fork
工坊任務：https://github.com/zaxardery8011-design/aiwff-runtime/issues
工坊 PR：https://github.com/zaxardery8011-design/aiwff-runtime/pulls
GitHub Milestones：https://github.com/zaxardery8011-design/aiwff-runtime/milestones

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

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

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

### 改善本機 Agent 任務執行系統的第一個案例 · 建議任務

改善原作任務失敗提示、成果檔檢查或新手文件；提交可重現紀錄，區分模擬與真實 Claude 結果。

- 驗收：一筆可由 WebUI 追蹤、能找到本機成果檔的模擬任務。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。

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

## 參與開發

改善原作任務失敗提示、成果檔檢查或新手文件；提交可重現紀錄，區分模擬與真實 Claude 結果。

工坊 Issue／PR 協調入口：https://github.com/zaxardery8011-design/aiwff-runtime/issues

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

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

## 閱讀與來源

閱讀原始專案：https://github.com/zaxardery8011-design/aiwff-runtime/blob/94b94abf6d0656de0a5998da4c4141d2e9971a7c/README.zh-TW.md
核對日期：2026-09-30
核對版本：94b94abf6d0656de0a5998da4c4141d2e9971a7c

- README.zh-TW.md：https://github.com/zaxardery8011-design/aiwff-runtime/blob/94b94abf6d0656de0a5998da4c4141d2e9971a7c/README.zh-TW.md

- AGENTS.md：https://github.com/zaxardery8011-design/aiwff-runtime/blob/94b94abf6d0656de0a5998da4c4141d2e9971a7c/AGENTS.md

- LICENSE：https://github.com/zaxardery8011-design/aiwff-runtime/blob/94b94abf6d0656de0a5998da4c4141d2e9971a7c/LICENSE

## 共創原則

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

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