Starfie1d1272/dsh-github-skills 预览 preview

Starfie1d1272/dsh-github-skills

面向DeepSeek Harness的技能优先GitHub工作流:PR分类、评审反馈、CI诊断及安全发布。

Project Overview项目介绍

This is a native DSH plugin that brings the official GitHub workflow semantics from OpenAI Codex to DeepSeek Harness. It does not reimplement GitHub API functionality from scratch; instead, it layers on top of existing DSH GitHub capability plugins to handle workflow routing, evidence requirements, security guardrails, and fallback logic when capabilities are missing. It aligns core workflow logic with the official Codex GitHub plugin, adapting it to DSH’s unique architecture including multi-provider capability selection, on-demand skill loading, and built-in approval mechanisms. To install the plugin, you can run dsh plugin --profile web add dsh-github-skills if you have DSH installed globally, or use npx for a local installation.

The plugin ships with four core on-demand skills that only load into the agent context when needed. The github skill handles entry routing by parsing repository, pull request, issue, and branch context to route tasks to the correct downstream skill. gh-address-comments processes pull request review feedback, preserving thread context and making traceable local changes. gh-fix-ci diagnoses failed GitHub Actions runs exclusively based on actual check and log evidence, avoiding guesswork when CI fails. gh-publish safely validates local changes, pushes them to the remote, and creates a draft pull request when requested. This tool is designed for DSH developers working on real-world software projects that involve regular interaction with GitHub.

The plugin is released under the open-source Apache 2.0 license, and it does not manage OAuth credentials or implement its own GitHub API client. It enforces strict security boundaries: remote write actions like pushing code or resolving comments require explicit approval, sensitive data like credentials is redacted before being passed to the LLM, and it never uses unsafe commands like git add -A or force push by default. The current tested compatibility baseline is @deepseek-ai/dsh@0.1.0-rc.6, and the project runs continuous integration testing on Node.js 22.19 and 24. You can also install from a specific GitHub commit or a local tarball if you need an auditable snapshot of the code.

dsh-github-skills 是专为 DeepSeek Harness(DSH)开发的原生技能插件,用于将 OpenAI Codex 官方的 GitHub 工作流语义引入 DSH 生态。它不会重复实现 GitHub API 能力,而是在现有 DSH GitHub 能力插件之上,提供工作流语义路由、证据校验要求、安全组合规则和异常回退逻辑,适配 DSH 的多 provider 机制、审批流程和技能按需加载特性。

本插件内置四个核心技能,分别负责 GitHub 上下文路由、处理 PR 评审反馈、基于真实日志诊断修复失败的 GitHub Actions,以及安全推送改动并创建草稿 PR。技能采用按需加载机制,避免不必要的工作流长期占用 Agent 上下文。它面向需要处理 PR 评审、CI 故障排查、代码提交等实际 GitHub 软件开发任务的 DSH 用户,可与现有多种 DSH GitHub 能力插件配合使用。

本项目采用 Apache-2.0 开源许可证,安装要求为 Node.js 22.19+ 或 24+ 版本、pnpm 在系统 PATH 中,以及已安装的 DeepSeek Harness。若 DSH 未全局安装,可通过 npx 安装插件并启动 DSH,支持从 npm 包、指定 GitHub 提交或本地压缩包安装。当前测试兼容基线为 @deepseek-ai/dsh@0.1.0-rc.6,本身不管理 OAuth 凭据也不重复实现 GitHub API 客户端。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-github-skills

把 Starfie1d1272/dsh-github-skills 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-github-skills

简体中文 | English

把 OpenAI Codex 官方 GitHub 工作流带到 DeepSeek Harness。

dsh-github-skills 以 OpenAI 官方 Codex GitHub plugin 的工作流语义为上游基线,针对 DSH 的多 provider、审批机制、Skill 按需加载和 gh / git 回退环境进行适配与加固。

它不是另一个 GitHub API 插件。GitHub provider 负责让 DSH“有能力”,本项目负责让 Agent“正确、安全地组织这些能力”。

DeepSeek Harness(DSH)的非官方社区项目。与 deepseek-ai、OpenAI、GitHub 无隶属关系,也未获其背书。

npm version CI License: Apache-2.0

dsh-github-skills 架构概览:从 Codex 工作流语义基线到 DSH 多 provider 生态

为什么做这个

DSH 已经出现了不少 GitHub / Git 能力插件:有人负责认证,有人提供 PR / Issue / Review / CI 工具,有人负责本地 Git,有人提供 GitHub MCP 或专项 CI 诊断。

这些项目解决的是:

Agent 能调用什么?

dsh-github-skills 解决的是另一层问题:

面对一个真实的软件工程任务,Agent 应该在什么时候使用什么能力、按什么顺序使用、需要什么证据、什么时候不能继续,以及能力不足时如何安全回退?

因此,本项目刻意不重新实现 GitHub API,而是作为 DSH GitHub 生态之上的工作流语义 / 路由 / 证据要求 / 安全组合层。

完整设计与生态定位见:《dsh-github-skills 的定位:从 Codex GitHub Skill 到 DSH 工作流层》。

从 Codex 到 DSH

本项目不是从零发明四套 GitHub 工作流。核心结构来自 OpenAI 官方 Codex GitHub plugin:

Codex GitHub plugin dsh-github-skills 作用
github github GitHub 总入口、上下文解析与路由
gh-address-comments gh-address-comments 处理 PR Review 反馈
gh-fix-ci gh-fix-ci 基于真实 CI 证据诊断 / 修复 GitHub Actions
yeet gh-publish 安全提交、推送并创建 PR

目标不是逐字复制,而是保持工作流语义一致,并针对 DSH 做必要适配。

项目维护了一份固定上游版本的逐项一致性记录:references/codex-conformance.md。其中明确区分:

  • 与 Codex 等价的行为;
  • 通过 DSH 不同能力实现的等价行为;
  • DSH 特有增强;
  • 有意保留的差异;
  • 审计中发现并修复的 gap。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-llm-as-a-verifier 下一个 Next dsh-workspace-search →