LeslieWylie/dsh-ops-kit

English | 中文

五个只读 skill，让 agent 在开口之前先亮出证据——无论它说的是"我记得这个"、"计划做完了"、"benchmark 过了"，还是"可以发布了"。

为什么做这个

Agent 说错话的时候往往一样自信。这个 bundle 只坚持一条规则：agent 声称"我记得这个"、"计划已就绪"、"benchmark 通过了"、"可以安全发布"之前，应该能指出可核查的证据，而不只是一句断言。五个聚焦的 skill 包共享这一套纪律——限定范围的 memory 检索、证据驱动的编排规划、多 agent 协作的调度规则、benchmark 结果把关、插件发布卫生——而不是把同一个想法拆成五个各自独立安装、各自占一个插件索引位置的包。

默认情况下一切都很保守：不会静默创建 Issue、不调用远程 API、不启动 benchmark、不修改仓库、不读取凭据。这个 bundle 给 agent 的是计划、检查项和证据词汇；任何有副作用的动作，都留在 bundle 之外，作为显式的、可复核的操作。

安装

包还没有发布到 npm registry，直接从 GitHub 安装。加到 DSH profile 的 package.json：

// ~/.dsh/profiles/<profile>/package.json
{
  "dependencies": {
    "@dsh-community/dsh-ops-kit": "github:LeslieWylie/dsh-ops-kit"
  },
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "@dsh-community/dsh-ops-kit"]
    }
  }
}

然后为该 profile 重新安装依赖并重启。如果你的 dsh CLI 版本支持直接按 spec 添加插件，等价的一行命令是：

dsh plugin --profile <profile> add github:LeslieWylie/dsh-ops-kit

提供的能力

能力包	工具	能做什么	副作用
能力目录	dsh_ops_capability_catalog	列出包含的能力包	无
证据驱动编排	dsh_ops_workflow_plan	为研究、多 agent 协作、benchmark 或发布场景生成"目标 → 基线 → 执行 → 覆盖审查 → 交付"计划	无
Skill 参考	dsh_ops_skill_read	读取随包提供的完整 skill 定义	无
Git-first memory	dsh_ops_memory_search	在限定的本地 Markdown/代码根目录中检索，带来源出处	只读
仓库审计	dsh_ops_repository_audit	审计 Git 状态、未跟踪文件和凭据路径卫生	只读
发布卫生	dsh_ops_release_checklist	生成完整的 DSH 插件发布清单	无

多 agent 协作的调度规则（leader 唯一派工、共享工作树协调、runtime 归属、清理证据）和 benchmark 证据把关（manifest、precheck、产物清单、结果完整性检查）内置在 workflow-plan 和 release-checklist 这两个 skill 里，而不是单独的工具。

配置本地根目录

使用 dsh_ops_memory_search 或 dsh_ops_repository_audit 时，把 roots 配置为该 profile 允许检查的目录。根目录要窄，绝不要指向凭据目录。

# 示例 overlay；请按实际 profile 配置格式调整
- id: dsh-ops-kit
  config:
    roots:
      - /workspace/project
      - /workspace/memory
    maxFiles: 120
    maxBytesPerFile: 160000

如果没有配置 roots，工具默认使用 DSH 进程的当前工作目录。类凭据路径和常见的运行/密钥目录会被拒绝或跳过。

设计来源

这是一个独立的新集成层，从通用工程实践中提炼而来，并非任何内部源仓库的拷贝。这里不会打包凭据、运行产物、原始私有数据或机器特定配置。

验证

pnpm install --offline --ignore-scripts
pnpm build
pnpm typecheck
pnpm test

接入运行中的 profile 后，还需验证：DSH 端点返回 HTTP 200、重启后 profile 仍处于 running、打包的 skill 能被列出，以及 dsh_ops_capability_catalog 返回全部能力包。

许可

贡献前请先阅读 CONTRIBUTING.md 和 SECURITY.md。

MIT License。