SKILL FACTORY / 開發者文件

技能開發者中心

下載 ≠ 安裝；安裝 ≠ 執行；AI 文字評分 ≠ 外部認證。僅提供人工審核的文字快照與授權。正式結帳、撥款與模擬交易保持 OFF。

先審閱，再手動安裝

從原始碼取得工具，先審閱 installer.mjs，再用 Node.js 22 或 24 執行。網站不會自動下載或執行工具。範例中的 skill-slug@1 請換成已審核技能的確切版本；工作目錄必須已存在且由你管理。

node tools/skill-factory/installer.mjs search checklist

node tools/skill-factory/installer.mjs inspect skill-slug@1

node tools/skill-factory/installer.mjs install skill-slug@1 --workspace "C:\Projects\MyProject" --dry-run

node tools/skill-factory/installer.mjs install skill-slug@1 --workspace "C:\Projects\MyProject" --target codex

node tools/skill-factory/installer.mjs list - --workspace "C:\Projects\MyProject" --target codex

node tools/skill-factory/installer.mjs verify skill-slug --workspace "C:\Projects\MyProject" --target codex

node tools/skill-factory/installer.mjs update skill-slug@2 --workspace "C:\Projects\MyProject" --target codex

node tools/skill-factory/installer.mjs uninstall skill-slug --workspace "C:\Projects\MyProject" --target codex

Linux／macOS 請改用自己的絕對工作目錄。預設寫到 .skill-factory/skills；--target codex 明確選擇 .agents/skills。無全域安裝、遠端 shell、腳本解壓或 post-install hook。更新／移除保留隱藏備份；工具不覆寫已修改或非工具管理的檔案。

分發 API v1

GET /api/distribution/v1/search?q=文字&offset=0：每頁最多 20 筆公開技能。

GET /api/distribution/v1/releases/slug/1：releaseId、授權全文／版本／hash，以及 SKILL.md、LICENSE.md 的確切 UTF-8 位元組 SHA-256。ETag 使用条件讀取，但每次仍確認當前公開狀態。

POST /api/distribution/v1/releases/slug/1/download：JSON requestKey（UUID）；回傳兩個固定文字檔與 manifest。不下載任意 URL，不允許重新導向。telemetry 預設 false。

POST /api/distribution/v1/releases/slug/1/acknowledge：只有 opt-in 下載取得的一小時簽章 receipt 可宣告 verified_download／installation_claim，重送不重計。這是客戶端聲明，不代表平台能獨立驗證本機執行。

錯誤以 error.code 回傳：400 格式錯誤、401 登入失效、403 精確授權確認不足、404 版本已下架或不存在、409 請求衝突、429 限流、503 暫時不可用。限流可能由共同閘道／NAT 共用，請依 Retry-After 重試。不得把無效憑證或私人 UUID 放進查詢字串。

授權與安全界線

CC 授權不新增點擊確認門檻。限制性自訂授權需先 inspect 閱讀全文，再以短期 SKILL_FACTORY_TOKEN 環境變數登入，並明確傳入 --accept-license-hash 精確條款雜湊。不要把 token 貼到指令參數、版本控制或客服。重新授權的新版本不追溯修改已下載副本。

下架或暫停立即停止新的分發，已下載副本無法遠端撤回。SHA-256 只確認位元組一致；HTTPS 與伺服器信任仍是前提，尚無獨立離線作者簽章。文件內容與本機技能可能含提示注入，請人工審閱，安裝工具不執行內容。

--telemetry 明確 opt-in 才回傳驗證下載／本機寫檔宣告，不上傳工作目錄、裝置 ID、技能內容或會員 UUID；不等同授權行銷。預設不回傳宣告，但 HTTP 請求仍經服務端限流。拒絕符號連結、Windows 保留名稱與額外檔案；不能防範擁有同等 OS 權限的程序在檢查間惡意改動目錄，請勿在共用、不可信目錄安裝。

Codex 相容性與限制

官方文件描述 repository 的 .agents/skills 路徑及必要 name／description frontmatter；本工具只做文字檔放置，不操作 Codex UI、設定或原生背景代理。安裝後請在對應 workspace 手動開啟 Codex，確認技能選單能看見並自行決定是否使用。

OpenAI 官方技能文件

Windows Node 檔案工具測試與 Codex 實際啟用是不同證據。Linux／macOS 本輪僅路徑測試向量，尚待原生 OS 實測。未驗證所有 Codex 桌面版本、ChatGPT 雲端、其他 Agent host 或 native store；不宣称跨工具自動啟用。若名稱衝突，請先停用或移走自己的舊技能，不要強制覆蓋。

回報相容性問題（請附 OS／工具版本，不含 token）

啟用診斷與分級證據

檔案放置不代表 Codex 已發現或呼叫技能。使用唯讀 doctor、私人離線報告與拋棄式任務範本，逐級查看 PASS／FAIL／BLOCKED；不會自動執行模型、shell 或上傳工作目錄。

開啟技能啟用診斷