技能工坊 PopCapEA/dsh-skill-studio

DeepSeek Harness 的 Skill Studio

一套兼容 Codex 的技能系统，专为 DSH 打造，左侧边栏有独立页面。它读写纯 SKILL.md 文件夹，因此同一批技能可以在 Codex、DSH 和共享的 .agents 目录里通用。

Skill Studio 图标

功能

- 侧边栏一个 Skill 页面 —— 浏览 Codex、DSH 和共享的全部技能，搜索、阅读指令，并查看哪一份副本生效。
- 创建、编辑、复制、删除、恢复 —— 按 Codex 的 SKILL.md 格式写入，带 YAML frontmatter。删除的技能进入同一作用域内可恢复的 .trash 文件夹。
- 按入口分别启用或停用 —— disable-model-invocation 控制模型目录和 skill 工具；user-invocable 控制用户直接调用。
- Codex 作用域 —— ~/.codex/skills 和 <project>/.codex/skills 桥接进 DSH 的技能注册表，现有 Codex 技能无需复制就能出现在智能体目录里。
- 在对话中调用 —— 在聊天里输入 $skill-name，即可把完整的 <skill_content> 块注入当轮对话，效果与 Codex 完全一致。原有的 /skill-name 写法也继续可用。
- 渐进式披露 —— 模型只拿到名称和描述；完整指令按需通过 skill 工具或 $name 加载。
- Codex 展示元数据 —— 存在时展示 agents/openai.yaml 的 interface 和 policy.allow_implicit_invocation，以及旧版 config.toml [interface] 里的 displayName、shortDescription、brandColor、defaultPrompt 等字段。

作用域

| 作用域 | 位置 | 可写 | 说明 |
| Codex 用户 | ~/.codex/skills | 是 | 由本插件桥接进 DSH |
| Codex 项目 | <project>/.codex/skills | 是 | 最近的 .git 上级目录，或工作区目录 |
| DSH 用户 | ~/.dsh/skills | 是 | DSH 原生文件系统服务商 |
| DSH 项目 | <project>/.dsh/skills | 是 | DSH 原生文件系统服务商 |
| 共享 Agent | ~/.agents/skills、<project>/.agents/skills | 是 | 存在时可见、可编辑 |
| Codex 内置 | ~/.codex/skills/.system | 否 | 只读；可复制到可写作用域 |
| 内置/运行时 | DSH 包 | 否 | 只读；尽量复制出来再改 |

DSH_CODEX_HOME（或 CODEX_HOME）改变 Codex 主目录；DSH_HOME 和 DSH_AGENTS_HOME 改变 DSH 与共享根目录。Codex 主目录在 <home>/skills 下扫描。

项目副本优先于用户副本；同名时 DSH 副本优先于 Codex 副本。页面会把落选的那份标为 Shadowed 并同时展示，过期的重复副本不会藏起来看不见。

技能格式

name: release-checklist
description: Use when preparing and verifying a production release.
whenToUse: Before tagging a release.

Release checklist

Workflow

1. Run the project's own checks.
2. Inspect the final diff.
3. Report the result and remaining risks.
技能是一个目录包 <name>/SKILL.md（推荐），也可以是一个扁平的 <name>.md 文件，直接放在某个作用域根目录下。frontmatter 里只有两个必填字段：name（kebab-case）和 description。可选的配套文件可以放在 SKILL.md 旁边（references/、scripts/、assets/、agents/openai.yaml、config.toml、icon.svg）。

disable-model-invocation: true 会把技能从模型目录和 skill 工具里隐藏。user-invocable: false 会把它从 $name / /name 手势里移除。两者默认都允许。

在聊天中使用技能

$release-checklist verify the 2.4 release and list anything blocking it

技能的指令会以 <skill_content> 块的形式进入当前步骤，目录会告诉模型照着执行，而不是再次加载。输入 /release-checklist 走的是 DSH 现有的用户技能手势，效果相同。

模型也可以用现有的 skill 工具加载任何模型可调用的技能，返回同样规范的 <skill_content> 结构。

安装

直接从公开的 GitHub 仓库安装：

dsh plugin --profile <profile> add github:PopCapEA/dsh-skill-studio

或者安装发布版 tarball：

dsh plugin --profile <profile> add "https://github.com/PopCapEA/dsh-skill-studio/releases/download/v1.0.0/dsh-skill-studio-codex-1.0.0.tgz"

或者等 npm 发布后，用包名安装：

dsh plugin --profile <profile> add dsh-skill-studio-codex

安装后刷新页面，左侧面板列表里会出现 Skills 图标。

设计说明

- 宿主端是纯 Node ESM，只导入 node: 模块。它在 ctx.skills 上注册 codex-studio 服务商，通过 ctx.connection.fetch 掌管需要认证的 /api/skill-studio-codex.* 路由，并为 $name 安装一个 agent/pre-step 监听器。
- 客户端是纯 JavaScript 模块，由 window.__ModuleLoader__ 加载；只使用 React、主题 token 和公开的 slot/locale 服务。
- 文件写入是原子的（临时文件加改名），名称会做校验，每个写操作路由都由现有浏览器会话认证。
- 删除技能时，把它的包重命名到 <scope>/.trash/，并附一份 sidecar 记录，所以 Trash → Restore 不需要数据库就能工作。
- Codex 服务商在防抖的文件系统监听上让目录失效，因此在 Codex、VS Code 或 shell 里做的修改会进入下一个模型步骤。
- 这个发布版使用自己的 Loader 行、侧边栏面板 id、API 前缀、locale 命名空间和服务商名称。它可以和本地的 @local/dsh-skill-studio 构建共存，而不是替换它。

限制

- 编辑总是更新 SKILL.md 的 frontmatter；重写某个键时，该键上的注释不会保留。未知的 frontmatter 键和 metadata: 块会保留。
- 重命名技能有意不原地进行：SKILL.md 里的名称才是它的身份标识。复制一份，再删掉旧的那份。
- 通过符号链接引入的技能包可见，但只读。
- 该页面管理项目作用域的默认工作区。会话工作区若 cwd 不同，模型仍能发现，但管理页面用的是进程工作区。