dsh-agent-builder — DSH 智能体开发预设

一个专用于在 DeepSeek Harness 上设计、创建、校验 DSH 智能体（agent preset） 的预设：自带 preset 创作工具集、插件/技能脚手架、静态审查与差异对比、默认预设控制，以及运行时内省工具；具备标准模式（standard）的全部能力（shell、文件、作业、目标、计划、压缩、子代理、工作流、技能）。

安装

把本仓库克隆为用户预设目录（目录名必须是 agent-builder——组合内的本地插件行按相对路径解析）：

git clone https://github.com/<owner>/dsh-agent-builder.git "$env:DSH_HOME\.agent-presets\agent-builder"

或下载解压到 ${DSH_HOME:-$HOME/.dsh}/.agent-presets/agent-builder/，然后新建会话并选择预设「DSH 智能体开发」。

组成

agent.cordis.yml                    组合文件（persona + 全部能力行）
preset.yml                          显示元数据
plugins/agent-builder-tools/
  index.js                          preset 创作工具集 + 运行时内省（CJS、零 harness 依赖）
plugins/plugin-scaffold/
  index.js                          预设本地插件骨架生成（plugin_scaffold）
plugins/plugin-lint/
  index.js                          预设本地插件静态检查（plugin_lint）
plugins/preset-lint/
  index.js                          整预设静态审查 + 组合差异对比（preset_lint / preset_diff）
plugins/preset-default/
  index.js                          默认预设控制（preset_set_default / preset_clear_default）
plugins/skill-scaffold/
  index.js                          技能骨架生成（skill_scaffold）
skills/
  dsh-agent-development/            本预设新增：智能体开发工作流
  editing-cordis-compositions/      组合文件编辑规范（来自 deepseek-harness）
  cordis-plugin-development/        动态插件开发规范（来自 deepseek-harness）

工具集（plugins/agent-builder-tools）

工具	说明
preset_list	所有预设的 roster（id / 信任级 / 元数据 / 真实路径 / 损坏状态）+ 当前默认预设
preset_read	读取一个预设的组合文件原文
preset_copy	整体复制预设（可选 name / description 直接写入副本 preset.yml）
preset_validate	单预设真实挂载校验（standingKeyFor）
preset_validate_all	批量挂载校验，一次汇总所有失败（默认全部用户预设）
preset_remove	删除用户预设（发布版会被拒绝）
preset_default	当前默认预设 id 与用户预设根是否可写
preset_files	预设目录文件树
runtime_services	live Host 服务目录：服务名 + 提供行 + realm 归属（root / isolated）
runtime_tools	本预设作用域可见的模型工具目录（名称、描述、参数 schema）

其他本地插件工具

插件	工具	说明
plugin-scaffold	plugin_scaffold	在用户预设的 plugins// 生成合规 CJS 骨架（手写 raw JSON Schema、ctx.tools.register），返回组合接线行
plugin-lint	plugin_lint	静态检查预设本地插件：CJS 形状、ESM 语法、外部 require、工具注册、组合行接线
preset-lint	preset_lint / preset_diff	整预设静态审查（roster、元数据、persona、tool-cordis 单例警告、重复行、插件/技能接线）；两预设组合文件的 LCS 差异
preset-default	preset_set_default / preset_clear_default	设置默认预设（先 resolveMountable 校验）或恢复部署默认
skill-scaffold	skill_scaffold	生成带合规 YAML frontmatter（name + description）的技能骨架

设计说明

• 为什么没有 tool-cordis：@deepseek-ai/dsh-tool-cordis 的检查 Provider 注册在进程级 cordisInspect 注册表，同一进程只能有一个含它的预设站立挂载；为了能与 cordis / plugin-dev 预设共存，本预设不组合它，动态插件原型请用 plugin-dev 会话。
• 本地插件零依赖：用户预设目录下没有通往 harness 包的 node_modules 链，因此插件只用手写 raw JSON Schema 调用 ctx.tools.register，运行时内省通过 Symbol.for('cordis.isolate') 与作用域 tag 发现实现，且都有防御性降级。

许可

MIT。skills/cordis-plugin-development 与 skills/editing-cordis-compositions 复制自 deepseek-ai/deepseek-harness（MIT，© deepseek-ai 及贡献者）。