Harness Alchemist：通用編碼智能體插件腳手架

前言¶

開發智能體插件時，往往需要適配 Claude Code、Codex、OpenCode、Google Antigravity 以及 DeepSeek Harness/Cordis 等不同平臺的格式。手動維護多套配置和結構非常繁瑣。DeepSeek Harness（DSH）的理念是“一切皆插件”，開發者需要一個工具來統一生成符合各平臺規範的代碼倉庫。

是什麼¶

harness-alchemist 是一個 TypeScript 插件倉庫腳手架，由 lunarmoon26 維護。它將“一套代碼、五種 Harness”的概念落地：生成的倉庫可以原生安裝到上述五個平臺。其核心在於讓技能（Skill）擁有自己的運行時，通過 skill-runtime.json 聲明契約，而非由宿主適配器編寫邏輯。該項目遵循 MIT 許可證。

核心功能¶

自動腳手架：生成一個 TypeScript 插件倉庫，包含各平臺所需的入口文件和配置。
結構驗證：在生成後自動運行 TypeScript 檢查、運行時委託測試、腳手架驗證以及 npm 包體審計。
清單生成：自動生成 skill-runtime.json、alchemy.json 等 manifest 文件。

安裝與啓用¶

CLI 工具是一個原生 Rust 二進制文件，無需用戶安裝 Rust 環境即可運行。npm 和 Bun 安裝方式使用輕量級啓動器，但啓動器本身需要 Node.js 22.20+ 或 Bun 1.2+。

安裝命令如下：

npm install -g harness-alchemist

安裝完成後，可以使用 npx 直接運行而無需全局安裝：

npx harness-alchemist@latest create my-plugin --help

典型用法¶

創建插件項目：
指定項目描述、作者和倉庫地址。

    npx harness-alchemist@latest create my-plugin \
      --description "What the plugin does" \
      --author "Example Team" \
      --repository example/my-plugin

安裝依賴並驗證：
進入項目目錄，安裝依賴並運行內置的驗證流程。

    cd my-plugin && npm install && npm run verify

代碼驗證：
運行 npm run validate 強制執行 Agent Skills frontmatter 合規性檢查、SKILL.md 引用解析以及運行時清單驗證。

配置與結構¶

生成的項目包含以下關鍵結構：

skills/<name>/：存放 Agent Skills 工作流、可移植的 skill-runtime.json、固定執行入口以及工具契約引用。
src/opencode.ts：OpenCode 插件入口，將可移植運行時清單投射爲原生工具。
src/deepseek.ts + cordis.patch.yml：Cordis 函數插件入口，註冊相同的可移植工具。
Manifests：skill-runtime.json 定義模型面 Schema 並選擇執行入口；alchemy.json 記錄 runtime 模式、模板版本和生成時間。

項目支持兩種 runtime 模式：
* npm（默認）：包含完整的生成契約、npm 元數據、可移植運行時清單、適配器和 Cordis 補丁。
* skills：僅包含技能、運行時清單和 Harness 清單。適用於不需要 npm 包和 JavaScript 運行時的 Python、Go 等語言倉庫。

支持的平臺¶

該腳手架生成的插件可安裝至以下 Harness：

DeepSeek Harness：通過 profile 文件系統根目錄和 Cordis 工具插件安裝。
Claude Code：通過市場清單原生安裝。
Codex/ChatGPT：通過市場清單原生安裝。
OpenCode：通過 ~/.agents/skills/ 安裝，並在 opencode.json 中配置。
Google Antigravity：通過嵌套包安裝。

注意事項¶

插件以當前 DSH 進程的權限運行。在安裝或使用插件前，請務必檢查源碼，確認其安全性及許可證要求。

總結¶

harness-alchemist 通過一套 TypeScript 倉庫規範，降低了多平臺智能體插件開發的門檻。開發者可以專注於技能邏輯本身，而將適配和驗證工作交給腳手架處理。