前言¶

在 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