前言¶

在 DSH 裏做 TeleAgent 技能時，常見問題不是「會不會寫腳本」，而是目錄、frontmatter 和平臺審覈規則是否對齊。平臺對包內擴展名有白名單，.pyc 一旦混入整包會被拒收；校驗邏輯若只靠手工對照文檔，也容易漏項。自己從零搭腳手架、校驗器和打包流程，每換一次環境都要重做一遍。

下面介紹的插件 caigou114/dsh-teleagent-skill-builder 把 TeleAgent 技能製作規範做成一條 DSH 插件：裝一次後，每個會話都會帶上 teleagent-skill-builder 技能，內含規範全文、校驗器、腳手架、打包器與安裝器。維護者爲 GitHub 用戶 caigou114，倉庫採用 MIT 許可證，當前 npm 包版本爲 0.1.0。

這是什麼¶

該插件是 DeepSeek Harness 的 Cordis 插件：DSH 啓動時把插件內的 assets/skills/teleagent-skill-builder/ 複製到本機 ~/.dsh/skills/teleagent-skill-builder/。複製過程會過濾 .pyc、.pyo、__pycache__，裝完後再刪一次殘留字節碼。

插件自述爲零依賴、不髮網絡請求，寫入目錄僅限上述技能路徑。產出的技能包面向「第一次導入就能過平臺審覈」，其中 .pyc 禁令是重點攔截項。

核心功能¶

技能目錄內提供四件腳本工具，另附規範全文副本：

references/teleagent-spec.md 爲規範全文副本，可按章節查閱。

插件側對字節碼有三重攔截：複製時過濾並在複製後再清理；validate_skill.py 將 .pyc / __pycache__ 記爲 FAIL；倉庫內 npm run check（prepack）與 CI（push 時）也會掃描全倉庫，發現字節碼即失敗。

安裝與啓用¶

任選 README 中一種方式安裝，命令須與原文一致：

# A. 從 GitHub 裝（不需要 npm 賬號）
dsh plugin add github:caigou114/dsh-teleagent-skill-builder

# B. 從 GitHub Release 的預構建包裝（免源碼安裝）
dsh plugin add "https://github.com/caigou114/dsh-teleagent-skill-builder/releases/download/v0.1.0/dsh-teleagent-skill-builder-0.1.0.tgz"

# C. 從本地目錄或 tgz 裝
dsh plugin add "file:D:/path/to/dsh-teleagent-skill-builder"
dsh plugin add "D:/path/to/dsh-teleagent-skill-builder-0.1.0.tgz"

# D. npm 發佈之後
dsh plugin add dsh-teleagent-skill-builder

也可在插件市場搜索 teleagent：條目在「技能 / skill」分類下，卡片名爲 caigou114/dsh-teleagent-skill-builder。社區目錄站點爲獨立生態，與 DeepSeek / 幻方無官方從屬關係。

安裝完成後重啓 DSH。在插件頁「已安裝」中應能看到該插件；~/.dsh/skills/teleagent-skill-builder/ 下即爲隨插件分發的標準內容。

可選配置¶

若需改落盤目錄或僅掛載插件而不復制文件，可在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中調整：

- id: teleagent-skill-builder
  config:
    skillsDir: "D:/my-skills"   # 換落盤目錄，默認 ~/.dsh/skills
    install: false              # 只掛插件、不復制文件

典型用法¶

經過上面的安裝與重啓，技能會出現在本機 DSH 技能目錄。日常製作流程可按工具分工理解：

1. 用 scaffold_skill.py 生成符合平臺約束的目錄與 frontmatter。
2. 開發完成後運行 validate_skill.py，在打包前消除校驗錯誤（含字節碼）。
3. 用 pack_skill.py 打出 .skill 包。
4. 需要本機 TeleAgent 目錄安裝時，在通過後調用 install_skill.py。

規範細節以 references/teleagent-spec.md 爲準；與平臺文檔衝突時以平臺當前規則爲準。

適用場景與注意¶

適合在 DSH 中反覆編寫、校驗並打包 TeleAgent 技能、且希望規範與工具鏈隨會話自動可用的開發者。

插件以當前 dsh 進程權限運行，安裝前應自行查看倉庫源碼與 MIT 許可證。peer 依賴爲 @deepseek-ai/cordis（^4.0.1，可選）。維護者若在倉庫內升級標準內容，需將 lib/index.js 頂部的 STANDARD_VERSION 遞增，否則已安裝用戶可能不會重新複製技能目錄。

結尾¶

dsh-teleagent-skill-builder 把 TeleAgent 技能製作規範收斂爲一條 DSH 安裝命令與一套隨會話加載的工具，減少手工對照文檔和踩 .pyc 審覈的重複成本。

• 插件目錄頁：https://www.skillhub.cn/plugins/caigou114/dsh-teleagent-skill-builder
• GitHub：https://github.com/caigou114/dsh-teleagent-skill-builder