前言¶
在 DeepSeek Harness（DSH）里跑通一套可复用流程后，常见做法是手写 SKILL.md、改 frontmatter、再放到用户或项目作用域。步骤不难，但容易漏检、改坏调用限制，或忘记在任务结束前问一句「要不要沉淀」。社区插件 dsh-skill-author（维护者 Apq，分类：工作流）面向这一类场景：给模型注册 skill_manage 工具，让 agent 在会话内创建、整体替换或删除技能；从 1.3.0 起还会在系统提示词里注入常驻的「技能沉淀」自检段落，减少对手工维护 AGENTS.md 的依赖。
这是什么¶
dsh-skill-author 是 DeepSeek Harness 插件，当前 npm 包版本为 1.3.0，许可证 MIT。它不引入额外依赖，也没有可配置项。插件核心是向模型暴露 skill_manage，并把技能写入 Harness 约定的 SKILL.md 结构；frontmatter 由工具管理，但只动 name、description、metadata 三个键，其余键在 patch 时逐字保留，避免一次替换悄悄放宽调用限制。
目录页：skillhub.cn/plugins/Apq/dsh-skill-author
源码：github.com/Apq/dsh-skill-author
核心功能¶
skill_manage 操作¶
- create：在所选作用域下新建技能；若同名已存在则失败。
- patch：用新正文整体替换某技能的
SKILL.md；不存在则失败；description可省略以沿用旧值。 - delete：删除技能，并归档到技能根旁的
.deleted-skills/<name>-<timestamp>-<random>。
正文只传 Markdown；单技能上限 100 000 字符。
作用域¶
- user：
$DSH_HOME/skills（默认~/.dsh/skills），本机所有工作区可用。 - project：会话工作区 git 根下的
.dsh/skills，仅该仓库可用。项目根通过是否存在.git（目录或 worktree 文件）判断。
系统提示词（1.3.0+）¶
插件注册常驻 section skill-author:retention（order 5500），提示模型在结束可复用流程前评估是否沉淀，并汇报保存结果。若提示服务不可用会自动降级，只保留工具能力。
写入与安全¶
同一技能从检查到发布按主机进程串行；临时文件随机命名并以独占方式创建；create 通过硬链接原子发布（并发 create 时恰有一个成功）。技能目录经 realpath 校验，符号链接无法把写入带出技能根。
环境要求¶
- DeepSeek Harness ≥
0.1.7-rc.2且 <0.3.0 - peer 依赖：
@deepseek-ai/dsh-tools
安装与启用¶
在 DSH 桌面应用的 设置 → 插件 → 添加插件 中任选一种方式（以仓库 README 为准，勿自行拼接 CLI 安装串）：
- Git 仓库地址：粘贴本仓库 git URL（GitHub 或其它 git 服务均可）。
- 本地目录路径：将插件目录拷到本机后，粘贴其绝对路径。
- npm 包名：若已从 npm 或私有源发布，填写
dsh-skill-author。
安装后，新会话会自动获得 skill_manage，无需手工改 profile。
从源码本地试用的方式见仓库 README「从源码开发」一节（例如在 profile 的 package.json 里用 file: 依赖并加入 dsh.profile.bundles）。
典型用法¶
仓库内 使用说明.md 按「安装 → 三步验证 → 常见问题」组织，适合安装后快速走完验证。
- 安装插件并开启新会话，确认工具列表中出现
skill_manage。 - 让 agent 在跑通流程后调用
create或patch，选择user或project作用域，写入SKILL.md正文。 - 结束可复用任务前，留意模型是否按
skill-author:retention段落做沉淀评估（1.3.0+ 默认已有；若需更细规则，可将仓库 Agents.md 内容追加到~/.dsh/AGENTS.md或工作区AGENTS.md）。
适用场景与注意¶
适合谁：经常在 DSH 里反复执行同类工作流、希望把「跑通一次」变成可复用技能的开发者；需要在项目仓库内限定技能范围（project）或本机全局共享（user）的团队。
使用时注意：
- 插件以当前 DSH 进程权限读写技能目录；安装前应阅读源码与 MIT 许可证，确认符合你的安全策略。
patch会替换正文，但非name/description/metadata的 frontmatter 键不会被工具改写；仍应对生成内容做人工抽查。- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件信息以 GitHub 仓库与包内文档为准。
结尾¶
dsh-skill-author 把「保存 / 替换 / 删除 Harness 技能」收拢到模型可调用的 skill_manage，并在 1.3.0 起用系统提示词督促任务结束前的技能沉淀。若你已在用 DSH 0.1.7-rc.2 以上且低于 0.3.0，可从桌面插件页按上述三种方式安装，再跟仓库 使用说明.md 做三步验证。
- 目录页：https://www.skillhub.cn/plugins/Apq/dsh-skill-author
- GitHub：https://github.com/Apq/dsh-skill-author
