gongyijie85/dsh-repo-setup

DeepSeek Harness 的仓库引导指南:只读 repo_setup_scan 工具——claude-code-setup 的对应版本

项目介绍Project Overview

仓库体检引导插件(DSH 版),注册只读工具 repo_setup_scan,扫描项目目录的语言栈、测试、文档、git、Docker 与数据库线索,输出 Markdown 报告,推荐 DSH 技能插件与 MCP 服务器(不修改任何文件)。在 Claude 模型首次进入新/陌生仓库时自动调用,也可手动触发。注意:仅做只读探测,需重启 profile(dsh web)后生效。

DSH repository onboarding plugin registering a read-only repo_setup_scan tool that inspects a project directory for language stack, tests, docs, git, Docker, and database signals, then outputs a Markdown report recommending DSH skill plugins and MCP servers without modifying anything. Auto-invoked when the model enters a new or unfamiliar repo, or triggered manually. Note: read-only only; requires restarting the profile (dsh web) to take effect.

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

命令行安装CLI Install

dsh plugin --profile web add dsh-repo-setup

gongyijie85/dsh-repo-setup 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-repo-setup

npm version GitHub release CI License: MIT

English | 简体中文

仓库体检引导插件 —— Anthropic claude-code-setup 的 DeepSeek Harness 版。

注册一个只读工具 repo_setup_scan:扫描项目目录的语言栈、测试设置、 文档、git、Docker 与数据库线索,然后给出设置建议:该装哪些 DSH 技能插件、 该挂哪些 MCP 服务器、该补哪些卫生文件。绝不修改任何东西。

安装

# npm
dsh plugin --profile web add dsh-repo-setup

# GitHub
dsh plugin --profile web add github:gongyijie85/dsh-repo-setup

# 本地开发
dsh plugin --profile web add D:\plugins\dsh-repo-setup

装完重启 profile(dsh web),模型会在进入新/陌生仓库时自动调用 repo_setup_scan(也可在对话里直接要求"扫描这个仓库怎么配置")。

工具:repo_setup_scan

参数 说明
path 要扫描的项目目录;缺省为当前工作目录

输出 Markdown 报告:

  • Detected stack — package.json / pyproject.toml / Cargo.toml / go.mod / Dockerfile 等标记识别的技术栈(含前端框架与测试运行器探测)
  • Repo hygiene — AGENTS.md 缺失、git 未初始化、无测试、数据库线索
  • Recommended installs — 一键命令:
    • mattpocock-skills-dsh(grilling/to-spec/to-tickets/tdd/code-review 工作流)
    • mattpocock-skills-dsh-zh(中文技能版,与英文版二选一)
    • superpowers-dsh(规划→TDD→评审方法论)
    • dsh-ponytail-skills(防过度工程)
    • dsh-ecc-skills(ECC 273 技能:模式/编排/垂直领域)
    • dsh-claude-mem(可选:跨会话记忆)
    • dsh-mcp-manager(挂载下方 MCP 用)
    • MCP:context7(库文档)、playwright(前端)、postgres、github(按检测结果)

工作原理

  • Bundle 层 —— cordis.patch.yml 在 dsh-base 层插入插件行。
  • 工具 —— lib/index.js@deepseek-ai/dsh-toolsdefineTool 注册 repo_setup_scan,只读探测(读有限个已知文件 + 顶层目录列表),不做任何写入。
  • 零运行时依赖 —— 除 harness 注入的 @deepseek-ai/dsh-tools peer 依赖外 只用 Node 内置模块。

开发验证

node --check lib/index.js
# 功能冒烟(伪 ctx 注册 + 直接调 scanRepo 逻辑见 scripts/verify-tool.mjs)
node scripts/verify-tool.mjs

许可证

MIT。见 LICENSE

上一个 Prev dsh-client-ui-quote 下一个 Next dsh-conversation-cost